get_extended_error_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfoget_extended_error_info (Operator)

Name

get_extended_error_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfoget_extended_error_info — Returns the extended error information for the calling thread's last HALCON error.

Signature

get_extended_error_info( : : : OperatorName, ErrorCode, ErrorMessage)

Herror get_extended_error_info(char* OperatorName, Hlong* ErrorCode, char* ErrorMessage)

Herror T_get_extended_error_info(Htuple* OperatorName, Htuple* ErrorCode, Htuple* ErrorMessage)

void GetExtendedErrorInfo(HTuple* OperatorName, HTuple* ErrorCode, HTuple* ErrorMessage)

static HString HSystem::GetExtendedErrorInfo(Hlong* ErrorCode, HString* ErrorMessage)

static void HOperatorSet.GetExtendedErrorInfo(out HTuple operatorName, out HTuple errorCode, out HTuple errorMessage)

static string HSystem.GetExtendedErrorInfo(out int errorCode, out string errorMessage)

def get_extended_error_info() -> Tuple[str, int, str]

Description

get_extended_error_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfoGetExtendedErrorInfoget_extended_error_info returns the last error code that occurred in the calling thread. OperatorNameOperatorNameOperatorNameOperatorNameoperatorNameoperator_name contains the operator name of the HALCON operator that has set this error code. ErrorCodeErrorCodeErrorCodeErrorCodeerrorCodeerror_code holds the actual error code and ErrorMessageErrorMessageErrorMessageErrorMessageerrorMessageerror_message the corresponding error message. If no error code has been set so far or a HALCON error comes with no extended error information, OperatorNameOperatorNameOperatorNameOperatorNameoperatorNameoperator_name and ErrorMessageErrorMessageErrorMessageErrorMessageerrorMessageerror_message contain an empty string and ErrorCodeErrorCodeErrorCodeErrorCodeerrorCodeerror_code is set to 0. Please refer to 'Result' slot of the particular operator reference to determine whether and on which occasion an operator provides extended error information.

get_extended_error_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfoGetExtendedErrorInfoget_extended_error_info is thread-local, i.e., the extended error information is maintained on a per thread basis. Setting an extended error code in one thread does not affect the extended error information in any other thread. This also implies that an error code can only be retrieved within the thread that was calling the operator setting the extended error. A thread-local extended error will be cleared (and set again when applicable) as soon as an error occurs in any other successive operator call within the same thread or the thread terminates.

Execution Information

Parameters

OperatorNameOperatorNameOperatorNameOperatorNameoperatorNameoperator_name (output_control)  string HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Operator that set the error code.

ErrorCodeErrorCodeErrorCodeErrorCodeerrorCodeerror_code (output_control)  integer HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Extended error code.

ErrorMessageErrorMessageErrorMessageErrorMessageerrorMessageerror_message (output_control)  string HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Extended error message.

See also

get_error_textget_error_textGetErrorTextGetErrorTextGetErrorTextget_error_text

Module

none