get_extended_error_info
— Abfragen der erweiterten Fehlerinformation für den letzten
aufgetretetenen HALCON Fehler des aufrufenden Threads.
get_extended_error_info( : : : OperatorName, ErrorCode, ErrorMessage)
get_extended_error_info
gibt eine erweiterte Beschreibung des
letzten aufgetretenen HALCON Fehlers innerhalb des aufrufenden
Threads zurück. OperatorName
enthält den Operator Namen des HALCON
Operators, der diesen Fehlercode gesetzt hat. ErrorCode
enthält einen erweiterten Fehlercode, sofern er vom HALCON Operator gesetzt
wurde. Die Beschreibung des Fehlers wird in ErrorMessage
zurückgegeben. Wenn keine erweiterte Fehlerbeschreibung von einem
HALCON Operator gesetzt wurde, wird ein leerer Fehlercode
zurückgegeben und die Parameter OperatorName
und ErrorMessage
enthalten
leere Strings und 'ErrorCode' 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_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 oder der Thread beendet wird.
OperatorName
(output_control) string →
(string)
Operator, in welchem der Fehler aufgetreten ist.
ErrorCode
(output_control) integer →
(integer)
Erweiterter Fehlercode.
ErrorMessage
(output_control) string →
(string)
Erweiterte Fehlerbeschreibung.
none