simple_strtoul()分析
此函数有以下几点值得注意:
1、第一个参数中的const。一般在函数的形参中,如果我们只是希望调用者使用该参数,而不会去改变该参数内容(一般是指针指向的内容),则可以声明为const。
2、第二个参数。C语言中函数只能有一个返回值,但是有时候我们希望从函数中得到不止一个返回内容怎么办呢?只能通过参数了。一般的参数是用来向函数输入信息的,但是指针型参数可以间接用来从函数输出信息。使用时用户只需传入一个相应的指针,函数中会把需要输出的信息地址传给这个指针,这样在函数调用完成后,用户即可到endp指针处去取函数传出的值了。这就是用参数实现返回值的方式。但是要注意,在函数中千万不可把局部变量的地址传给输出型指针,因为局部变量存在栈里,函数调用结束后即释放了,传出的指针指向的内容是栈上已经被释放的部分,因此是无效的。(PS:高级语言中譬如C#有ref,out关键字,以明确指明该引用为输出型)
3、第三个参数base。要注意这个base的机制,本函数中是按照这样的理念来设计的。即如果str中有0x开头且接下来是数字则忽略用户调用时输入的base,强制为16进制。如果str不是上面情况然后才看用户输入的base。用户输入非0则使用用户指定的base,若用户输入0则自动判断是8进制还是10进制。需要强调的是:使用习惯决定理念,理念决定代码逻辑。
4、注意 if(endp)这里,在输出型参数使用中,函数内首先判断endp是否为NULL,并以此来决定是否输出这个机制来自于一个理念:这个输出参数有可能是用户关注的,也有可能是用户不在意的。这样处理可以给用户自由,即用户如果在意就传一个有效指针过来接收;如果不在意调用时直接给个NULL就行。提供服务但不强迫,这样很好。在OS的API中很多时候都有类似的技巧,请注意体会。
unsigned long simple_strtoul(const char *cp,char **endp,unsigned int base)
{
unsigned long result = 0,value;
//对于base,首先如果*cp以0x开头且下来是数字,则一定为16进制。然后如果用户指定了一个非0的进制,则
//遵循用户输入的进制。如果用户输入了0进制,则根据是否0开头来确定是8进制还是10进制
if (*cp == '0') {
cp++;
if ((*cp == 'x') && isxdigit(cp[1])) {
base = 16; //如果cp是0x开头的,下面一个又是数字,那么base一定为16。
cp++; //此时即使用户输入了一个base,也忽略这个base而强制其为16。
}
if (!base) {
base = 8; //如果用户输入base为0,cp是0开头,接下来不是x,那么强制为8进制
}
}
if (!base) {
base = 10; //如果用户输入base为0,cp是非0开头,则使用10进制。
}
//while循环里value<base是精髓所在。这个解析停止的条件不能是null,而应该是str中
//第一个不是数字的字母。这个字母的范围取决于base,譬如如果是16进制那么f也算是数字。
//而如果是8进制那么9都不算是数字了。因此解析结束的范围只能和base比较来限定。
while (isxdigit(*cp) && (value = isdigit(*cp) ? *cp-'0' : (islower(*cp)
? toupper(*cp) : *cp)-'A'+10) < base) {
result = result*base + value;
cp++;
}
if (endp) //此处if判断的作用是:用户在使用这个函数时,如果不关心endp则可以直接
*endp = (char *)cp; //使用null,而不必担心程序运行会出错。这种处理技巧很实用,用户可以
return result; //自行决定是否使用这个函数提供的参数式返回值。
}