int sprintf( char *buffer, const char *format, [ argument] … );
1.功能
2.头文件
3.参数列表
buffer:
char型指针,指向将要写入的字符串的缓冲区。
format:格式化字符串。
[argument]..
.:可选参数,可以是任何类型的数据。
返回值:字符串长度(
strlen)
4. 例子
#include<stdio.h>/*某个stdio.h*/
int
main()
/*主函数“整数”类型*/
{
char
buffer[50];
/*“字符”类型的数组,下面共有50个元素。*/
int
n,a=5,b=3;
/*三个变量都为“整数”类型,int中间要有空格*/
n=
sprintf
(buffer,
"%d plus %d is %d"
,a,b,a+b);
/*赋予数值*/
printf
(
"[%s]is a string %d chars long\n"
,buffer,n);
/*“格式输出函数”*/
return
0;
/*“返回零”
也就是程序正常退出*/
}
输出:
[5 plus 3 is 8] is a string 13 chars long
|
5.格式化字符串
1) 处理字符方向。负号时表示从后向前处理。
2)填空字元。 0 的话表示空格填 0;空格是内定值,表示空格就放着。
3)
字符总宽度。为最小宽度。
4) 精确度。指在小数点后的浮点数位数。
6.转换字符
%% 印出百分比符号,不转换。
%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添加在最后面了
7.sprintf与printf
在将各种类型的数据构造成字符串时,sprintf 的强大功能很少会让你失望。由于sprintf 跟printf 在用法上几乎一样,只是打印的目的地不同而已,
前者打印到字符串中,后者则直接在命令行上输出
。这也导致sprintf 比printf 有用得多。
8.格式化数字字符串
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 的方式。
9.连接字符串
sprintf 的格式控制串中既然可以插入各种东西,并最终把它们“连成一串”,自然也就能够连接字符串,从而在许多场合可以替代strcat,但sprintf 能够一次连接多个字符串(自然也可以同时在它们中间插入别的内容,总之非常灵活)。比如:
1
2
3
4
5
6
|
char
*buf[60];
char
*who=
"I"
;
char
*whom=
"CSDN"
;
sprintf
(buf,
"%slove%s."
,who,whom);
printf
(
"%s"
,buf);
//输出结果:"IloveCSDN."
|
strcat 只能连接字符串(一段以'\0'结尾的字符
数组或叫做字符缓冲,null-terminated-string),但有时我们有两段字符
缓冲区,他们并不是以 ’’结尾。比如许多从第三方
库函数中返回的字符数组,从硬件或者网络传输中读进来的字符流,它们未必每一段字符序列后面都有个相应的’’来结尾。如果直接连接,不管是sprintf 还是strcat 肯定会导致非法内存操作,而strncat 也至少要求第一个参数是个null-terminated-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
2
3
|
sprintf
(s,
"%-*d"
,4,
'A'
);
//产生"65"
sprintf
(s,
"%#0*X"
,8,128);
//产生"0X000080","#"产生0X
sprintf
(s,
"%*.*f"
,10,2,3.1415926);
//产生"3.14"
|
打印地址信息
1
|
sprintf
(s,
"%u"
,&i);
|
不过通常人们还是喜欢使用16 进制而不是10 进制来显示一个地址:
1
|
sprintf
(s,
"%08X"
,&i);
|
然而,这些都是间接的方法,对于地址打印,sprintf 提供了专门的”%p”:
1
|
sprintf
(s,
"%p"
,&i);
|
我觉得它实际上就相当于:
1
|
sprintf
(s,
"%0*x"
,2*
sizeof
(
void
*),&i);
|
利用sprintf 的返回值
较少有人注意printf/sprintf 函数的返回值,但有时它却是有用的,sprintf 返回了本次
函数调用最终打印到字符
缓冲区中的字符数目。也就是说每当一次sprinf 调用结束以后,你无须再调用一次strlen 便已经知道了结果字符串的长度。如:
1
|
intlen=
sprintf
(s,
"%d"
,i);
|
对于正整数来说,len 便等于整数i 的10 进制位数。
下面的是个完整的例子,产生10 个[0, 100)之间的随机数,并将他们打印到一个字符
数组s 中,
以逗号分隔开。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
#include<stdio.h>
#include<stdlib.h>
#include<time.h>
intmain()
{
srand
(
time
(0));
chars[64];
intoffset=0;
for
(inti=0;i<10;i++)
{
offset+=
sprintf
(s+offset,
"%d,"
,
rand
()%100);
}
s[offset-1]=
'\n'
;
//将最后一个逗号换成换行符。
printf
(s);
return0;
}
|
设想当你从数据库中取出一条记录,然后希望把他们的各个字段按照某种规则连接成一个字符串时,就可以使用这种方法,从理论上讲,他应该比不断的strcat 效率高,因为strcat 每次调用都需要先找到最后的那个’’的位置,而在上面给出的例子中,我们每次都利用sprintf 返回值把这个位置直接记下来了。
MSDN中例子:
//crt_sprintf.c//compilewith:/W3//Thisprogramusessprintftoformatvarious//dataandplacetheminthestringnamedbuffer.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
#include<stdio.h>
intmain(
void
)
{
charbuffer[200],s[]=
"computer"
,c=
'l'
;
inti=35,j;
floatfp=1.7320534f;
//Formatandprintvariousdata:
j=
sprintf
(buffer,
"String:%s\n"
,s);
//C4996
j+=
sprintf
(buffer+j,
"Character:%c\n"
,c);
//C4996
j+=
sprintf
(buffer+j,
"Integer:%d\n"
,i);
//C4996
j+=
sprintf
(buffer+j,
"Real:%f\n"
,fp);
//C4996
//Note:sprintfisdeprecated;considerusingsprintf_sinstead
printf
(
"Output:\n%s\ncharactercount=%d\n"
,buffer,j);
}
Copy
Output:
String:computer
Character:l
Integer:35
Real:1.732053
charactercount=53
|
10. 常见问题
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,这一对由于从
面向对象那里得到了赞助,用以写出的代码更觉优雅。
转自:百度百科