SoSci Survey
Übersetzungen dieser Seite:
 

valueList()

array valueList(string Fragekennung, [array Items], [string Ausgabeformat])
array valueList(array Variablen, [null], [string Ausgabeformat])
array valueList(string Systemkennung)

Die Funktion valueList() ruft für alle Items einer Frage – oder für alle Items einer Frage, wenn keine Items angegeben werden – die Antwortcodes ab. Alternativ kann auch eine Liste von Variablen angegeben werden, für welche die Antwortcodes abgerufen werden.

  • Fragekennung
    Die Kennung einer Frage im Fragenkatalog.
  • Items
    Optional kann eine Liste von Items angegeben werden. Werden keine Items angegeben, verwendet die Frage alle Items der Frage.
  • Variablen
    Anstatt einer Fragekennung kann auch eine Liste von Variablen angegeben werden,
    z.B. valueList(array('AB01', 'AB02_01', 'AB02_02'))
  • Systemkennung
    Die Kennung 'TIME' ruft die Verweildauer der Seiten (TIME001, TIME002, etc.) als Array mit Seitenzahlen als Index und Verweildauer [Sekunden] als Wert ab.
  • Ausgabeformat
    Mit dem Ausgabeformat wird festgelegt, ob die Funktion den Antwort-Code (Standard) oder den Beschriftungstext der Antwort zurückgibt. Es sind die gleichen Angaben möglich wie bei value().

Rückgabewert

Die Funktion valueList() gibt ein assoziatives Array zurück. Die Kennungen der Variablen dienen als Schlüssel, die Antwortcodes für die Items als Werte, z.B.

array(
  'AB01' => 3,
  'AB02_01' => -1,
  'AB02_02' => 2
)

Zufallsgenerator

Eine häufige Anwendung der Funktion 'valueList() erfolgt in Zusammenhang mit einem Zufallsgenerator, der mehrere Zettel pro Interview zieht.

Der folgende PHP-Code ermittelt die Codes aller im Zufallsgenerator „IV01“ gezogenen Zettel als Array.

$codes = valueList('IV01');

Der folgende Code ließt die Beschriftungen der gezogenen Zettel anstatt derer numerischer Codes aus:

$codes = valueList('IV01',  null, 'label');
de/create/functions/valuelist.txt · Zuletzt geändert: 13.10.2018 14:47 von admin
 
Falls nicht anders bezeichnet, ist der Inhalt dieses Wikis unter der folgenden Lizenz veröffentlicht: CC Attribution-Share Alike 4.0 International
Driven by DokuWiki