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

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

The function ''serialCheck()'' reveals whether an //accessCode//  is valid, and whether it has already been used. This function can be helpful in calling up an access code manually.

**Note:** Only the status of an access code can be checked with this function -- the access code will not be marked as "used" at the end of the questionnaire.


===== Return Value =====

''serialCheck()'' generates one of the following codes:

^Code^Meaning^
|-1|No access code specified|
|0|Access code not recognized in the survey project|
|1|Access code already used (questionnaire is thus completed)|
|2|Questionnaire was already called up with the access code, but not completed|
|3|Access code yet to be used|


===== Example =====

The following example assumes that an access code was asked for on the previous page in the text input field "AB01_01". The PHP code now checks whether the access code specified is valid. If not, the PHP code shows a text element as an error message, and redisplays the previous page with ''[[:en:create:functions:repeatpage|repeatPage]]'' 

<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>