====== value() ======

''mixed **value**(string //Variable//, [string //Ausgabeformat//])''

Mit dieser Funktionen können Antworten (Antwort-Codes, ausgewählte Optionen oder Texteingaben) des Teilnehmers ermittelt werden.

**Wichtig:** Es können nur solche Antworten abgefragt werden, welche der Teilnehmer auf einer __früheren__ Fragebogen-Seite angegeben und bereits mit "Weiter" an den Server übermittelt hat.

  * //Variable//\\ Kennung der Variable, die ausgelesen werden soll. Die korrekte Kennung finden Sie in der **Variablen-Übersicht**.
    * Die Variablen-Kennung setzt sich meist (nicht immer) aus Rubriken-, Fragen- und ggf. Item-Kennung zusammen und muss als String (also in Anführungszeichen) angegeben werden (z.B. '''XY01_02''').
    * Neben den Variablen von Fragen sind auch folgende Variablen verfügbar: CASE, MISSING, SERIAL, REF, QUESTNNR, MODE, LANGUAGE und STARTED
  * //Ausgabeformat//\\ Mit dem Ausgabeformat wird festgelegt, ob die Funktion den Antwort-Code (Standard) oder den Beschriftungstext der Antwort zurückgibt. Folgende Angaben sind möglich:
    * '''code'''\\ Standard-Format für ''value()'': Antwortcode entsprechend der **Variablen-Übersicht** (wird auch zurückgegeben, wenn kein Antwortformat angegeben ist), bei Texteingabe-Fragen der eingegebene Text.
    * '''label'''\\ Beschriftung des Antwortcodes (Auswahlfragen: Option, Mehrfachauswahl: "nicht ausgewählt" oder "ausgewählt", Skalen: Wertelabel)
    * '''text'''\\ Beschriftung der Antwortoption wie im Fragebogen (Auswahlfrage: gewählte Option, Mehrfachauswahl: Text der Option, falls ausgewählt, sonst nichts)
    * '''free'''\\ Falls Sie eine Auswahl mit offenem Texteingabefeld erlauben, liefert diese Option den Text der gewählten Option __oder__ die offene Texteingabe, wenn eine solche gemacht wurde.


===== Anwendung in Filtern =====

**Tipp:** Siehe auch [[:de:create:filters|Filterfragen und Filter]].

Der Befragte hat die Frage ''07'' in der Rubrik ''AB'' (eine dichotome Skala) auf der vorhergehenden Seite beantwortet. Folgender Code zeigt fragt die Frage ''XY01'' nur dann ab, wenn der Teilnehmer das Item ''03'' der Frage ''AB07'' mit "ja" (in diesem Fall also der Ausprägung 2) beantwortet hat:

<code php>
if (value('AB07_03') == 2) {
  question('XY01');
}
</code>


===== Anzeige der eigenen Antwort =====

Der Teilnehmer kann sein Lieblings-Schulfach auswählen oder bei "Anderes:" selbst eintragen. Das Fach soll auf einer späteren Seite angezeigt werden.

**Tipp:** Siehe auch [[:de:create:placeholders|Platzhalter]].

<code php>
$fach = value('AB08', 'free');
html('<h1>Schulfach: '.$fach.'</h1>');
</code>