get_error_textget_error_textGetErrorTextGetErrorTextget_error_text (Operator)

Name

get_error_textget_error_textGetErrorTextGetErrorTextget_error_text — Abfragen der Fehlerbeschreibung zu einem HALCON-Fehlercode.

Signatur

Beschreibung

get_error_textget_error_textGetErrorTextGetErrorTextGetErrorTextget_error_text gibt zu einem HALCON-Fehlercode den zugehörigen Fehlerbeschreibung aus. Es handelt sich hierbei um denselben Text, der bei einer Fehlerbehandlung ausgegeben wird. get_error_textget_error_textGetErrorTextGetErrorTextGetErrorTextget_error_text ist z.B. dann nützlich, wenn die Fehlerbehandlung selbst programmiert wird (siehe: set_check(::'~give_error':)).

Achtung

Bei unbekanntem Fehlercode wird eine Standardmeldung ausgegeben.

Ausführungsinformationen

• Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Wird ohne Parallelisierung verarbeitet.

Parameter

Beispiel (C)

Herror   err;
char       message[MAX_STRING];

set_check("~give_error");
err = send_region(region,socket);
set_check("give_error");
if (err != H_MSG_TRUE) {
get_error_text((Hlong)err,message);
  fprintf(stderr,"my error message: %s\n",message);
  exit(1);
}

Ergebnis

get_error_textget_error_textGetErrorTextGetErrorTextGetErrorTextget_error_text liefert den Wert TRUE, falls die Parameter korrekt sind. Ansonsten wird eine Ausnahme ausgelöst.

Vorgänger

set_checkset_checkSetCheckSetCheckSetCheckset_check

Siehe auch

set_checkset_checkSetCheckSetCheckSetCheckset_check

Modul

none