学电子的小伙伴都知道,我们的逻辑电平0代表低,1代表高。还有,逻辑运算时,0代表假,非0值代表真。
那么,你发现一个问题没有,我们C/C++编程时,很多情况下都是返回0代表成功?
比如:RTOS创建任务返回“错误信息”
图片
OS_ERR_NONE这个值就是宏定义的0:
#define OS_ERR_NONE 0u
其实不止这个返回值,还有很多都是类似0代表成功(或无错误)。
在嵌入式C/C++编程中,函数返回0代表成功,一种广泛接受的约定。
为什么会有这种约定?其实背后都是有故事的,下面简单说几点。
1、历史原因
在早期的C语言编程实践中,特别是在早期的Unix系统编程中,0被用作成功执行的返回值,即程序执行成功没有错误发生,而非0值则表示出现了某种错误。
而Unix在当时又非常流行,后来,这种习惯随着这些系统和语言的普及而变得普遍。
2、统一规范
因为有前面 Uinx 的案例,后面的开发者为了代码的可读性和可维护性,许多编程标准和规范都使用0表示成功,这样可以使得代码在不同的开发者和项目之间保持一致性。
3、行业潜规则
随着时间的推移,这种使用0表示成功、非零值表示失败的约定,逐渐成为了C语言及嵌入式编程中的行业潜规则。遵守这一潜规则可以使代码更易于理解和维护,同时也便于不同程序员之间的协作。
同时,在编程社区中,这种约定已经深入人心,成为了编程实践中的一种标准做法。因此,即使在新开发的嵌入式系统中,也往往会延续这一潜规则。
4、符合逻辑
从逻辑上讲,成功通常被视为一种特殊情况(即只有一种可能),而失败则可能由多种原因造成(即有多种可能)。
比如上面举的例子RTOS中,存在很多种错误:
#define OS_ERR_NONE 0u
#define OS_ERR_EVENT_TYPE 1u
#define OS_ERR_PEND_ISR 2u
#define OS_ERR_POST_NULL_PTR 3u
#define OS_ERR_PEVENT_NULL 4u
#define OS_ERR_POST_ISR 5u
#define OS_ERR_QUERY_ISR 6u
#define OS_ERR_INVALID_OPT 7u
#define OS_ERR_ID_INVALID 8u
#define OS_ERR_PDATA_NULL 9u
#define OS_ERR_TIMEOUT 10u
#define OS_ERR_EVENT_NAME_TOO_LONG 11u
#define OS_ERR_PNAME_NULL 12u
#define OS_ERR_PEND_LOCKED 13u
#define OS_ERR_PEND_ABORT 14u
#define OS_ERR_DEL_ISR 15u
#define OS_ERR_CREATE_ISR 16u
#define OS_ERR_NAME_GET_ISR 17u
#define OS_ERR_NAME_SET_ISR 18u
#define OS_ERR_ILLEGAL_CREATE_RUN_TIME 19u
//...
#define OS_ERR_TLS_NO_MORE_AVAIL 160u
#define OS_ERR_TLS_ID_INVALID 161u
#define OS_ERR_TLS_NOT_EN 162u
#define OS_ERR_TLS_DESTRUCT_ASSIGNED 163u
#define OS_ERR_OS_NOT_RUNNING 164u
你会发现,成功只有一种,错误有100多种。因此,使用唯一的0值来表示成功,并使用非零值来表示多种可能的失败情况,在逻辑上更为清晰和合理。
5、兼容性更强
很多时候,我们做项目都会使用第三方库,这个时候,如果你项目的规则和和第三方不一直,调试或维护代码就很恼火,一会0,一会儿非0,你都不知道究竟是什么意思了。
6、其他
其实还有很多原因,什么编码习惯、错误处理等,大致就是保持代码一致性的意思。当然,也欢迎大家留言说出更多原因。
说了这么多,其实,我们都是建立在别人成功的基础上,或者说站在巨人的肩膀上。你不要想着自己搞一套规则出来,这种情况,一般人都是找麻烦,除非你是真正的牛人。