sprintf

字符串格式化命令

sprintf指的是字符串格式化命令，函数声明为 int sprintf(char *string, char *format [,argument,...]);，主要功能是把格式化的数据写入某个字符串中，即发送格式化输出到 string 所指向的字符串。sprintf 是个变参函数。使用sprintf 对于写入buffer的字符数是没有限制的，这就存在了buffer溢出的可能性。解决这个问题，可以考虑使用 snprintf函数，该函数可对写入字符数做出限制。

简介

C 库函数 int sprintf(char *str, const char *format, ...) 发送格式化输出到 str 所指向的字符串。

sprintf跟printf在用法上几乎一样，只是打印的目的地不同而已，前者打印到字符串中，后者则直接在命令行上输出。sprintf使用格式化字符串来指定串的格式，在格式串内部使用一些以“%”开头的格式说明符（format specifications）来占据一个位置，在后边的变参列表中提供相应的变量，最终函数就会用相应位置的变量来替代那个说明符，产生一个调用者想要的字符串。

函数语法

函数声明

int sprintf(char *string, char *format [,argument,...]);

参数列表

功能

把格式化的数据写入某个字符串缓冲区。

返回值

如果成功，则返回写入的字符总数，不包括字符串追加在字符串末尾的空字符。如果失败，则返回一个负数。

sprintf 返回以format为格式argument为内容组成的结果

相关函数

说明及应用

例子

输出结果：

Output:

String: computer

Character: l

Integer: 35

Real: 1.732053

character count = 79

format标签属性

format 标签属性是%[flags][width][.precision][length]specifier，具体讲解如下：

sprintf格式的规格如下所示。[ ]中的部分是可选的。

%[指定参数][标识符][宽度][.精度]指示符

1. [指定参数] 处理字符方向。负号时表示从后向前处理。

2. [标识符] 填空字元。 0 的话表示空格填 0；空格是内定值，表示空格就放着。

3. [宽度]字符总宽度。为最小宽度。

4. [精度] 精确度。指在小数点后的浮点数位数。

5, 转换字符

%% 印出百分比符号，不转换。

%c 字符输出到缓冲区，不转换。

%d 整数转成十进位。

%f 倍精确度数字转成浮点数。

%o 整数转成八进位。

%s 字符串输出到缓冲区，不转换。

%x 整数转成小写十六进位。

%X 整数转成大写十六进位。

例如：

%08.2f 解释:

%开始符；

8格式化后总长度；

2f小数位长度，即2位；

因为2f是(2位)+小数点符号(1位)+前面123(3位)=6位，总长度为8位,故前面用[填空字元]0表示，即00123.10

-号为反向操作，然后填空字元0添加在最后面了

在将各种类型的数据构造成字符串时，sprintf 的强大功能很少会让人失望。由于sprintf 跟printf 在用法上几乎一样，只是打印的目的地不同而已，前者打印到字符串中，后者则直接在命令行上输出。这也导致sprintf 比printf 有用得多。

说明

sprintf 是个变参函数，定义如下：

int sprintf( char *buffer, const char *format [, argument] ... );

除了前两个参数类型固定外，后面可以接任意多个参数。而它的精华，显然就在第二个参数：格式化字符串上。

printf 和sprintf 都使用格式化字符串来指定串的格式，在格式串内部使用一些以“%”开头的格式说明符（format specifications）来占据一个位置，在后边的变参列表中提供相应的变量，最终函数就会用相应位置的变量来替代那个说明符，产生一个调用者想要的字符串。

格式化数字字符串sprintf 最常见的应用之一莫过于把整数打印到字符串中，所以，sprintf 在大多数场合可以替代itoa。

如：

可以指定宽度，不足的左边补空格：

当然也可以左对齐：

也可以按照16 进制打印：

这样，一个整数的16 进制字符串就很容易得到，但在打印16 进制内容时，在表示宽度的数字前面加个0 就可以了。

上面以”%d”进行的10 进制打印同样也可以使用这种左边补0 的方式。

这里要注意一个符号扩展的问题：比如，假如想打印短整数（short）-1 的内存16 进制表示形式，在Win32 平台上，一个short 型占2 个字节，所以自然希望用4 个16 进制数字来打印它：

产生“FFFFFFFF”是因为sprintf 是个变参函数，除了前面两个参数之外，后面的参数都不是类型安全的，函数更没有办法仅仅通过一个“%X”就能得知当初函数调用前参数压栈时被压进来的到底是个4 字节的整数还是个2 字节的短整数，所以采取了统一4 字节的处理方式，导致参数压栈时做了符号扩展，扩展成了32 位的整数-1，打印时4 个位置不够了，就把32 位整数-1 的8 位16 进制都打印出来了。

如果想看si 的本来面目，那么就应该让编译器做0 扩展而不是符号扩展（扩展时二进制左边补0 而不是补符号位）：

就可以了。或者：

sprintf 和printf 还可以按8 进制打印整数字符串，使用”%o”。注意8 进制和16 进制都不会打印出负数，都是无符号的，实际上也就是变量的内部编码的直接的16 进制或8 进制表示。

控制浮点数打印格式

浮点数的打印和格式控制是sprintf 的又一大常用功能，浮点数使用格式符”%f”控制，默认保留小数点后6 位数字，比如：

如果希望自己控制打印的宽度和小数位数，这时就应该使用：”%m.nf”格式，其中m 表示打印的宽度，n 表示小数点后的位数。比如：

注意一个问题：

会打出什么内容以及是否正确，需要试验一下，同时也试试下面这个：

第一个打出来的肯定不是正确结果，原因跟前面提到的一样，参数压栈时调用者并不知道跟i相对应的格式控制符是个”%f”。而函数执行时函数本身则并不知道当年被压入栈里的是个整数，于是可怜的保存整数i 的那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”前缀）：

连接字符串

sprintf 的格式控制串中既然可以插入各种东西，并最终把它们“连成一串”，自然也就能够连接字符串，从而在许多场合可以替代strcat，但sprintf 能够一次连接多个字符串（自然也可以同时在它们中间插入别的内容，总之非常灵活）。比如：

数组或叫做字符缓冲，null-terminated-string），如果有两段字符缓冲区，他们并不是以 ’’结尾。比如许多从第三方库函数中返回的字符数组，从硬件或者网络传输中读进来的字符流，它们未必每一段字符序列后面都有个相应的’’来结尾。如果直接连接，不管是sprintf 还是strcat 肯定会导致非法内存操作，而strncat 也至少要求第一个参数是个null-terminated-string，参考前面介绍打印整数和浮点数时可以指定宽度，字符串也一样的。比如：

如果：

十有八九要出问题了。是否可以改成：

也没好到哪儿去，正确的应该是：

这可以类比打印浮点数的”%m/nf”，在”%m.ns”中，m 表示占用宽度（字符串长度不足时补空格，超出了则按照实际宽度打印），n 才表示从相应的字符串中最多取用的字符数。通常在打印字符串时m 没什么大用，还是点号后面的n 用的多。自然，也可以前后都只取部分字符：

在许多时候，用户或许还希望这些格式控制符中用以指定长度信息的数字是动态的，而不是静态指定的，因为许多时候，程序要到运行时才会清楚到底需要取字符数组中的几个字符，这种动态的宽度/精度设置功能在sprintf 的实现中也被考虑到了，sprintf 采用”*”来占用一个本来需要一个指定宽度或精度的常数数字的位置，同样，而实际的宽度或精度就可以和其它被打印的变量一样被提供出来，于是，上面的例子可以变成：

或者：

实际上，前面介绍的打印字符、整数、浮点数等都可以动态指定那些常量值，比如：

打印地址信息

有时调试程序时，用户可能想查看某些变量或者成员的地址，由于地址或者指针也不过是个32 位的数，完全可以使用打印无符号整数的”%u”把他们打印出来：

不过通常人们还是喜欢使用16 进制而不是10 进制来显示一个地址：

然而，这些都是间接的方法，对于地址打印，sprintf 提供了专门的”%p”：

它实际上就相当于：

利用sprintf 的返回值

较少有人注意printf/sprintf 函数的返回值，但有时它却是有用的，sprintf 返回了本次函数调用最终打印到字符缓冲区中的字符数目。也就是说每当一次sprinf 调用结束以后，无须再调用一次strlen 便已经知道了结果字符串的长度。如：

对于正整数来说，len 便等于整数i 的10 进制位数。

下面的是个完整的例子，产生10 个[0, 100)之间的随机数，并将他们打印到一个字符数组s 中，

以逗号分隔开。