当编写驱动程序时,一般情况下不能使用C标准库的函数。Linux内核也提供了与标准库函数功能相同的一些函数,但二者还是稍有差别。

 


类别



函数名



功能



函数形成



参数



描述



字符串转换



simple_strtol



把一个字符串转换为一个有符号长整数



long simple_strtol (const char * cp, char ** endp, unsigned int base)



cp指向字符串的开始,endp为指向要分析的字符串末尾处的位置,base为要用的基数。

 



 



simple_strtoll



把一个字符串转换为一个有符号长长整数



long long simple_strtoll (const char * cp, char ** endp, unsigned int base)



cp指向字符串的开始,endp为指向要分析的字符串末尾处的位置,base为要用的基数。

 



 



simple_strtoul



把一个字符串转换为一个无符号长整数



long long simple_strtoul (const char * cp, char ** endp, unsigned int base)



cp指向字符串的开始,endp为指向要分析的字符串末尾处的位置,base为要用的基数。

 



 



simple_strtoull



把一个字符串转换为一个无符号长长整数



long long simple_strtoull (const char * cp, char ** endp, unsigned int base)



cp指向字符串的开始,endp为指向要分析的字符串末尾处的位置,base为要用的基数。

 



 



vsnprintf



格式化一个字符串,并把它放在缓存中。



int vsnprintf (char * buf, size_t size, const char * fmt, va_list args)



buf为存放结果的缓冲区, size为缓冲区的大小,fmt为要使用的格式化字符串,args为格式化字符串的参数。



 



snprintf



格式化一个字符串,并把它放在缓存中。



int snprintf (char * buf, size_t size, const char * fmt, ... ...)



buf为存放结果的缓冲区, size为缓冲区的大小,fmt为格式化字符串,使用@…来对格式化字符串进行格式化,…为可变参数。



 



vsprintf



格式化一个字符串,并把它放在缓存中。



int vsprintf (char * buf, const char * fmt, va_list args)

 



buf为存放结果的缓冲区, size为缓冲区的大小,fmt为要使用的格式化字符串,args为格式化字符串的参数。



 



sprintf



格式化一个字符串,并把它放在缓存中。



int sprintf (char * buf, const char * fmt, ... ...)



buf为存放结果的缓冲区, size为缓冲区的大小,fmt为格式化字符串,使用@…来对格式化字符串进行格式化,…为可变参数。



 



字符串操作



strcpy



拷贝一个以NUL结束的字符串



char * strcpy (char * dest, const char * src)



dest为目的字符串的位置, src为源字符串的位置。



 



strncpy



拷贝一个定长的、以NUL结束的字符串



char * strncpy (char * dest, const char * src, size_t count)



dest为目的字符串的位置, src为源字符串的位置,count为要拷贝的最大字节数



与用户空间的strncpy不同,这个函数并不用NUL填充缓冲区,如果与源串超过count,则结果以非NUL结束



strcat



把一个以NUL结束的字符串添加到另一个串的末尾



char * strcat (char * dest, const char * src)

 



dest为要添加的字符串, src为源字符串。



 



strncat



把一个定长的、以NUL结束的字符串添加到另一个串的末尾



char * strncat (char * dest, const char * src, size_t count)



dest为要添加的字符串, src为源字符串,count为要拷贝的最大字节数



注意,与strncpy,形成对照,strncat正常结束。



strchr



在一个字符串中查找第一次出现的某个字符



char * strchr (const char * s, int c)



s为被搜索的字符串,c为待搜索的字符。



 



strrchr



在一个字符串中查找最后一次出现的某个字符



char * strrchr (const char * s, int c)



s为被搜索的字符串,c为待搜索的字符。



 



strlen



给出一个字符串的长度



size_t strlen (const char * s)



s为给定的字符串



 



strnlen



给出给定长度字符串的长度



size_t strnlen (const char * s, size_t count)



s为给定的字符串



 



strpbrk



在一个字符串中查找第一次出现的一组字符



char * strpbrk (const char * cs, const char * ct)



cs为被搜索的字符串,ct为待搜索的一组字符



 



strtok



把一个字符串分割为子串



char * strtok (char * s, const char * ct)

 



s为被搜索的字符串,ct为待搜索的子串



注意,一般不提倡用这个函数,而应当用strsep



memset



用给定的值填充内存区



void * memset (void * s, int c, size_t count)

 



s为指向内存区起始的指针,c为 要填充的内容,count为内存区的大小

 



I/O空间的访问不能使用memset,而应当使用memset_io。



bcopy



把内存的一个区域拷贝到另一个区域



char * bcopy (const char * src, char * dest, int count)



src为源字符串,dest为目的字符串,而count为内存区的大小



注意,这个函数的功能与memcpy相同,这是从BSD遗留下来的,对I/O空间的访问应当用memcpy_toio或memcpy_fromio

 



memcpy



把内存的一个区域拷贝到另一个区域



void * memcpy (void * dest, const void * src, size_t count)



dest为目的字符串,Src为源字符串,而count为内存区的大小



对I/O空间的访问应当用memcpy_toio或memcpy_fromio

 



memmove



把内存的一个区域拷贝到另一个区域



void * memmove (void * dest, const void * src, size_t count)



dest为目的字符串,Src为源字符串,而count为内存区的大小



memcpy和memmove处理重叠的区域,而该函数不处理。



memcmp



比较内存的两个区域



int memcmp (const void * cs, const void * ct, size_t count)



cs为一个内存区,ct为另一个内存区,而count为内存区的大小



 



memscan



在一个内存区中查找一个字符



void * memscan (void * addr, int c, size_t size)



addr为内存区,c为要搜索的字符,而size为内存区的大小



返回c第一次出现的地址,如果没有找到c,则向该内存区传递一个字节。



strstr



在以NUL结束的串中查找第一个出现的子串



char * strstr (const char * s1, const char * s2)



s1为被搜索的串,s2为待搜索的串。

 



 



memchr



在一个内存区中查找一个字符



void * memchr (const void * s, int c, size_t n)



s为内存区,为待搜索的字符,n为内存的大小



返回c第一次出现的位置,如果没有找到c,则返回空。



位操作



set_bit



在位图中原子地设置某一位



void set_bit (int nr, volatile void * addr)



nr为要设置的位,addr为位图的起始地址



这个函数是原子操作,如果不需要原子操作,则调用__set_bit函数,nr可以任意大,位图的大小不限于一个字。



__set_bit



在位图中设置某一位



void __set_bit (int nr, volatile void * addr)



nr为要设置的位,addr为位图的起始地址



 



clear_bit



在位图中清某一位



void clear_bit (int nr, volatile void * addr)



nr为要清的位,addr为位图的起始地址



该函数是原子操作,但不具有加锁功能,如果要用于加锁目的,应当调用smp_mb__before_clear_bit或smp_mb__after_clear_bit函数,以确保任何改变在其他的处理器上是可见的。



__change_bit



在位图中改变某一位



void __change_bit (int nr, volatile void * addr)



nr为要设置的位,addr为位图的起始地址。



与change_bit不同,该函数是非原子操作。



change_bit



在位图中改变某一位



void change_bit (int nr, volatile void * addr)



nr为要设置的位,addr为位图的起始地址。



 



test_and_set_bit



设置某一位并返回该位原来的值



int test_and_set_bit (int nr, volatile void * addr)



nr为要设置的位,addr为位图的起始地址。



该函数是原子操作



 __test_and_set_bit



设置某一位并返回该位原来的值



 

int __test_and_set_bit (int nr, volatile void * addr)

 



nr为要设置的位,addr为位图的起始地址。



该函数是非原子操作,如果这个操作的两个实例发生竞争,则一个成功而另一个失败,因此应当用一个锁来保护对某一位的多个访问。

 



 test_and_clear_bit

 



清某一位,并返回原来的值



int test_and_clear_bit (int nr, volatile void * addr);



nr为要设置的位,addr为位图的起始地址。



该函数是原子操作



__test_and_clear_bit

 



清某一位,并返回原来的值



int __test_and_clear_bit (int nr, volatile void * addr);



nr为要设置的位,addr为位图的起始地址。



该函数为非原子操作



test_and_change_bit



改变某一位并返回该位的新值



int test_and_change_bit (int nr, volatile void * addr)



nr为要设置的位,addr为位图的起始地址。



该函数为原子操作



test_bit



确定某位是否被设置



int test_bit (int nr, const volatile void * addr)



nr为要测试的第几位,addr为位图的起始地址。



 



 find_first_zero_bit



在内存区中查找第一个值为0的位



int find_first_zero_bit (void * addr, unsigned size)



addr为内存区的起始地址,size为要查找的最大长度



返回第一个位为0的位号



find_next_zero_bit



在内存区中查找第一个值为0的位



int find_next_zero_bit (void * addr, int size, int offset)



addr为内存区的起始地址,size为要查找的最大长度,offset开始搜索的起始位号。



 



ffz



在字中查找第一个0



unsigned long ffz (unsigned long word);



word为要搜索的字。



 



ffs



查找第一个已设置的位



 

int ffs (int x)

 



x为要搜索的字。



这个函数的定义方式与Libc中的一样。



hweight32



返回一个N位字的加权平衡值



 

hweight32 ( x)

 



x为要加权的字



一个数的加权平衡是这个数所有位的总和。



 


【作者】​​张昺华​