Halcon算子翻译——dev_get_exception_data

名称

dev_get_exception_data - 访问exception元组的元素。

用法

dev_get_exception_data( : : Exception, Name : Value)

描述

　　算子dev_get_exception_data允许访问由算子catch捕获的exception元组的特定项目。 除了从来都是作为exception元组的第一个元素传递的错误代码外，exception元组的所有其他数据都必须通过算子dev_get_exception_data专门访问。 这是因为提供的数据的顺序和范围在将来的版本中可能会改变，并且可能会因不同的导出代码类型而有所不同。

　　如果一个算子在HDevelop或HDevEngine中发生错误，则捕获的exception元组包含下面列出的数据项。 这个元组必须传递给参数Exception。 请求的数据位置（slot）的名称必须传递给参数Name。 请求的数据在参数Value中返回。 通过将slot名称的元组传递给Name，可以在dev_get_exception_data的单个调用中请求多个异常数据项。 在这种情况下，相应的数据元组被返回到Value中。 对于不可用的请求项目，算子返回空字符串（''）。

支持的data slots：

'error_code':

　　HALCON或用户定义的错误代码。 HALCON错误代码列表（代码<10000）可以在“Extension Package Programmer's Manua”的附录中找到。

'error_message':

　　HALCON错误信息。

'add_error_code':

　　附加的HDevelop特定的错误代码。 这些错误代码指定在HALCON算子（代码= 21000）内还是在算子外部（例如在判断和分配参数表达式期间）是否捕获到错误。 在后一种情况下，错误代码更精确地指定错误类型。 相关的错误代码列在“HDevelop User's Guide”中。

'add_error_message':

　　更精确地描述HDevelop特定错误的附加错误消息。

'program_line':

　　程序发生错误行的编号。

'operator':

　　抛出异常的算子的名称（如果异常在受保护的程序中抛出，则返回“ - protected - ”而不是算子名称）。

'call_stack_depth':

　　调用堆栈的深度（如果‘main’发生错误则返回深度1）。

'procedure':

　　发生错误的程序的名称。

'user_data':

　　用户定义的exception元组。 如果算子异常被捕获并重新抛出，则这是在throw调用中被追加到捕获的异常元组中的元组。 如果是完全由用户定义的异常，则返回除包含错误代码（> = 30000）的第一个元素之外的所有元组项。 如果没有通过异常元组传递用户数据，则返回一个空元组。 请注意，在同一个dev_get_exception_data调用中，用户数据元组（user data tuple）不能和任何其他异常数据一起请求。

参数

Exception (input_control)　　　　 exception-array → (integer / string)
　　包含exception数据或用户定义的错误代码的元组。

Name (input_control) 　　　　      attribute.name(-array) → (string)

　　请求的exception数据的名称。
　　Default value: 'error_code'
　　List of values: 'add_error_code', 'add_error_message', 'call_stack_depth', 'error_code', 'error_message', 'operator', 'procedure', 'program_line', 'user_data'

Value (output_control) attribute.value-array → (integer / string)
　　请求的exception数据。

结果

如果指定参数的值正确，则dev_get_exception_data（作为算子）返回2（H_MSG_TRUE）。 否则会引发异常并返回错误代码。

Possible Predecessors

catch

See also

try, catch, endtry, throw, dev_set_check

模块

Foundation

HDevelop例程

try_catch.hdev 　　　　　　　　　 Demonstrate the usage of the exception handling in HDevelop
set_shape_model_timeout.hd 　　  Demonstrate how to use the timeout mechanism for shape-based matching