get_extended_error_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfoget_extended_error_info (Operator)

Name

get_extended_error_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfoget_extended_error_info — Abfragen der erweiterten Fehlerinformation für den letzten aufgetretenen HALCON Fehler des aufrufenden Threads.

Signatur

Beschreibung

get_extended_error_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfoGetExtendedErrorInfoget_extended_error_info gibt eine erweiterte Beschreibung des letzten aufgetretenen HALCON Fehlers innerhalb des aufrufenden Threads zurück. OperatorNameOperatorNameOperatorNameOperatorNameoperatorNameoperator_name enthält den Operator Namen des HALCON Operators, der diesen Fehlercode gesetzt hat. ErrorCodeErrorCodeErrorCodeErrorCodeerrorCodeerror_code enthält einen erweiterten Fehlercode, sofern er vom HALCON Operator gesetzt wurde. Die Beschreibung des Fehlers wird in ErrorMessageErrorMessageErrorMessageErrorMessageerrorMessageerror_message zurückgegeben. Wenn keine erweiterte Fehlerbeschreibung von einem HALCON Operator gesetzt wurde, wird ein leerer Fehlercode zurückgegeben und die Parameter OperatorNameOperatorNameOperatorNameOperatorNameoperatorNameoperator_name und ErrorMessageErrorMessageErrorMessageErrorMessageerrorMessageerror_message enthalten leere Strings und ErrorCodeErrorCodeErrorCodeErrorCodeerrorCodeerror_code den Wert 0. Die entsprechende Dokumentation eines Operators kann man entnehmen, ob und unter welchen Umständen der Operator die erweiterte Fehlerbeschreibung setzt.

get_extended_error_infoget_extended_error_infoGetExtendedErrorInfoGetExtendedErrorInfoGetExtendedErrorInfoget_extended_error_info ist thread-lokal, d.h. eine erweiterte Beschreibung des letzten HALCON Fehlers wird für jeden Thread separat zur Verfügung gestellt. Das Setzen eines erweiterten Fehlercodes in einem Thread beeinflusst somit nicht den erweiterten Fehlercode in einem anderen Thread. Das bedeutet auch, dass ein erweiterter Fehlercode nur in dem Thread ausgelesen werden kann, der auch den Operator aufgerufen hat, welcher den Fehler gesetzt hat. Eine thread-lokale Fehlerbeschreibung wird gelöscht (oder überschrieben), wenn innerhalb desselben Threads ein weiterer HALCON Fehler auftritt, der Operator set_systemset_systemSetSystemSetSystemSetSystemset_system innerhalb desselben Threads mit dem Parameter 'tsp_clear_extended_error'"tsp_clear_extended_error""tsp_clear_extended_error""tsp_clear_extended_error""tsp_clear_extended_error""tsp_clear_extended_error" aufgerufen wird, oder der Thread beendet wird.

Ausführungsinformationen

• Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
• Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
• Wird ohne Parallelisierung verarbeitet.

Parameter

Siehe auch

get_error_textget_error_textGetErrorTextGetErrorTextGetErrorTextget_error_text

Modul

none