C语言标准库<string.h>
简介
<string.h>头文件定义了一个变量类型和一个宏和各种操作字符数组的函数。
变量类型
下面是这个库中定义的唯一的一个变量类型：
| 变量类型 | 描述 |
|---|---|
| size_t | 这是无符号整数类型，它是sizeof关键字的结果。 |
宏
下面是这个库中定义的唯一的一个宏：
| 宏名 | 值 | 描述 |
|---|---|---|
| NULL | ((void*)0) | 是一个空指针常量的值。 |
函数
下面是这个库中定义的函数：
| 函数原型 | 描述 |
|---|---|
| void *memchr(const void *str,int c,size_t n) |
在参数str所指向的字符串的前n个字节中搜索第一次出现字符c的位置。 参数str是指向要执行搜索的内存块。 参数c是以int形式传递的值，但是函数在每次字节搜索时是使用该值的无符号字符形式。 参数n是要被分析的字节数。 返回值是一个指向匹配字节的指针，如果在给定的内存区域未出现字符，则返回NULL。 |
| int memcmp(const void *str1,const void *str2,size_t n) | 把str1和str2的前n个字节进行比较。 参数str1是指向内存块的指针。 参数str2是指向内存块的指针。 参数n是要被比较的字节数。 str1小于str2，返回值<0。 str1大于str2，返回值>0。 str1等于str2，返回值=0。 |
| void *memcpy(void *str1,const void *str2,size_t n) | 从str2复制n个字符到str1。 参数str1是指向用于存储复制内容的目标数组，类型强制转换为void*指针。 参数str2是指向要复制的数据源，类型强制转换为void*指针。 参数n是要被复制的字节数。 返回值是一个指向目标存储区str1的指针。 |
| void *memmove(void *str1,const void *str2,size_t n) | 另一个用于从str2复制 n 个字符到str1的函数。参数str1是指向用于存储复制内容的目标数组，类型强制转换为void*指针。 参数str2是指向要复制的数据源，类型强制转换为void*指针。 参数n是要被复制的字节数。 返回值是一个指向目标存储区str1的指针。 |
| void *memset(void *str,int c,size_t n) | 复制字符c到参数str所指向的字符串的前n个字符。 参数str是指向要填充的内存块。 参数c是要被设置的值。该值以 int 形式传递，但是函数在填充内存块时是使用该值的无符号字符形式。 参数n是要被设置为该值的字符数。 返回值是一个指向存储区str的指针。 |
| char *strcat(char *str1,const char *str2) | 把str2所指向的字符串追加到str1所指向的字符串的结尾。 参数str2是指向目标数组，该数组包含了一个字符串，且足够容纳追加后的字符串，包括额外的空字符。 参数str1是指向要追加的字符串，该字符串不会覆盖目标字符串。 返回值是一个指向最终的目标字符串str1的指针。 |
| char *strncat(char *dest,const char *src,size_t n) | 把str2所指向的字符串追加到str1所指向的字符串的结尾，直到n字符长度为止。 参数str1是指向目标数组，该数组包含了一个字符串，且足够容纳追加后的字符串，包括额外的空字符。 参数str2是要追加的字符串。 参数n是要追加的最大字符数。 返回值是一个指向最终的目标字符串str1的指针。 |
| char *strchr(const char *str,int c) | 在参数str所指向的字符串中搜索第一次出现字符c的位置。 参数str是要被检索的字符串。 参数c是在str中要搜索的字符。 返回值在字符串str中第一次出现字符c的位置，如果未找到该字符则返回NULL。 |
| int strcmp(const char *str1,const char *str2) | 把str1所指向的字符串和str2所指向的字符串进行比较。 参数str1是要进行比较的第一个字符串。 参数str2是要进行比较的第二个字符串。 str1小于str2，返回值<0。 str1大于str2，返回值>0。 str1等于str2，返回值=0。 |
| int strncmp(const char *str1,const char *str2,size_t n) | 把str1和str2进行比较，最多比较前n个字节。 参数str1是要进行比较的第一个字符串。 参数str2是要进行比较的第二个字符串。 参数n是要比较的最大字符数。 str1小于str2，返回值<0。 str1大于str2，返回值>0。 str1等于str2，返回值=0。 |
| int strcoll(const char *str1,const char *str2) | 把str1和str2进行比较，结果取决于LC_COLLATE的位置设置。 参数str1是要进行比较的第一个字符串。 参数str2是要进行比较的第二个字符串。 str1小于str2，返回值<0。 str1大于str2，返回值>0。 str1等于str2，返回值=0。 |
| char *strcpy(char *str1,const char *str2) | 把str2所指向的字符串复制到str1。 参数str1是指向用于存储复制内容的目标数组。 参数str2是要复制的字符串。 返回值是一个指向最终的目标字符串str1的指针。 |
| char *strncpy(char *str1,const char *str2,size_t n) | 把str2所指向的字符串复制到str1，最多复制 n 个字符。 参数dest是指向用于存储复制内容的目标数组。 参数src是要复制的字符串。 参数n是要从源中复制的字符数。 返回值是一个最终复制的字符串。 |
| size_t strcspn(const char *str1,const char *str2) | 检索字符串str1开头连续有几个字符都不含字符串str2中的字符。 参数str1是要被检索的字符串。 参数str2是该字符串包含了要在str1中进行匹配的字符列表。 返回值是str1开头连续都不含字符串str2中字符的字符数。 |
| char *strerror(int errnum) | 从内部数组中搜索错误号errnum，并返回一个指向错误消息字符串的指针。参数errnum是错误号。 返回值是一个指向错误字符串的指针，该错误字符串描述了错误errnum。 |
| size_t strlen(const char *str) | 计算字符串str的长度，直到空结束字符，但不包括空结束字符。 参数str是要计算长度的字符串。 返回值是字符串的长度。 |
| char *strpbrk(const char *str1,const char *str2) | 检索字符串str1中第一个匹配字符串str2中字符的字符，不包含空结束字符。也就是说，依次检验字符串str1中的字符，当被检验字符在字符串str2中也包含时，则停止检验，并返回该字符位置。 参数str1是要被检索的字符串。 参数str2是该字符串包含了要在str1中进行匹配的字符列表。 返回值是str1中第一个匹配字符串str2中字符的字符数，如果未找到字符则返回NULL。 |
| char *strrchr(const char *str, int c) | 在参数str所指向的字符串中搜索最后一次出现字符c的位置。 参数str是字符串。 参数c是要搜索的字符。以int形式传递，但是最终会转换回char形式。 |
| size_t strspn(const char *str1,const char *str2) | 检索字符串str1中第一个不在字符串str2中出现的字符下标。 参数str1是要被检索的 C 字符串。 参数str2是该字符串包含了要在 str1 中进行匹配的字符列表。 返回值是str1中第一个不在字符串str2中出现的字符下标。 |
| char *strstr(const char *str1,const char *str2) | 在字符串str1中查找第一次出现字符串str2的位置。 参数str1是要被检索的字符串。 参数str2是在str1字符串内要搜索的小字符串。 返回在str1中第一次出现str2字符串的位置，如果未找到则返回NULL。 |
| char *strtok(char *str,const char *c) | 分解字符串str为一组字符串，c为分隔符。 参数str是要被分解成一组小字符串的字符串。 参数c包含分隔符的字符串。 返回值是被分解的第一个子字符串，如果没有可检索的字符串，则返回一个空指针。 |
| size_t strxfrm(char *str1,const char *str2,size_t n) | 根据程序当前的区域选项中的LC_COLLATE来转换字符串str2的前n个字符，并把它们放置在字符串str1中。 参数str1是指向存储内容的目标数组的指针，如果参数n为 0，则它是一个空指针。 参数str2是要被转换为当前区域设置的字符串。 参数n被复制到str1的最大字符数。 返回值是被转换字符串的长度，不包括空结束字符。 |