Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

de:create:functions:serialcheck [12.01.2015 20:21] (aktuell)
admin ausgelagert aus functions-proc
Zeile 1: Zeile 1:
 +====== serialCheck() ======
  
 +''​int **serialCheck**(string //​Seriennummer//​)''​
 +
 +Die Funktion ''​serialCheck()''​ verrät, ob eine //​Seriennummer//​ gültig ist und ob sie bereits verwendet wurde. Diese Funktion kann hilfreich sein, wenn man eine Seriennummer manuell abfragen möchte.
 +
 +**Wichtig:​** Mit der Funktion kann lediglich der Status einer Seriennummer geprüft werden -- die Seriennummer wird am Ende des Interviews nicht als "​verbraucht"​ markiert.
 +
 +===== Rückgabewert =====
 +
 +Als Ergebnis liefert ''​serialCheck()''​ einen der folgenden Codes.
 +
 +^Code^Bedeutung^
 +|-1|Es wurde keine Seriennummer angegeben|
 +|0|Die Seriennummer ist im Befragungsprojekt nicht bekannt|
 +|1|Die Seriennummer wurde bereits verbraucht (ein Fragebogen damit abgeschlossen)|
 +|2|Mit der Seriennummer wurde bereits ein Fragebogen aufgerufen, aber nicht abgeschlossen|
 +|3|Die Seriennummer wurde noch nicht verwendet|
 +
 +
 +===== Beispiel =====
 +
 +Das folgende Beispiel geht davon aus, dass auf der vorhergehenden Seite im Texteingabefeld "​AB01_01"​ eine Seriennummer erfragt wurde. Der PHP-Code prüft nun, ob die angegebene Seriennummer 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>​
de/create/functions/serialcheck.txt · Zuletzt geändert: 12.01.2015 20:21 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