本文章描述常用的不安全函数与对应的安全函数的使用。
不安全函数原型参考菜鸟教程。
功能
发送格式化输出到 str 所指向的字符串
C 标准库
#include 函数原型
int sprintf(char *str, const char *format, ...)
参数说明
str -- 这是指向一个字符数组的指针，该数组存储了 C 字符串。
format -- 字符串，包含了要被写入到字符串 str 的文本。包含嵌入的 format 标签，format 标签可被随后的附加参数中指定的值替换，并按需求进行格式化。format 标签属性是 %[flags][width][.precision][length]specifier
返回值
如果成功，则返回写入的字符总数，不包括字符串追加在字符串末尾的空字符。如果失败，则返回一个负数。
举例
char str[100];
int len = sprintf(str, "Pi 的值 = %f", M_PI);
详见sprintf()函数。
C 标准库
#include 函数原型
int sprintf_s(char *str, size_t sizeOfBuffer, const char *format, ...)
参数说明
str -- 这是指向一个字符数组的指针，该数组存储了 C 字符串。
sizeOfBuffer -- 指定缓冲区长度来避免sprintf()存在的溢出风险。
format -- 字符串，包含了要被写入到字符串 str 的文本。包含嵌入的 format 标签，format 标签可被随后的附加参数中指定的值替换，并按需求进行格式化。format 标签属性是 %[flags][width][.precision][length]specifier
返回值
如果成功，则返回写入的字符总数，不包括字符串追加在字符串末尾的空字符。如果失败，则返回一个负数。
举例
char str[100];
int len = sprintf_s(str, sizeof(str), "Pi 的值 = %f", M_PI);
功能
从标准输入 stdin 读取格式化输入
C 标准库
#include 函数原型
int scanf(const char *format, ...)
参数说明
format -- 字符串，包含了以下各项中的一个或多个：空格字符、非空格字符和format说明符。 format说明符形式为[=%[*][width][modifiers]type=]
返回值
如果成功，该函数返回成功匹配和赋值的个数。如果到达文件末尾或发生读错误，则返回EOF
举例
int a;
char b;
char c[10];
int len = scanf("%d %c %s",&a, &b, &c);;
详见scanf()函数。
C 标准库
#include 函数原型
int scanf_s( const char *format [, argument]...)
参数说明
format -- 字符串，包含了以下各项中的一个或多个：空格字符、非空格字符和format说明符。 format 说明符形式为[=%[*][width][modifiers]type=]
返回值
如果成功，该函数返回成功匹配和赋值的个数。如果到达文件末尾或发生读错误，则返回EOF
举例
int a;
char b;
char c[10];
int len = scanf_s("%d %c %s",&a, &b, 1, &c, sizeof(c)); // c最多可以存放9个字符，因为c[10]要放'\0'
功能
将指定的值 c 复制到 str 所指向的内存区域的前 n 个字节中，这可以用于将内存块清零或设置为特定值
C 标准库
#include 函数原型
void *memset(void *dest, int c, size_t n)
参数说明
dest-- 指向要填充的内存区域的指针。
c -- 要设置的值，通常是一个无符号字符。
n -- 要被设置为该值的字节数。
返回值
该值返回一个指向存储区dest的指针
举例
char buffer[10];
// 将 buffer 数组的前5个字节设置为字符 'A'
memset(buffer, 'A', 5);
详见memset()函数。
C 标准库
#include 函数原型
errno_t memset_s（void * dest, size_t destSize, int c, size_t n）
参数说明
dest -- 指向要填充的内存区域的指针。
destSize -- 目标数组的大小
c -- 要设置的值，通常是一个无符号字符。
n -- 要被设置为该值的字节数。
返回值
1) dest的副本，本质为更底层操作的临时内存地址，在实际操作中不建议直接使用此地址，操作完成以后，真正有意义的地址是dest本身。
2) 成功时为零，失败时为非零。在失败时，若 dest 不是空指针且 destSize 合法，则亦写入 destSize 个填充字节 c 到目标数组。
举例
char buffer[10];
// 将 buffer 数组的前5个字节设置为字符 'A'
memset(buffer, sizeof(buffer), 'A', 5);
功能
从存储区 str2 复制 n 个字节到存储区 str1
C 标准库
#include 函数原型
void *memcpy(void *str1, const void *str2, size_t n)
参数说明
str1 -- 指向用于存储复制内容的目标数组，类型强制转换为 void* 指针。
str2 -- 指向要复制的数据源，类型强制转换为 void* 指针。
n -- 要被复制的字节数。
返回值
该函数返回一个指向目标存储区 str1 的指针。
举例
const char src[50] = "http://www.baidu.com";
char dest[50];
memcpy(dest, src, strlen(src)+1);
详见memcpy()函数。
C 标准库
#include 函数原型
errno_t memcpy_s(void *dest, size_t destSize, const void *src, size_t count);
参数说明
dest：目标数组，或者说目标内存区域
destSize：目标内存区域的大小，其单位是字节
src：源数组，或者说源内存区域
count：要复制的源内存区域元素的个数，其单位是字节
返回值
返回一个整数，0表示复制成功，返回非0值代表复制不成功，不同的值表示不同的错误
举例
const char src[50] = "http://www.baidu.com";
char dest[50];
memcpy(dest, sizeof(dest), src, strlen(src)+1);
功能
把 src 所指向的字符串复制到 dest
C 标准库
#include 函数原型
char *strcpy(char *dest, const char *src)
参数说明
dest -- 指向用于存储复制内容的目标数组。
src -- 要复制的字符串。
返回值
该函数返回一个指向最终的目标字符串 dest 的指针。
举例
char src[50] = "http://www.baidu.com";
char dest[50];
strcpy(dest, src);
详见strcpy()函数。
C 标准库
#include 函数原型
errno_t strcpy_s(char *dest, size_t destSize, const char *src);
参数说明
dest：拷贝完成之后的字符串
destSize：dest目标缓冲区长度
src：需要拷贝的字符串
返回值
返回一个整数，0表示复制成功，返回非0值代表复制不成功，不同的值表示不同的错误
举例
const char src[50] = "http://www.baidu.com";
char dest[50];
strcpy_s(dest, sizeof(dest), src);
功能
把 src 所指向的字符串复制到 dest，最多复制 n 个字符。
当 src 的长度小于 n 时，dest 的剩余部分将用空字节填充。
C 标准库
#include 函数原型
char *strncpy(char *dest, const char *src, size_t n)
参数说明
dest -- 指向用于存储复制内容的目标数组。
src -- 要复制的字符串。
n -- 要从源中复制的字符数
返回值
该函数返回最终复制的字符串。
举例
char src[50] = "http://www.baidu.com";
char dest[50];
strncpy(dest, src, strlen(src) + 1);
详见strncpy()函数。
C 标准库
#include 函数原型
errno_t strncpy_s(char *dest, size_t destSize, const char *src, size_t n);
参数说明
dest -- 指向用于存储复制内容的目标数组。
destSize -- dest目标缓冲区长度
src -- 要复制的字符串。
n -- 要从源中复制的字符数
返回值
在成功时返回零，错误时返回非零值。
举例
const char src[50] = "http://www.baidu.com";
char dest[50];
strncpy_s(dest, sizeof(dest), src, strlen(src) + 1);
功能
把 src 所指向的字符串追加到 dest 所指向的字符串的结尾
C 标准库
#include 函数原型
char *strcat(char *dest, const char *src)
参数说明
dest -- 指向目标数组，该数组包含了一个 C 字符串，且足够容纳追加后的字符串。
src -- 指向要追加的字符串，该字符串不会覆盖目标字符串。
返回值
该函数返回一个指向最终的目标字符串 dest 的指针。
举例
char src[50] = "http://www.baidu.com";
char dest[100] = "baidu: ";
strcat(dest, src);
详见strcat()函数。
C 标准库
#include 函数原型
errno_t strcat_s(char *dest, size_t destSize, const char *src);
参数说明
dest -- 目标字符串
destSize -- dest目标缓冲区长度, 拼接后的字符串大小（并非目标字符串大小也并非原始字符串大小）
src -- 需要追加的字符串
返回值
在成功时返回零，错误时返回非零值。
举例
char src[50] = "http://www.baidu.com";
char dest[100] = "baidu: ";
strcat_s(dest, sizeof(dest), src);
功能
分解字符串 str 为一组字符串，delim 为分隔符
C 标准库
#include 函数原型
char *strtok(char *str, const char *delim)
参数说明
str -- 要被分解成一组小字符串的字符串。
delim -- 包含分隔符的 C 字符串。
返回值
该函数返回被分解的第一个子字符串，如果没有可检索的字符串，则返回一个空指针。
举例
char str[50] = "This is http://www.baidu.com";
char delim[2] = " ";
char *token;
/* 获取第一个子字符串 */
token = strtok(str, delim);
/* 继续获取其他的子字符串 */
while (token != NULL) {
printf( "%s\n", token );
token = strtok(NULL, delim);
}
详见strtok()函数。
C 标准库
#include 函数原型
char * strtok_s(char *dest, size_t *strmax, const char *delim, char **ptr);
参数说明
str -- 要被分解成一组小字符串的字符串。
strmax -- 指向最初保存str大小的对象的指针：strtok_s存储待检查的字符数。
delim -- 包含分隔符的 C 字符串。
ptr -- 指向char *类型的对象的指针，strtok_s用它来存储它的内部状态
返回值
返回指向下一个标记开头的指针，如果没有其他标记，则返回NULL
举例
char str[50] = "This is http://www.baidu.com";
char delim[2] = " ";
size_t strmax = sizeof(str);
char *next_token;
token = strtok_s(str, &strmax, delim, &next_token);
while (token != NULL) {
printf( "%s\n", token);
token = strtok_s(NULL, &strmax, delim, &next_token);
}
功能
把 str1 所指向的字符串和 str2 所指向的字符串进行比较
C 标准库
#include 函数原型
int strcmp(const char *str1, const char *str2)
参数说明
str1 -- 要进行比较的第一个字符串。
str2 -- 要进行比较的第二个字符串。
返回值
如果返回值小于 0，则表示 str1 小于 str2。
如果返回值大于 0，则表示 str1 大于 str2。
如果返回值等于 0，则表示 str1 等于 str2。
举例
char str1[15] = "abcdef";
char str2[15] = "ABCDEF";
ret = strcmp(str1, str2);
if(ret < 0)
{
printf("str1 小于 str2");
}
else if(ret > 0)
{
printf("str1 大于 str2");
}
else
{
printf("str1 等于 str2");
}
详见strcmp()函数。
功能
在字符串 haystack 中查找第一次出现字符串 needle 的位置，不包含终止符 '\0'。
C 标准库
#include 函数原型
char *strstr(const char *haystack, const char *needle)
参数说明
haystack -- 要被检索的 C 字符串。
needle -- 在 haystack 字符串内要搜索的小字符串。
返回值
该函数返回在 haystack 中第一次出现 needle 字符串的位置，如果未找到则返回 null。
举例
char haystack[50] = "http://www.baidu.com";
char needle[10] = "baidu";
strstr(haystack, needle);
详见strstr()函数。
内存拷贝函数：memcpy(), wmemcpy(), memmove(), wmemmove()
内存初始化函数：memset()
字符串拷贝函数：strcpy(), wcscpy(),strncpy(), wcsncpy()
字符串拼接函数：strcat(), wcscat(),strncat(), wcsncat()
字符串格式化输出函数：sprintf(), swprintf(), vsprintf(), vswprintf(), snprintf(), vsnprintf()
字符串格式化输入函数：scanf(), wscanf(), vscanf(), vwscanf(), fscanf(), fwscanf(),vfscanf(),vfwscanf(),sscanf(), swscanf(), vsscanf(), vswscanf()
stdin流输入函数：gets()