snprintf()函数探讨printf()/sprintf()/snprintf()区别

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()的用法及区别，

1. #include "stdafx.h"

2. #include <stdio.h>

3. using namespace std;

4. int _tmain(int argc, _TCHAR* argv[])

5. {

6. char *p1="China";

7. char a[20];

8. sprintf(a,"%s",p1);

9. printf("%s\n",a);

10. memset(a,0,sizeof(a));

11. _snprintf(a,3,"%s",p1);

12. printf("%s\n",a);

13. printf("%d\n",strlen(a));

14. return 0;

15. }

结果输出：
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，以表示可能导致错误