infoVars()

array infoVars(string|array VariablenNamen)

Die Funktion infoVariable() liefert technische Informationen zu einer Variable im Datensatz. Besonders nützlich ist diese Funktion, wenn man in der Programmierung eines Fragebogens mit (individuellen) Variablennamen arbeiten möchte, und die dazugehörigen Item-IDs benötigt.

• string VariablenNamen – Ein einzelner Variablenname.
• array VariablenNamen – Eine Liste mehrerer Variablennamen.

Die Funktion liefert immer ein Array zurück, welches die übergebenen VariablenName(n) als Schlüssel und entweder ein Array mit Informationen oder (falls unter dem Namen keine Variable gefunden wurde) null zurückliefert.

Enthaltene Arrays beinhalten folgende Infortmationen:

• label – Der „technische“ Name der Variable, bestehend aus Frage-Kennung und ggf. einem Appendix.
• question – Die Kennung der Frage, zu welcher die Variable gehört.
• item – Die numerische Kennung des Items innerhalb der Frage oder (falls die Variable nicht zu einem Item gehört) null.
• index – Der Index der Variable innerhalb der Frage oder innerhalb des Items, beginnend bei 0.

Der folgende PHP-Code ermittelt aus einer Liste von Variablen die zugehörigen Item-Kennungen, um diese in der Frage AB01 anzuzeigen. Die Variablen gehören hier alle zur Frage AB01.

$frage = 'AB01';
$vars = ['genAlpha', 'genGamma', 'genEpsilon'];
$items = [];
foreach (infoVars($vars) as $info) {
  if ($info['question'] == $frage) {
    $items[] = $info['item'];
  }
}
question($frage, $items);