====== serialCheck() ======

''int **serialCheck**(string //Teilnahmecode//)''

Die Funktion ''serialCheck()'' verrät, ob ein //Teilnahmecode// gültig ist und ob sie bereits verwendet wurde. Diese Funktion kann hilfreich sein, wenn man eine Teilnahmecode manuell abfragen möchte.

**Wichtig:** Mit der Funktion kann lediglich der Status eines Teilnahmecodes geprüft werden -- der Teilnahmecode wird am Ende des Interviews nicht als "verbraucht" markiert.


===== Rückgabewert =====

Als Ergebnis liefert ''serialCheck()'' einen der folgenden Codes.

^Code^Bedeutung^
|-1|Es wurde kein Teilnahmecode angegeben|
|0|Der Teilnahmecode ist im Befragungsprojekt nicht bekannt|
|1|Der Teilnahmecode wurde bereits verbraucht (ein Fragebogen damit abgeschlossen)|
|2|Mit dem Teilnahmecode wurde bereits ein Fragebogen aufgerufen, aber nicht abgeschlossen|
|3|Der Teilnahmecode wurde noch nicht verwendet|


===== Beispiel =====

Das folgende Beispiel geht davon aus, dass auf der vorhergehenden Seite im Texteingabefeld "AB01_01" ein Teilnahmecode erfragt wurde. Der PHP-Code prüft nun, ob der angegebene Teilnahmecode gültig ist. Falls nicht, zeigt der PHP-Code mittels ''[[:de:create:functions:repeatpage|repeatPage]]'' einen Textbaustein als Fehlermeldung sowie erneut die vorige Seite.

<code php>
$serial = value('AB01_01');
$status = serialCheck($serial);

if ($status == -1) {
  repeatPage('serialVoid');
} elseif ($status == 0) {
  repeatPage('serialWrong');
} elseif ($status == 1) {
  repeatPage('serialUsed');
}
</code>