write solid code 心得续
1.程序员设计函数时,有时把多个功能给了一个函数,然后利用参数来选择相应的功能,比如void* realloc( void* pv, size_t size );这个函数同时有增大,缩小buf的功能,用参数 size作判断 ;或者,比如 strcmp(str1,str2)用返回 0 正数 负数来 返回结果 ,这样的函数 可读性 防错能力很差,可以把函数功能拆分 成功能更单一的函数,使返回的意义明确。
返回值和参数 尽量用有意义的 define值,而不是意义不明的TRUE FALSE,或 数字。
如 void* realloc( void* pv, size_t size );分解为
flag fGrowMemory(void** ppv, size_t sizeLarger);
void ShrinkMemory(void* pv, size_t sizeSmaller);
strcmp(str1,str2)分解为
if( strcmp( strLeft, strRight ) == STR_LESS )
if( strcmp( strLeft, strRight ) == STR_GREATER )
if( strcmp( strLeft, strRight ) == STR_EQUAL ) 或
#define fStrLess(strLeft, strRight) ( strcmp(strLeft, strRgiht) < 0 )#define fStrGreater(strLeft, strRight) ( strcmp(strLeft, strRight) > 0 #define fStrEqual(strLeft, strRight) ( strcmp(strLeft, strRgiht) == 0 )
2.返回数据用参数传出,返回值只用于函数执行情况的查询 成功,失败errcode
3.有条件尽量细化errcode