snprintf()函数探讨
2012年09月06日 12:53:37
阅读数:14336
printf()/sprintf()/snprintf()区别
先贴上其函数原型
printf( const char *format, ...) 格式化输出字符串,默认输出到终端-----stdout
sprintf(char *dest, const char *format,...) 格式化输出字符串到指定的缓冲区
snprintf(char *dest, size_t size,const char *format,...) 按指定的SIZE格式化输出字符串到指定的缓冲区
printf()函数在这就不再讨论,这里主要讨论sprintf()与snprintf()的用法及区别,
-
#include "stdafx.h"
-
#include <stdio.h>
-
using namespace std;
-
int _tmain(int argc, _TCHAR* argv[])
-
{
-
char *p1="China";
-
char a[20];
-
sprintf(a,"%s",p1);
-
printf("%s\n",a);
-
memset(a,0,sizeof(a));
-
_snprintf(a,3,"%s",p1);
-
printf("%s\n",a);
-
printf("%d\n",strlen(a));
-
return 0;
-
}
结果输出:
China
Chi
3
分析:
sprintf(a,"%s",p1) 把p1字符串拷贝到数组a中('\0'也拷贝过去了)。
snprintf(a,3,"%s",p1) 拷贝P1中前3个字符到数组a中,并在末尾自动添加'\0'。
sprintf属于I/O库函数,snprintf函数并不是标准c/c++中规定的函数,但是在许多编译器中,厂商提供了其实现的版本。在gcc中,该函数名称就snprintf,而在VC中称为_snprintf。 如果你在VC中使用snprintf(),会提示此函数未声明,改成_snprintf()即可。
注意点:
1 sprintf是一个不安全函数,src串的长度应该小于dest缓冲区的大小,(如果src串的长度大于或等于dest缓冲区的大小,将会出现内存溢出。)
2 snprintf中源串长度应该小于目标dest缓冲区的大小,且size等于目标dest缓冲区的大小。(如果源串长度大于或等于目标dest缓冲区的大小,且size等于目标dest缓冲区的大小,则只会拷贝目标dest缓冲区的大小减1个字符,后加'\0';该情况下,如果size大于目标dest缓冲区的大小则溢出。)
3 snprintf ()函数返回值问题, 如果输出因为size的限制而被截断,返回值将是“如果有足够空间存储,所应能输出的字符数(不包括字符串结尾的'\0')”,这个值和size相等或者比size大!也就是说,如果可以写入的字符串是"0123456789ABCDEF"共16位,但是size限制了是10,这样 snprintf() 的返回值将会是16 而不是10!
snprintf()函数用于将格式化的数据写入字符串,其原型为:
int snprintf(char *str, int n, char * format [, argument, ...]);
【参数】str为要写入的字符串;n为要写入的字符的最大数目,超过n会被截断;format为格式化字符串,与printf()函数相同;argument为变量。
【返回值】成功则返回参数str 字符串长度,失败则返回-1,错误原因存于errno 中。
snprintf()可以认为是sprintf()的升级版,比sprintf()多了一个参数,能够控制要写入的字符串的长度,更加安全,只要稍加留意,不会造成缓冲区的溢出。
snprintf()与sprintf()使用方法类似,请参考:C语言sprintf()函数
注意:snprintf()并不是标C中规定的函数,但是在许多编译器中,厂商提供了其实现的版本。
在GCC中,该函数名称就snprintf(),而在VC中称为_snprintf()。由于不是标准函数,没有一个统一的标准来规定该函数的行为,所以导致了各厂商间的实现版本可能会有差异。
差异发生在参数 n。在GCC中,参数n是要向str写入3个字符,包括'\0'字符;在VC中,参数n是要写入的字符串的总字符数。
在GCC中运行如下程序:
#include <stdio.h>
int main()
{
char str[5];
int ret = snprintf(str, 3, "%s", "abcdefg");
printf("%d\n",ret);
printf("%s",str);
return 0;
}
输出:
7
ab
在VC中运行如下程序:
#include <stdio.h>
int main()
{
char str[5];
int ret = _snprintf(str,3,"%s","abcdefg");
printf("%d\n",ret);
printf("%s",str);
return 0;
}
输出:
-1
abc
从输出结果可以知道:
GCC中的参数n表示向str中写入n个字符,包括'\0'字符,并且返回实际的字符串长度。
VC中的参数n表示会向str中写入n个字符,不包括'\0'字符,并且不会在字符串末尾添加'\0'符。当字符串长度超过参数n时,函数返回-1,以表示可能导致错误