HALCON Website / HALCON Operator-Referenz / System / Fehlerbehandlung
KlassenKlassenKlassenKlassen | | | | Operatoren

get_error_textget_error_textGetErrorTextget_error_textGetErrorTextGetErrorText (Operator)

Name

get_error_textget_error_textGetErrorTextget_error_textGetErrorTextGetErrorText — Abfragen des Fehlertexts zu einer HALCON-Fehlernummer.

Signatur

get_error_text( : : ErrorNumber : ErrorText)

Herror get_error_text(const Hlong ErrorNumber, char* ErrorText)

Herror T_get_error_text(const Htuple ErrorNumber, Htuple* ErrorText)

Herror get_error_text(const HTuple& ErrorNumber, char* ErrorText)

void GetErrorText(const HTuple& ErrorNumber, HTuple* ErrorText)

static HString HSystem::GetErrorText(Hlong ErrorNumber)

void HOperatorSetX.GetErrorText(
[in] VARIANT ErrorNumber, [out] VARIANT* ErrorText)

BSTR HSystemX.GetErrorText([in] Hlong ErrorNumber)

static void HOperatorSet.GetErrorText(HTuple errorNumber, out HTuple errorText)

static string HSystem.GetErrorText(int errorNumber)

Beschreibung

get_error_textget_error_textGetErrorTextget_error_textGetErrorTextGetErrorText gibt zu einer HALCON-Fehlernummer den zugehörigen Fehlertext 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 Fehler-Behandlung selbst programmiert wird (siehe: set_check(::'~give_error':)).

Achtung

Bei unbekannten Fehlernummern wird eine Standardmeldung ausgegeben.

Parallelisierung

Parameter

ErrorNumberErrorNumberErrorNumberErrorNumberErrorNumbererrorNumber (input_control)  integer → HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Nummer des HALCON-Fehlers.

Restriktion: 1 <= ErrorNumber && ErrorNumber <= 36000

ErrorTextErrorTextErrorTextErrorTextErrorTexterrorText (output_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Zugehöriger Fehlertext.

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

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 11.0.5 Copyright © 1996-2015 MVTec Software GmbH