_sntprintf

来源:互联网 发布:java扑克牌发牌程序 编辑:程序博客网 时间:2024/06/04 19:10


_sntprintf是snprintf的ANSI和UNICODE通用定义,

原型:int snprintf(char *str, size_t size, const char *format, ...)

功能:将可变个参数(...)按照format格式化成字符串,然后将其复制到str中

(1) 如果格式化后的字符串长度 < size,则将此字符串全部复制到str中,并给其后添加一个字符串结束符('\0');
(2) 如果格式化后的字符串长度 >= size,则只将其中的(size-1)个字符复制到str中,并给其后添加一个字符串结束符('\0'),返回值为欲写入的字符串长度。
返回值:若成功则返回欲写入的字符串长度,若出错则返回负值。

说明:strcpy() sprintf() strcat() 存在安全隐患, 其对应的安全版为:strncpy() snprintf() strncat()

例1:
snprintf(s,100,"%.*S",3,"abcd");s的值为abc%.*s 表示有两项, 第一项指定了长度,第二项则是%s的内容,所以取前三位
例2:
char a[20] = {0};int i = snprintf(a, 9, "%012d", 12345);printf("i = %d, a = %s", i, a);输出为:i = 12, a = 00000001

例3:
#include<stdio.h>#include<stdlib.h>int main(){   char str[10]={0};  int nLen=snprintf(str,sizeof(str),"0123456789012345678");  printf("str=%s\n",str);  printf("nLen=%d\n",nLen);  return0;} 运行结果:str=012345678nLen=19



其他函数说明:

_snprintf、_snprintf_l、_snwprintf、_snwprintf_l

<strong>int _snprintf(   char *buffer,   size_t count,   const char *format [,   argument] ... );int _snprintf_l(   char *buffer,   size_t count,   const char *format,   locale_t locale [,   argument] ... );int _snwprintf(   wchar_t *buffer,   size_t count,   const wchar_t *format [,   argument] ... );int _snwprintf_l(   wchar_t *buffer,   size_t count,   const wchar_t *format,   locale_t locale [,   argument] ... );template <size_t size>int _snprintf(   char (&buffer)[size],   size_t count,   const char *format [,   argument] ... ); // C++ onlytemplate <size_t size>int _snprintf_l(   char (&buffer)[size],   size_t count,   const char *format,   locale_t locale [,   argument] ... ); // C++ onlytemplate <size_t size>int _snwprintf(   wchar_t (&buffer)[size],   size_t count,   const wchar_t *format [,   argument] ... ); // C++ onlytemplate <size_t size>int _snwprintf_l(   wchar_t (&buffer)[size],   size_t count,   const wchar_t *format,   locale_t locale [,   argument] ... ); // C++ only</strong>
参数

buffer

输出的存储位置。

count

可存储的最多字符数。

format

窗体控件字符串。

argument

可选参数。

locale

要使用的区域设置。


返回值

len 设为格式化数据字符串的长度,不包括终止 null。对于 _snprintflencount 以字节为单位,而对于 _snwprintf 则以宽字符为单位。

如果 len < countlen 个字符将存储在 buffer 中,附加 null 终止符,并返回len

如果 len = countlen 个字符将存储在 buffer 中,不附加 null 终止符,并返回len

如果 len > countcount 个字符将存储在 buffer 中,不附加 null 终止符,并返回负值。

如果 buffer 为 null 指针,并且count 为零,len 将返回为设置输出格式所需的字符数,不包括终止 null。若要使用相同的 argumentlocale 参数进行成功调用,请分配至少容纳 len + 1 个字符的缓冲区。

如果 buffer 为 null 指针并且count 不为零,或者 format 为 null 指针,则调用无效参数处理程序,如参数验证中所述。如果允许继续执行,则这些函数返回 -1 并将 errno 设置为EINVAL

有关这些和其他错误代码的信息,请参阅 errno、_doserrno、_sys_errlist 和 _sys_nerr





0 0
原创粉丝点击