====== dropValue() ======

''void **dropValue**(String //VariablenKennung//)''

Die Funktion ''dropValue()'' löscht die Antwort für die Variable mit der angegeben //VariablenKennung//.

  * //VariablenKennung//\\ Die Kennung eine Variable wie in der **variablen-Übersicht** ersichtlich.

**Warnung:** Eine Antwort, die mittels ''dropValue()'' gelöscht wurde, kann nicht wiederhergestellt werden. Die Variable taucht im Datensatz auf als ob sie nicht abgefragt worden wäre.


===== Anwendungsbereiche =====

Ein sinnvoller Einsatzbereich der Funktion ''dropValue()'' kann darin bestehen, die E-Mail-Adresse einer Person abzufragen, um mittels ''[[:de:create:functions:mailsend]]'' eine E-Mail zu versenden und die Adresse sofort wieder zu löschen. Solange man in der E-Mail keine Daten über benutzerdefinierte Felder einfügen muss, ist für solche Fälle der Fragetyp [[de:create:questions:email]] meist die bessere Wahl.

Ein anderer Einsatzbereich kann darin bestehen, dass die Teilnehmer eine Antwort (z.B. eine Mailadresse oder ein kurzer Aufsatz) geben soll, diese aber aus Datenschutzgründen nicht im Datensatz auftauchen darf. Etwa als Priming-Aufgabe oder wenn nur die Länge des Textes interessiert, nicht aber der Inhalt. Wenn Sie Informationen über den Text speichern, achten Sie aber darauf, dass der PHP-Code der Seite ggf. mehrfach ausgeführt werden könnte, z.B. wenn der Teilnehmer die Seite erneut lädt. In solchen Fällen hilft die Funktion ''[[:de:create:functions:getroute]]''. Natürlich sollte dem Teilnehmer auch kein Zurück-Knopf angeboten werden.

<code php>
if (getRoute() == 'next') {
  // Länge des eingegebenen Textes im Eingabefeld TX01_01 bestimmen (in Zeichen)
  $length = mb_strlen(value('TX01_01'));
  // Die Länge in der internen Variable IV01_01 speichern
  put('IV01_01', $length);
  // Die eigentliche Texteingabe löschen
  dropValue('TX01_01');
}
</code>