get_error_text — Abfragen der Fehlerbeschreibung zu einem HALCON-Fehlercode.
get_error_text( : : ErrorCode : ErrorMessage)
get_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_text ist z.B. dann nützlich, wenn die Fehlerbehandlung
selbst programmiert wird (siehe: set_check(::'~give_error':)).
Bei unbekanntem Fehlercode wird eine Standardmeldung ausgegeben.
ErrorCode (input_control) integer → (integer)
Fehlercode.
Restriktion: 1 <= ErrorCode && ErrorCode <= 36000
ErrorMessage (output_control) string → (string)
Zugehörige Fehlerbeschreibung.
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);
}
get_error_text liefert den Wert 2 (H_MSG_TRUE), falls die Parameter korrekt sind.
Ansonsten wird eine Ausnahme ausgelöst.
none