| Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende ÜberarbeitungNächste ÜberarbeitungBeide Seiten der Revision |
| de:create:functions:put [19.09.2018 13:45] – [Beispiel: Randomisierung I] admin | de:create:functions:put [26.09.2020 14:54] – [Beispiel: Randomisierung I] sophia.schauer |
|---|
| ====== put() ====== | ====== put() ====== |
| |
| ''void **put**(string //Variable//, mixed //Wert//)'' | ''void **put**(string //Variable//, mixed //Wert//, [boolean //JedeVariable//])'' |
| |
| Mit der Funktion ''put()'' können Sie einen einzelnen Wert im Datensatz abspeichern. ''put()'' wird verwendet, wenn der Fragebogen einen Wert berechnet oder würfelt -- und man diesen Wert in der Auswertung benötigt. Wird beispielsweise der Stimulus einer Frage zufällig variiert, dann muss man für die Auswertung wissen, wozu der Befragte sich geäußert hat. | Mit der Funktion ''put()'' können Sie einen einzelnen Wert im Datensatz abspeichern. ''put()'' wird verwendet, wenn der Fragebogen einen Wert berechnet oder würfelt -- und man diesen Wert in der Auswertung benötigt. Wird beispielsweise der Stimulus einer Frage zufällig variiert, dann muss man für die Auswertung wissen, wozu der Befragte sich geäußert hat. |
| * //Variable//\\ Die Kennung der internen Variable (s. unten), in welcher der //Wert// gespeichert werden soll. Die Kennung wird als String in Anführungszeichen angegeben, z.B. '''IV01_01'''. | * //Variable//\\ Die Kennung der internen Variable (s. unten), in welcher der //Wert// gespeichert werden soll. Die Kennung wird als String in Anführungszeichen angegeben, z.B. '''IV01_01'''. |
| * //Wert//\\ Eine Zahl oder ein Text (String), welche%%(r)%% in der Variable abgelegt werden soll. Für gewöhnlich wird als zweiter Parameter eine Variable mit dem entsprechenden Wert angegeben. | * //Wert//\\ Eine Zahl oder ein Text (String), welche%%(r)%% in der Variable abgelegt werden soll. Für gewöhnlich wird als zweiter Parameter eine Variable mit dem entsprechenden Wert angegeben. |
| | * //JedeVariable// (optional)\\ Normalerweise speichert `put()` ausschließlich in [[de:create:questions:internal|interne Variablen]]. In Ausnahmefällen kann es sinnvoll sein, den Wert einer anderen Variable zu überschreiben. In diesem Fall kann ein dritter Parameter ''true'' angegeben werden. |
| | |
| | **Warnung:** Verwenden Sie den dritten Parameter //JedeVariable// nur dann, wenn Sie genau wissen, was Sie tun und eine interne Variable nicht verwendet werden kann. Das Verändern von Antwortcodes kann die Validität des Datensatzes gefährden. Für die meisten Fälle sind die Funktionen ''[[:de:create:functions:preset]]'' und ''[[:de:create:functions:dropvalue]]'' deutlich besser geeignet. |
| |
| |
| // Nur gültige Werte (>0) speichern | // Nur gültige Werte (>0) speichern |
| if ($original > 0) { | if ($original > 0) { |
| put('SK02_01', $original - 5); | put('SK02_01', $original - 3); |
| } else { | } else { |
| put('SK02_01', false); | put('SK02_01', false); |
| <code php> | <code php> |
| $org = value('SK01_01'); | $org = value('SK01_01'); |
| put('SK02_01', ($org > 0) ? $org - 5 : false); | put('SK02_01', ($org > 0) ? $org - 3 : false); |
| </code> | </code> |
| |
| $original = value(id('SK01', $item)); | $original = value(id('SK01', $item)); |
| if ($original > 0) { | if ($original > 0) { |
| put(id('SK02', $item), $original - 5); | put(id('SK02', $item), $original - 3); |
| } else { | } else { |
| put(id('SK02', $item), false); | put(id('SK02', $item), false); |
| ===== Beispiel: Randomisierung I ===== | ===== Beispiel: Randomisierung I ===== |
| |
| Wenn Sie mittels ''shuffle()'' eine zufällig gemischte Liste erstellen, wird diese zunächst nicht gespeichert. Mittels ''put()'' lässt sie entweder die gemischte Liste -- oder die Rangfolge der Elemente speichern. Je nachdem, was für die Auswertung benötigt wird. | Wenn Sie mittels ''shuffle()'' eine zufällig gemischte Liste erstellen, wird diese zunächst nicht gespeichert. Mittels ''put()'' lässt sich entweder die gemischte Liste -- oder die Rangfolge der Elemente speichern. Je nachdem, was für die Auswertung benötigt wird. |
| |
| Folgender PHP-Code ordnet etwa die Wert von 1 bis 10 zufällig: | Folgender PHP-Code ordnet etwa die Wert von 1 bis 10 zufällig: |
