基本C库函数
当编写驱动程序时,一般情况下不能使用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为要加权的字 |
一个数的加权平衡是这个数所有位的总和。 |