c16_errortext

Mit dieser Funktion können die Klartexte zu Fehlern ermittelt werden. Folgende Anwendungen stehen zur Verfügung:

• Alle Fehlermeldungen ermitteln

  Wird der Befehl ohne Parameter aufgerufen, wird ein Array mit allen Fehlermeldungen zurückgegeben. Auf den Inhalt des indizierten Array kann mit Hilfe der Fehlerkonstanten zugegriffen werden.

  $errortext = c16_errortext();
  echo $errortext[C16ERR_SERVER_USER_LIMIT];

• Fehlertext zu einer Fehlernummer ermitteln

  Wird der Befehl mit einer Fehlernummer aufgerufen, wird der Klartext zu diesem Fehler in einer Zeichenkette zurückgegeben.

  echo c16_errortext(C16ERR_SERVER_USER_LIMIT);

• Fehlertext des zuletzt aufgetretenen Fehlers ermitteln

  Wird der Befehl mit einem Verbindungsobjekt (siehe c16_connect()) aufgerufen, wird der Klartext zu dem zuletzt aufgetretenen Fehler als Zeichenkette zurückgegeben.

  $connection = c16_connect('TCP:10.1.0.2+10.1.0.1', '', 'Examples', 'USER', '');
  if (c16_error($connection) != C16_OK)
  {
    echo c16_errortext($connection);
  }

Von der Anweisung können folgende Resultatwerte zurückgegeben werden:

• C16_OK (0): Kein Fehler aufgetreten.
• C16ERR_ARGS_FORMAT (-251): Anzahl der Argumente oder Typ eines Arguments ungültig.
• C16ERR_ARGS_TYPE (-252): Typ eines mehrtypigen Arguments ungültig.
• C16ERR_ARGS_CONNECTION (-254): Kein Verbindungsobjekt übergeben.
• C16ERR_RESULT_ARRAY (-256): Initialisierung eines zurückzugebenden Arrays fehlgeschlagen.