get_error_textget_error_textGetErrorTextget_error_textGetErrorTextGetErrorText (Operator)

Name

get_error_textget_error_textGetErrorTextget_error_textGetErrorTextGetErrorText — Abfragen der Fehlerbeschreibung zu einem HALCON-Fehlercode.

Signatur

Beschreibung

get_error_textget_error_textGetErrorTextget_error_textGetErrorTextGetErrorText 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_textGetErrorTextget_error_textGetErrorTextGetErrorText 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.

Parallelisierung

• 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_id);
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_textGetErrorTextget_error_textGetErrorTextGetErrorText liefert den Wert 2 (H_MSG_TRUE), falls die Parameter korrekt sind. Ansonsten wird eine Ausnahme ausgelöst.

Vorgänger

set_checkset_checkSetCheckset_checkSetCheckSetCheck

Siehe auch

set_checkset_checkSetCheckset_checkSetCheckSetCheck

Modul

Foundation