sprintf函数的⽤法详解
功能
把格式化的数据写⼊某个字符串缓冲区。
头⽂件
stdio.h
原型
int sprintf( char *buffer, const char *format, [ argument] … );
参数列表
buffer:char型指针,指向将要写⼊的字符串的缓冲区。
format:格式化字符串。
[argument]...:可选参数,可以是任何类型的数据。
返回值:字符串长度(strlen)
1int sprintf_s(char *buffer,size_t sizeOfBuffer,const char *format, [argument] ... );
2int _sprintf_s_l(char *buffer,size_t sizeOfBuffer,const char *format,locale_t locale ,[argument] ... );
3int swprintf_s(wchar_t *buffer,size_t sizeOfBuffer,const wchar_t *format ,[argument]...);
4int _swprintf_s_l(wchar_t *buffer,size_t sizeOfBuffer,const wchar_t *format,locale_t locale ,[argument]…);
5 template <size_t size>
6int sprintf_s(char (&buffer)[size],const char *format, [argument] ... ); //仅存在于C++
7 template <size_t size>
8int swprintf_s(wchar_t (&buffer)[size],const wchar_t *format ,[argument]...); //仅存在于C++
2.说明及应⽤
1./*例⼦*/
1 #include<stdio.h>/*某个stdio.h*/
2
3int main()/*主函数“整数”类型*/
4 {
5 char buffer[50];/*“字符”类型的数组,下⾯共有50个元素。*/
6 int n,a=5,b=3;/*三个变量都为“整数”类型,intn中间要有空格*/
7 n=sprintf(buffer,"%d plus %d is %d",a,b,a+b);/*赋予数值*/
8 printf("[%s]is a string %d chars long\n",buffer,n);/*“格式输出函数”*/
9return 0;/*“返回零”
10也就是程序正常退出*/
11 }
输出结果:
[5 plus 3 is 8] is a string 13 chars long
sprintf格式的规格如下所⽰。[]中的部分是可选的。
%[指定参数][标识符][宽度][.精度]指⽰符
若想输出'%'本⾝时, 请使⽤'%%'处理。
1. 处理字符⽅向。负号时表⽰从后向前处理。
2. 填空字元。 0 的话表⽰空格填 0;空格是内定值,表⽰空格就放着。
3. 字符总宽度。为最⼩宽度。
4. 精确度。指在⼩数点后的浮点数位数。
2.转换字符
%% 印出百分⽐符号,不转换。
%c 整数转成对应的 ASCII 字元。
%d 整数转成⼗进位。
%f 倍精确度数字转成浮点数。
%o 整数转成⼋进位。
%s 整数转成字符串。
%x 整数转成⼩写⼗六进位。
%X 整数转成⼤写⼗六进位。
$money = 123.1
$formatted = sprintf ("%06.2f", $money); // 此时变数 $ formatted 值为 "123.10"
$formatted = sprintf ("%08.2f", $money); // 此时变数 $ formatted 值为 "00123.10"
$formatted = sprintf ("%-08.2f", $money); // 此时变数 $ formatted 值为 "123.1000"
$formatted = sprintf ("%.2f%%", 0.95 * 100); // 格式化为百分⽐
%08.2f 解释:
%开始符
0是 "填空字元" 表⽰,如果长度不⾜时就⽤0来填满。
8格式化后总长度
2f⼩数位长度,即2位
第3⾏值为"00123.10" 解释:
因为2f是(2位)+⼩数点符号(1位)+前⾯123(3位)=6位,总长度为8位,故前⾯⽤[填空字元]0表⽰,即00123.10
第4⾏值为"123.1000" 解释:
-号为反向操作,然后填空字元0添加在最后⾯了
在将各种类型的数据构造成字符串时,sprintf 的强⼤功能很少会让你失望。由于sprintf 跟printf 在⽤法上⼏乎⼀样,只是打印的⽬的地不同⽽已,前者打印到字
符串中,后者则直接在命令⾏上输出。这也导致sprintf ⽐printf 有⽤得多。
sprintf 是个变参函数,定义如下:
int sprintf( char *buffer, const char *format [, argument] ... );
除了前两个参数类型固定外,后⾯可以接任意多个参数。⽽它的精华,显然就在第⼆个参数:
格式化字符串上。
printf 和sprintf 都使⽤格式化字符串来指定串的格式,在格式串内部使⽤⼀些以“%”开头的格式说明符(format specifications)来占据⼀个位置,在后边的变参列表中提供相应的变量,最终函数就会⽤相应位置的变量来替代那个说明符,产⽣⼀个调⽤者想要的字符串。
3.格式化数字字符串
sprintf 最常见的应⽤之⼀莫过于把整数打印到字符串中,所以,sprintf 在⼤多数场合可以替代
itoa。
如:
//把整数123 打印成⼀个字符串保存在s 中。
sprintf(s, "%d", 123); //产⽣"123"
可以指定宽度,不⾜的左边补空格:
sprintf(s, "%4d%4d", 123, 4567); //产⽣:" 1234567"
当然也可以左对齐:
sprintf(s, "%-4d%4d", 123, 4567); //产⽣:"123 4567"
也可以按照16 进制打印:
sprintf(s, "%8x", 4567); //⼩写16 进制,宽度占8 个位置,右对齐
sprintf(s, "%-8X", 4568); //⼤写16 进制,宽度占8 个位置,左对齐
这样,⼀个整数的16 进制字符串就很容易得到,但我们在打印16 进制内容时,通常想要⼀种左边补0 的等宽格式,那该怎么做呢?很简单,在表⽰宽度的数字前⾯加个0 就可以了。
sprintf(s, "%08X", 4567); //产⽣:"000011D7"
上⾯以”%d”进⾏的10 进制打印同样也可以使⽤这种左边补0 的⽅式。
这⾥要注意⼀个符号扩展的问题:⽐如,假如我们想打印短整数(short)-1 的内存16 进制表⽰形式,在Win32 平台上,⼀个short 型占2 个字节,所以我们⾃然希望⽤4 个16 进制数字来打印它:
short si = -1;
sprintf(s, "%04X", si);
产⽣“FFFFFFFF”,怎么回事?因为sprintf 是个变参函数,除了前⾯两个参数之外,后⾯的参数都不是类型安全的,函数更没有办法仅仅通过⼀个“%X”就能得知当初函数调⽤前参数压栈时被压进来的到底是个4 字节的整数还是个2 字节的短整数,所以采取了统⼀4 字节的处理⽅式,导致参数压栈时做了符号扩展,扩展成了32 位的整数-1,打印时4 个位置不够了,就把32 位整数-1 的8 位16 进制都打印出来了。
如果你想看si 的本来⾯⽬,那么就应该让编译器做0 扩展⽽不是符号扩展(扩展时⼆进制左边补0 ⽽不是补符号位):
sprintf(s, "%04X", (unsigned short)si);
就可以了。或者:
unsigned short si = -1;
sprintf(s, "%04X", si);
sprintf 和printf 还可以按8 进制打印整数字符串,使⽤”%o”。注意8 进制和16 进制都不会打印出负数,都是⽆符号的,实际上也就是变量的内部编码的直接的16 进制或8 进制表⽰。
控制浮点数打印格式
浮点数的打印和格式控制是sprintf 的⼜⼀⼤常⽤功能,浮点数使⽤格式符”%f”控制,默认保留⼩数点后6 位数字,⽐如:
sprintf(s, "%f", 3.1415926); //产⽣"3.141593"
但有时我们希望⾃⼰控制打印的宽度和⼩数位数,这时就应该使⽤:”%m.nf”格式,其中m 表⽰打印的宽度,n 表⽰⼩数点后的位数。⽐如:
sprintf(s, "%10.3f", 3.1415626); //产⽣:" 3.142"
sprintf(s, "%-10.3f", 3.1415626); //产⽣:"3.142 "
sprintf(s, "%.3f", 3.1415626); //不指定总宽度,产⽣:"3.142"
注意⼀个问题,你猜
int i = 100;
sprintf(s, "%.2f", i);
会打出什么东东来?“100.00”?对吗?⾃⼰试试就知道了,同时也试试下⾯这个:
sprintf(s, "%.2f", (double)i);
第⼀个打出来的肯定不是正确结果,原因跟前⾯提到的⼀样,参数压栈时调⽤者并不知道跟i相对应的格式控制符是个”%f”。⽽函数执⾏时函数本⾝则并不知道当年被压⼊栈⾥的是个整数,于是可怜的保
存整数i 的那4 个字节就被不由分说地强⾏作为浮点数格式来解释了,整个乱套了。不过,如果有⼈有兴趣使⽤⼿⼯编码⼀个浮点数,那么倒可以使⽤这种⽅法来检验⼀下你⼿⼯编排的结果是否正确。
4.字符/Ascii码
我们知道,在C/C++语⾔中,char 也是⼀种普通的scalable 类型,除了字长之外,它与short,int,long 这些类型没有本质区别,只不过被⼤家习惯⽤来表⽰字符和字符串⽽已。(或许当年该把这个类型叫做“byte”,然后现在就可以根据实际情况,使⽤byte 或short 来把char 通过typedef 定义出来,这样更合适些)于是,使⽤”%d”或者”%x”打印⼀个字符,便能得出它的10 进制或16 进制的ASCII 码;反过来,使⽤”%c”打印⼀个整数,便可以看到它所对应的ASCII字符。以下程序段把所有可见字符的ASCII 码对照表打印到屏幕上(这⾥采⽤printf,注意”#”与”%X”合⽤时⾃动为16 进制数增加”0X”前缀):
for(int i = 32; i < 127; i++) {
printf("[ %c ]: %3d 0x%#04X\n", i, i, i);
}
连接字符串
sprintf 的格式控制串中既然可以插⼊各种东西,并最终把它们“连成⼀串”,⾃然也就能够连接字符串,从⽽在许多场合可以替代strcat,但sprintf 能够⼀次连接多个字符串(⾃然也可以同时在它们中间插⼊别的内容,总之⾮常灵活)。⽐如:
1char*buf[60];
2char*who="I";
3char*whom="CSDN";
4 sprintf(buf,"%slove%s.",who,whom);
5 printf("%s",buf);
//输出结果:"IloveCSDN."
strcat 只能连接字符串(⼀段以'\0'结尾的字符数组或叫做字符缓冲,null-terminated-string),但有时我们有两段字符缓冲区,他们并不是以 ’’结尾。⽐如许多从第三⽅库函数中返回的字符数组,从硬件或者⽹络传输中读进来的字符流,它们未必每⼀段字符序列后⾯都有个相应的’’来结尾。如果直接连接,不管是sprintf 还是strcat 肯定会导致⾮法内存操作,⽽strncat 也⾄少要求第⼀个参数是个null-ter
minated-string,那该怎么办呢?我们⾃然会想起前⾯介绍打印整数和浮点数时可以指定宽度,字符串也⼀样的。⽐如:
char a1[] = {'A', 'B', 'C', 'D', 'E', 'F', 'G'};
char a2[] = {'H', 'I', 'J', 'K', 'L', 'M', 'N'};
如果:
sprintf(s, "%s%s", a1, a2); //Don't do that!
⼗有⼋九要出问题了。是否可以改成:
sprintf(s, "%7s%7s", a1, a2);
也没好到哪⼉去,正确的应该是:
sprintf(s, "%.7s%.7s", a1, a2);//产⽣:"ABCDEFGHIJKLMN"
这可以类⽐打印浮点数的”%m/nf”,在”%m.ns”中,m 表⽰占⽤宽度(字符串长度不⾜时补空格,超出了则按照实际宽度打印),n 才表⽰从相应的字符串中最多取⽤的字符数。通常在打印字符串时m 没
什么⼤⽤,还是点号后⾯的n ⽤的多。⾃然,也可以前后都只取部分字符:
sprintf(s, "%.6s%.5s", a1, a2);//产⽣:"ABCDEFHIJKL"
在许多时候,我们或许还希望这些格式控制符中⽤以指定长度信息的数字是动态的,⽽不是静态指定的,因为许多时候,程序要到运⾏时才会清楚到底需要取字符数组中的⼏个字符,这种动态的宽度/精度设置功能在sprintf 的实现中也被考虑到了,sprintf 采⽤”*”来占⽤⼀个本来需要⼀个指定宽度或精度的常数数字的位置,同样,⽽实际的宽度或精度就可以和其它被打印的变量⼀样被提供出来,于是,上⾯的例⼦可以变成:
sprintf(s, "%.*s%.*s", 7, a1, 7, a2);
或者:
sprintf(s, "%.*s%.*s", sizeof(a1), a1, sizeof(a2), a2);
实际上,前⾯介绍的打印字符、整数、浮点数等都可以动态指定那些常量值,⽐如:
1 sprintf(s,"%-*d",4,'A');//产⽣"65"
2 sprintf(s,"%#0*X",8,128);//产⽣"0X000080","#"产⽣0X
3 sprintf(s,"%*.*f",10,2,3.1415926);//产⽣"3.14"
打印地址信息
有时调试程序时,我们可能想查看某些变量或者成员的地址,由于地址或者指针也不过是个32 位的数,你完全可以使⽤打印⽆符号整数的”%u”把他们打印出来:
sprintf(s,"%u",&i);
不过通常⼈们还是喜欢使⽤16 进制⽽不是10 进制来显⽰⼀个地址:
sprintf(s,"%08X",&i);格式化命令format参数
然⽽,这些都是间接的⽅法,对于地址打印,sprintf 提供了专门的”%p”:
sprintf(s,"%p",&i);
我觉得它实际上就相当于:
sprintf(s,"%0*x",2*sizeof(void*),&i);
利⽤sprintf 的返回值
较少有⼈注意printf/sprintf 函数的返回值,但有时它却是有⽤的,sprintf 返回了本次函数调⽤最终打印到字符缓冲区中的字符数⽬。也就是说每当⼀次sprinf 调⽤结束以后,你⽆须再调⽤⼀次strlen 便已经知道了结果字符串的长度。如:
intlen=sprintf(s,"%d",i);
对于正整数来说,len 便等于整数i 的10 进制位数。
下⾯的是个完整的例⼦,产⽣10 个[0, 100)之间的随机数,并将他们打印到⼀个字符数组s 中,
以逗号分隔开。
1 #include<stdio.h>
2 #include<stdlib.h>
3 #include<time.h>
4 intmain()
5 {
6 srand(time(0));
7 chars[64];
8 intoffset=0;
9for(inti=0;i<10;i++)
10 {
11 offset+=sprintf(s+offset,"%d,",rand()%100);
12 }
13 s[offset-1]='\n';//将最后⼀个逗号换成换⾏符。
14 printf(s);
15 return0;
16 }
设想当你从数据库中取出⼀条记录,然后希望把他们的各个字段按照某种规则连接成⼀个字符串时,就可以使⽤这种⽅法,从理论上讲,他应该⽐不断的strcat 效率⾼,因为strcat 每次调⽤都需要先到最后的那个’’的位置,⽽在上⾯给出的例⼦中,我们每次都利⽤sprintf 返回值把这个位置直接记下来了。
MSDN中例⼦:
//crt_sprintf.c//compilewith:/W3//Thisprogramusessprintftoformatvarious//dataandplacetheminthestringnamedbuffer.
1 #include<stdio.h>
2 intmain(void)
3 {
4 charbuffer[200],s[]="computer",c='l';
5 inti=35,j;
6 floatfp=1.7320534f;//Formatandprintvariousdata:
7 j=sprintf(buffer,"String:%s\n",s);//C4996
8 j+=sprintf(buffer+j,"Character:%c\n",c);//C4996
9 j+=sprintf(buffer+j,"Integer:%d\n",i);//C4996
10 j+=sprintf(buffer+j,"Real:%f\n",fp);//C4996
11//Note:sprintfisdeprecated;considerusingsprintf_sinstead
12 printf("Output:\n%s\ncharactercount=%d\n",buffer,j);
13 }
14 Copy
15 Output:
16 String:computer
17 Character:l
18 Integer:35
19 Real:1.732053
20 charactercount=79
3.常见问题
编辑
sprintf 是个变参函数,使⽤时经常出问题,⽽且只要出问题通常就是能导致程序崩溃的内存访问错误,但好在由sprintf 误⽤导致的问题虽然严重,却很容易出,⽆⾮就是那么⼏种情况,通常⽤眼睛再把出错的代码多看⼏眼就看出来了。
缓冲区溢出
第⼀个参数的长度太短了,没的说,给个⼤点的地⽅吧。当然也可能是后⾯的参数的问题,建议变参对应⼀定要细⼼,⽽打印字符串时,尽量使⽤”%.ns”的形式指定最⼤字符数。
忘记了第⼀个参数
低级得不能再低级问题,⽤printf ⽤得太惯了。//偶就常犯。:。(
变参对应出问题
通常是忘记了提供对应某个格式符的变参,导致以后的参数统统错位,检查检查吧。尤其是对应”*”的那些参数,都提供了吗?不要把⼀个整数对应⼀个”%s”,编译器会觉得你欺她太甚了(编译器是obj 和exe 的妈妈,应该是个⼥的,:P)。
sprintf_s和snprintf
sprintf_s()是sprintf()的安全版本,通过指定缓冲区长度来避免sprintf()存在的溢出风险。在使⽤VS2008时如果你使⽤了sprintf函数,那么编译器会发出警告:使⽤sprintf存在风险,建议使⽤sprintf_s。这个安全版本的原型是:
int sprintf_s(char *buffer,size_t sizeOfBuffer,const char *format [,argument] ... );
不过sprintf_s()是微软私有的函数,考虑到跨平台移植,最好使⽤snprintf()。两者的原型基本相同:
int _snprintf(char *buffer, size_t count, const char *format [,argument] ... );
strftime
spritf 还有个不错的表妹:strftime,专门⽤于格式化时间字符串的,⽤法跟她表哥很像,也是⼀⼤堆格式控制符,只是毕竟⼩姑娘家⼼细,她还要调⽤者指定缓冲区的最⼤长度,可能是为了在出现问题时可以推卸责任吧。这⾥举个例⼦:
time_t t = time(0);
//产⽣"YYYY-MM-DD hh:mm:ss"格式的字符串。
char s[32];
strftime(s, sizeof(s), "%Y-%m-%d %H:%M:%S", localtime(&t));
sprintf 在MFC 中也能到他的知⾳:CString::Format,strftime 在MFC 中⾃然也有她的同道:CTime::Format,这⼀对由于从⾯向对象那⾥得到了赞助,⽤以写出的代码更觉优雅。

版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。