跳转到内容

string.h

本页使用了标题或全文手工转换
维基百科,自由的百科全书
(重定向自Strlcpy

string.hC标准库的一個头文件,其中包含了(巨集)定义、常量以及函数和类型的声明,涉及的内容除了字符串处理之外,还包括大量的内存处理函数;因此,string.h这个命名是不恰当的。

string.h中定义的函数十分常用,作为C标准库的一部分,它们被强制要求可以在任何支持C语言的平台上运行。但是,部分函数存在一些安全隐患,例如缓存溢出等,导致程序员宁愿使用一些更安全的函数而放弃一定的可移植性。同时,这些字符串函数只能处理ASCII字符集或兼容ASCII的字符集,如ISO-8859-1;在处理存在多字节字符的字符集,如UTF-8时,会产生一个警告,指出对字符串“长度”的计算是以字节而不是以Unicode字符为单位。非ASCII兼容字符集的字符串处理函数一般位于wchar.h中。

常量和类型

[编辑]
名称 说明
NULL 表示空指针常量的宏,即表示一个指向任何有效内存单元地址的指针常量。
size_t 无符号整型,被用于sizeof运算符的返回值类型。

函数

[编辑]
名称 说明
void *memcpy(void *dest, const void *src, size_t n); 将n字节长的内容从一个内存地址复制到另一个地址;如果两个地址存在重叠,则最终行为未定义
void *memmove(void *dest, const void *src, size_t n); 将n字节长的内容从一个内存地址复制到另一个地址;与memcpy不同的是它可以正确作用于两个存在重叠的地址
void *memchr(const void *s, char c, size_t n); 在从s开始的n个字节内查找c第一次出现的地址并返回,若未找到则返回NULL
int memcmp(const void *s1, const void *s2, size_t n); 对从两个内存地址开始的n个字符进行比较
void *memset(void *, int, size_t); 用某种字节内容覆写一段内存空间
char *strcat(char *dest, const char *src); 在字符串dest之后连接上src
char *strncat(char *dest, const char *src, size_t n); 从src截取n个字符连接在字符串dest之后,返回dest字符串
char *strchr(const char* str, int ch); 从字符串str头开始查找字符ch首次出现的位置
char *strrchr(const char* str,int ch); 从字符串str尾开始查找字符ch首次出现的位置
int strcmp(const char *, const char *); 基于字典顺序比较两个字符串
int strncmp(const char *, const char *, size_t n); 基于字典顺序比较两个字符串,最多比较n个字节
int strcoll(const char *, const char *); 基于当前区域设置字符顺序英语collating order比较两个字符串
char *strcpy(char* str1, const char* str2); 将str2拷贝给str1
char *strncpy(char* str1, const char* str2, size_t n); 截取str2的n个字符拷贝给str1
char *strerror(int); 返回错误码对应的解释字符串,参见errno.h(非线程安全函数)
size_t strlen(const char *); 返回一个字符串的长度
size_t strspn(const char *s, const char *strCharSet); 从字符串s的起始处开始,寻找第一个出现在strCharSet中的字符,返回其位置索引值。换句话说,返回从字符串s的起始位置的完全由strCharSet中的字符构成的子串的最大长度。strspn为string span的缩写。不支持多字节字符集。
size_t strcspn(const char *s, const char *strCharSet); 从字符串s的起始处开始,寻找第一个出现在strCharSet中的字符,返回其位置索引值。换句话说,返回从字符串s的起始位置的完全由不属于strCharSet中的字符构成的子串的最大长度。strcspn为string complement span的缩写。不支持多字节字符集。
char *strpbrk(const char *s, const char *breakset); 在字符串s中查找breakset中任意字符第一次出现的位置的指针值。strpbrk为string pointer break缩写。通常,breakset是分隔符的集合。不支持多字节字符集。
char *strstr(const char *haystack, const char *needle); 在字符串haystack中查找字符串needle第一次出现的位置,heystack的长度必须长于needle
char *strtok(char *strToken, const char *strDelimit ); 将一个字符串strToken依据分界符(delimiter)分隔成一系列字串。此函数非线程安全,且不可重入;但MSVC实现时使用了thread-local static variable因而是线程安全的但仍然是不可重入,即在单线程中不能对两个源字符串交替调用该函数来分析token,应当对一个字符串分析完成后再处理别的字符串。
size_t strxfrm(char *dest, const char *src, size_t n); 根据当前locale转换一个字符串为strcmp使用的内部格式

ISO C扩展函数

[编辑]
名称 说明 标准
void *memccpy(void *dest, const void *src, int c, size_t n

);

在两块不重叠的内存地址间复制内容,直至复制了n字节或遇到内容为c的字节 UNIX 98?
void *mempcpy(void *dest, const void *src, size_t n); memcpy的变体,返回写入的最后一个字节的地址指针 GNU
errno_t strcat_s(char *s1, size_t s1max, const char *s2); strcat的变体,带边界检查 ISO/IEC WDTR 24731
errno_t strcpy_s(char *s1, size_t s1max, const char *s2); strcpy的变体,带边界检查 ISO/IEC WDTR 24731
char *strdup(const char *); 将字符串的内容复制到一段新分配的内存空间 POSIX;源于一个BSD扩展标准
int strerror_r(int, char *, size_t); 将strerror()的结果放入一段给定的内存缓冲,此函数是线程安全的 POSIX:2001
char *strerror_r(int, char *, size_t); 使用线程安全的方式返回strerror()的结果。在必要的时候才使用给定的内存缓冲 (与POSIX中的定义不一致). GNU
size_t strlcat(char *dest, const char *src, size_t n); strcat的变体,带边界检查 首先定义于OpenBSD,现在也可以在FreeBSDSolarisMac OS X中找到
size_t strlcpy(char *dest, const char *src, size_t n); strcpy的变体,带边界检查 首先定义于OpenBSD,现在也可以在FreeBSDSolarisMac OS X中找到
char *strsignal(int sig); strerror类似,返回有符号数sig对应的错误解释字符串(非线程安全函数) BSDs, Solaris, Linux
char *strtok_r(char *, const char *, char **); strtok的线程安全且可重入的版本 POSIX

外部链接

[编辑]