我们在编写Linux运行库时,特别是作为组件提交给其他程序员使用时,很有必要提供返回消息以提高组件在开发过程中的可用性。本文将为您讲述一些实用的技巧。
1. 利用标准C库中的返回消息
在自己组件中的方法或过程中,如果消息比较一般,可以直接利用标准C库中的返回消息。标准C库中的返回消息代码定义列在头文件errno.h中,返回消息是用从0开始的一个整数值表示的,其中0为正确的返回值,其他为警告类型或错误类型的返回值。在标准C库中,用了一个全局变量errno来指明当前调用的返回消息值。在组件的方法或过程中,可以直接设置errno的值,当然要符合errno.h中的类型定义。在调用组件中的方法或过程时,可以直接调用C中的函数perror()或strerrno()来提交返回消息的文字说明。
2. 实现自定义的返回消息
一般情况下,标准C中的消息不足以反映自己组件中的方法或过程运行状态的。这时需要实现自己特有的返回消息。主要步骤如下:
第一,规定返回消息代码。
组件中方法或过程的运行状态中有一部分要作为返回值,这些返回值要反映多种复杂的运行状态,有成功返回值、一般运行消息值、警告值、一般错误值、严重错误值等。返回消息代码要直接反映这些状态。另外,返回值中还需要反映该方法或过程位于那个组件中。我们可以用一个整数值的头两位标识返回类型,其中成功返回值、一般运行消息值用正数,可以分别标识为0X10000000,0X20000000。警告值、一般错误值、严重错误值用负数值,可以分别标识为0X80000000,0X90000000,0XA0000000。而组件可以用第二个字节标识,如事务安全组件用11标识,则可以用0X000B00000标识。返回消息的具体代码则可以沿用标准C库中的表示方法,如正确返回值用0标识,某一严重错误错误用5表示。则对于事务安全组件,这两种消息可以标识为0X100B0000和0XA00B0005。
第二,表述返回消息的文字说明
表述返回消息的文字说明列在组件里的一个字符串数组中,各个消息的文字说明在数组中的位置按照消息的具体代码值决定。
例如事务安全组件中定义如下四个返回消息:0,成功返回值;1,事务定义错误;2,事务提交错误;3,事务返回错误。可以在定义如下字符串数组:
|
对应的返回消息代码分别为:0X100B0000,0X900B0001,0X900B0002,0X900B0003。
关注此文的读者还看过: