Zum Hauptinhalt springen

c16_errortext

c16_errortext([aErrorSource : mixed]) : mixed​

Fehlertext ermitteln

Details

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.