get_error_textget_error_textGetErrorTextGetErrorText (Operator)

Name

get_error_textget_error_textGetErrorTextGetErrorText — Abfragen der Fehlerbeschreibung zu einem HALCON-Fehlercode.

Signatur

get_error_text( : : ErrorCode : ErrorMessage)

Herror get_error_text(const Hlong ErrorCode, char* ErrorMessage)

Herror T_get_error_text(const Htuple ErrorCode, Htuple* ErrorMessage)

void GetErrorText(const HTuple& ErrorCode, HTuple* ErrorMessage)

static HString HSystem::GetErrorText(Hlong ErrorCode)

static void HOperatorSet.GetErrorText(HTuple errorCode, out HTuple errorMessage)

static string HSystem.GetErrorText(int errorCode)

Beschreibung

get_error_textget_error_textGetErrorTextGetErrorTextGetErrorText 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_textGetErrorTextGetErrorTextGetErrorText 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

Parameter

ErrorCodeErrorCodeErrorCodeErrorCodeerrorCode (input_control)  integer HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Fehlercode.

Restriktion: 1 <= ErrorCode && ErrorCode <= 36000

ErrorMessageErrorMessageErrorMessageErrorMessageerrorMessage (output_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

Zugehörige Fehlerbeschreibung.

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

Vorgänger

set_checkset_checkSetCheckSetCheckSetCheck

Siehe auch

set_checkset_checkSetCheckSetCheckSetCheck

Modul

none