c文件输出函数printf, fprintf, sprintf, snprintf, printf_s, fprintf_s, sprintf_s, snprintf_s

梦里梦外; 2022-05-08 15:56 383阅读 0赞

# 转自：[https://zh.cppreference.com/w/c/io/fprintf][https_zh.cppreference.com_w_c_io_fprintf] #

#  #

<table> 
 <tbody> 
 <tr> 
 <td> 定义于头文件&nbsp;<code>&lt;stdio.h&gt;</code> </td> 
 <td>&nbsp;</td> 
 <td>&nbsp;</td> 
 </tr> 
 </tbody> 
 <tbody> 
 <tr> 
 <td>&nbsp;</td> 
 <td>(1)</td> 
 <td>&nbsp;</td> 
 </tr> 
 <tr> 
 <td> int&nbsp;printf(&nbsp;const&nbsp;char&nbsp;*format, ...&nbsp;); </td> 
 <td>(C99 前)</td> 
 </tr> 
 <tr> 
 <td> int&nbsp;printf(&nbsp;const&nbsp;char&nbsp;*restrict&nbsp;format, ...&nbsp;); </td> 
 <td>(C99 起)</td> 
 </tr> 
 </tbody> 
 <tbody> 
 <tr> 
 <td>&nbsp;</td> 
 <td>(2)</td> 
 <td>&nbsp;</td> 
 </tr> 
 <tr> 
 <td> int&nbsp;fprintf(&nbsp;<a href="http://zh.cppreference.com/w/c/io" rel="nofollow">FILE</a>&nbsp;*stream,&nbsp;const&nbsp;char&nbsp;*format, ...&nbsp;); </td> 
 <td>(C99 前)</td> 
 </tr> 
 <tr> 
 <td> int&nbsp;fprintf(&nbsp;<a href="http://zh.cppreference.com/w/c/io" rel="nofollow">FILE</a>&nbsp;*restrict&nbsp;stream,&nbsp;const&nbsp;char&nbsp;*restrict&nbsp;format, ...&nbsp;); </td> 
 <td>(C99 起)</td> 
 </tr> 
 </tbody> 
 <tbody> 
 <tr> 
 <td>&nbsp;</td> 
 <td>(3)</td> 
 <td>&nbsp;</td> 
 </tr> 
 <tr> 
 <td> int&nbsp;sprintf(&nbsp;char&nbsp;*buffer,&nbsp;const&nbsp;char&nbsp;*format, ...&nbsp;); </td> 
 <td>(C99 前)</td> 
 </tr> 
 <tr> 
 <td> int&nbsp;sprintf(&nbsp;char&nbsp;*restrict&nbsp;buffer,&nbsp;const&nbsp;char&nbsp;*restrict&nbsp;format, ...&nbsp;); </td> 
 <td>(C99 起)</td> 
 </tr> 
 </tbody> 
 <tbody> 
 <tr> 
 <td> int&nbsp;snprintf(&nbsp;char&nbsp;*restrict&nbsp;buffer,&nbsp;int&nbsp;bufsz,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp;const&nbsp;char&nbsp;*restrict&nbsp;format, ...&nbsp;); </td> 
 <td>(4)</td> 
 <td>(C99 起)</td> 
 </tr> 
 <tr> 
 <td> int&nbsp;printf_s(const&nbsp;char&nbsp;*restrict&nbsp;format, ...); </td> 
 <td>(5)</td> 
 <td>(C11 起)</td> 
 </tr> 
 <tr> 
 <td> int&nbsp;fprintf_s(<a href="http://zh.cppreference.com/w/c/io" rel="nofollow">FILE</a>&nbsp;*restrict&nbsp;stream,&nbsp;const&nbsp;char&nbsp;*restrict&nbsp;format, ...); </td> 
 <td>(6)</td> 
 <td>(C11 起)</td> 
 </tr> 
 <tr> 
 <td> int&nbsp;sprintf_s(char&nbsp;*restrict&nbsp;buffer, rsize_t bufsz, &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;&nbsp;const&nbsp;char&nbsp;*restrict&nbsp;format, ...); </td> 
 <td>(7)</td> 
 <td>(C11 起)</td> 
 </tr> 
 <tr> 
 <td> int&nbsp;snprintf_s(char&nbsp;*restrict&nbsp;buffer, rsize_t bufsz, &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;const&nbsp;char&nbsp;*restrict&nbsp;format, ...); </td> 
 <td>(8)</td> 
 <td>(C11 起)</td> 
 </tr> 
 <tr> 
 <td>&nbsp;</td> 
 <td>&nbsp;</td> 
 <td>&nbsp;</td> 
 </tr> 
 </tbody> 
</table>

从给定位置加载数据，转换为字符串等价物，并写结果到各种池。

1) 写结果到 [stdout][] 。

2) 写结果到文件流 `stream` 。

3) 写结果到字符串 `buffer` 。

4) 写结果到字符串 `buffer` 。至多写 `buf_size` \- 1 个字符。产生的字符串会以空字符终止，除非 `buf_size` 为零。若 `buf_size` 为零，则不写入任何内容，且 `buffer` 可以是空指针，然而依旧计算返回值（会写入的字符数，不包含空终止符）并返回。

5-8) 同 (1-4) ，除了在运行时检测下列错误，并调用当前安装的[制约处理][Link 1]函数：

*  `format` 中存在转换指定符 `%n`
 *  任何一个对应 `%s` 的参数是空指针
 *  `format` 或 `buffer` 是空指针
 *  `bufsz` 为零或大于 RSIZE\_MAX
 *  在任何一个字符串及字符转换指定符中出现编码错误
 *  （仅对于 `sprintf_s` ）存储于 `buffer` 的字符串（包括尾随空字符）长度将超出 `bufsz`

同所有边界检查函数， `printf_s, fprintf_s, sprintf_s, snrintf_s` 仅若实现定义了 \_\_STDC\_LIB\_EXT1\_\_ ，且用户在包含 `<stdio.h>` 前定义 \_\_STDC\_WANT\_LIB\_EXT1\_\_ 为整数常量 1 才保证可用。

### 参数 ###

<table> 
 <tbody> 
 <tr> 
 <td>stream</td> 
 <td>-</td> 
 <td>要写入的输出文件流</td> 
 </tr> 
 <tr> 
 <td>buffer</td> 
 <td>-</td> 
 <td>指向要写入的字符串的指针</td> 
 </tr> 
 <tr> 
 <td>bufsz</td> 
 <td>-</td> 
 <td>最多会写入 bufsz - 1 个字符，再加空终止符</td> 
 </tr> 
 <tr> 
 <td>format</td> 
 <td>-</td> 
 <td>指向指定数据转译方式的空终止多字节字符串的指针。 格式字符串由普通多字节字符（除了&nbsp;<code>%</code>&nbsp;）和转换指定构成，前者被复制到输出流而无更改。每个转换指定拥有下列格式： 
 <ul> 
 <li>引入的&nbsp;<code>%</code>&nbsp;字符</li> 
 </ul> 
 <ul> 
 <li>(可选)一或多个修改转换行为的标签：</li> 
 </ul> 
 <ul> 
 <li><code>-</code>&nbsp;：转换结果在域内左校正（默认为右校正）</li> 
 <li><code>+</code>&nbsp;：有符号转换的符号始终前置于转换结果（默认结果前置负号仅当它为负）</li> 
 <li>空格：若有符号转换的结果不以符号开始，或为空，则前置空格于结果。若存在&nbsp;<code>+</code>&nbsp;标签则忽略空格。</li> 
 <li><code>#</code>&nbsp;：进行另一种形式的转换。准确的效果见下表，其他情况下行为未定义。</li> 
 <li><code>0</code>&nbsp;：对于整数和浮点数转换，使用前导零代替空格字符填充域。对于整数，若显式指定精度，则忽略此标签。对于其他转换，使用此标签导致未定义行为。若存在&nbsp;<code>-</code>&nbsp;标签则忽略&nbsp;<code>0</code>&nbsp;。</li> 
 </ul> 
 <ul> 
 <li>(可选)指定最小域宽的整数值或&nbsp;<code>*</code>&nbsp;。若有要求，则结果会以空格字符（默认情况）填充，在右校正时于左，左校正时于右。使用&nbsp;<code>*</code>&nbsp;的情况下，以一个额外的&nbsp;int&nbsp;类型参数指定宽度。若参数值为负数，则它导致指定&nbsp;<code>-</code>&nbsp;标签和正域宽。（注意：这是最小宽度：决不被截断值）。</li> 
 </ul> 
 <ul> 
 <li>(可选)后随整数或&nbsp;<code>*</code>&nbsp;或两者皆无的&nbsp;<code>.</code>&nbsp;指示转换的精度。在使用&nbsp;<code>*</code>&nbsp;的情况下，精度由额外的&nbsp;int&nbsp;类型参数指定。若此参数的值为负数，则它被忽略。若既不使用数字亦不使用&nbsp;<code>*</code>&nbsp;，则精度采用零。精度的准确效果见下表。</li> 
 </ul> 
 <ul> 
 <li>(可选)指定参数大小的长度修饰符</li> 
 </ul> 
 <ul> 
 <li>转换格式指定符</li> 
 </ul>下列格式指定符可用： 
 <table> 
 <tbody> 
 <tr> 
 <th>转换 指定符</th> 
 <th>解释</th> 
 <th colspan="9">参数类型</th> 
 </tr> 
 <tr> 
 <th colspan="2">长度修饰符</th> 
 <th><code>hh</code> (C99) </th> 
 <th><code>h</code></th> 
 <th>（无）</th> 
 <th><code>l</code></th> 
 <th><code>ll</code> (C99) </th> 
 <th><code>j</code> (C99) </th> 
 <th><code>z</code> (C99) </th> 
 <th><code>t</code> (C99) </th> 
 <th><code>L</code></th> 
 </tr> 
 <tr> 
 <th><code>%</code></th> 
 <td>写字面的&nbsp;<code>%</code>&nbsp;。完整转换指定必须是&nbsp;<code>%%</code>&nbsp;。</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 </tr> 
 <tr> 
 <th><code>c</code></th> 
 <td> 写单个字符。 参数首先被转换成&nbsp;unsigned&nbsp;char&nbsp;。 若使用&nbsp;l&nbsp;修饰符，则参数首先被转换成字符串，如同通过以&nbsp;wchar_t[2]&nbsp;参数使用&nbsp;%ls&nbsp;。 </td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td> int </td> 
 <td> wint_t </td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 </tr> 
 <tr> 
 <th><code>s</code></th> 
 <td> 写一个字符串 参数必须是指向字符数组首元素的指针&nbsp;精度指定写入最大的字符数。若未指定精度，则写每个字节直到而而不含首个空终止符。 若使用&nbsp;l&nbsp;指定符，则参数必须是指向&nbsp;wchar_t&nbsp;数组首元素的指针，数组会被转换成 char 数组，如同通过以零初始化转换状态调用&nbsp;<a href="https://zh.cppreference.com/w/c/string/multibyte/wcrtomb" rel="nofollow">wcrtomb</a>&nbsp;。 </td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td> char* </td> 
 <td> wchar_t* </td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 </tr> 
 <tr> 
 <th><code>d</code> <code>i</code></th> 
 <td> 转换一个有符号整数为十进制表示&nbsp;[-]dddd&nbsp;。 精度指定出现的最小数位数。默认精度是&nbsp;1&nbsp;。 若被转换的值和精度都是&nbsp; 0 &nbsp;，则转换结果无字符。 </td> 
 <td> signed&nbsp;char </td> 
 <td> short </td> 
 <td> int </td> 
 <td> long </td> 
 <td> long&nbsp;long </td> 
 <td> <a href="http://zh.cppreference.com/w/c/types/integer" rel="nofollow">intmax_t</a> </td> 
 <td> 有符号&nbsp;<a href="http://zh.cppreference.com/w/c/types/size_t" rel="nofollow">size_t</a> </td> 
 <td> <a href="http://zh.cppreference.com/w/c/types/ptrdiff_t" rel="nofollow">ptrdiff_t</a> </td> 
 <td>N/A</td> 
 </tr> 
 <tr> 
 <th><code>o</code></th> 
 <td> 转换一个无符号整数为八进制表示&nbsp;oooo&nbsp;。 精度指定出现的最小数位数。默认精度是&nbsp;1&nbsp;。 若被转换值和精度都是&nbsp; 0 &nbsp;，则转换结果无字符。 在另一种实现中精度按需增加，以写入一个前导零。 在此情况下若被转换值和精度都是&nbsp; 0 &nbsp;，则写入单个&nbsp; 0 &nbsp;。 </td> 
 <td> unsigned&nbsp;char </td> 
 <td> unsigned&nbsp;short </td> 
 <td> unsigned&nbsp;int </td> 
 <td> unsigned&nbsp;long </td> 
 <td> unsigned&nbsp;long&nbsp;long </td> 
 <td> <a href="http://zh.cppreference.com/w/c/types/integer" rel="nofollow">uintmax_t</a> </td> 
 <td> <a href="http://zh.cppreference.com/w/c/types/size_t" rel="nofollow">size_t</a> </td> 
 <td> <a href="http://zh.cppreference.com/w/c/types/ptrdiff_t" rel="nofollow">ptrdiff_t</a>&nbsp;的无符号版本 </td> 
 <td>N/A</td> 
 </tr> 
 <tr> 
 <th><code>x</code> <code>X</code></th> 
 <td> 转换一个无符号整数为十六进制表示&nbsp;hhhh&nbsp;。 <code>x</code>&nbsp;转换使用字母&nbsp;<code>abcdef</code>&nbsp;。 <code>X</code>&nbsp;转换使用&nbsp;<code>ABCDEF</code>&nbsp;。 精度指定出现的最小数位数。默认精度是&nbsp;1&nbsp;。 若被转换值和精度都是&nbsp; 0 &nbsp;，则转换结果无字符。 在另一种实现中若被转换值为非零则结果有&nbsp;<code>0x</code>&nbsp;或&nbsp;<code>0X</code>&nbsp;前缀。 </td> 
 <td>N/A</td> 
 </tr> 
 <tr> 
 <th><code>u</code></th> 
 <td> 转换一个无符号整数为十进制表示&nbsp;dddd&nbsp;。 精度指定出现的最小数位数。 默认精度是&nbsp;1&nbsp;。 若被转换值和精度都是&nbsp; 0 &nbsp;，则转换结果无字符。 </td> 
 <td>N/A</td> 
 </tr> 
 <tr> 
 <th><code>f</code> <code>F</code></th> 
 <td> 转换一个浮点数为&nbsp;[-]ddd.ddd&nbsp;样式的十进制记法。 精度指定小数点字符后出现的最小数位数。 默认精度是&nbsp;6&nbsp;。 在另一种实现中即使没有小数点后数位也写小数点。 无穷大和非数的转换样式见注意。 </td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td> double </td> 
 <td> double&nbsp;(C99) </td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td> long&nbsp;double </td> 
 </tr> 
 <tr> 
 <th><code>e</code>&nbsp; <code>E</code></th> 
 <td> 转换一个浮点数为十进制指数记法。 <code>e</code>&nbsp;转换样式使用&nbsp;[-]d.ddd<code>e</code>±dd&nbsp;。 <code>E</code>&nbsp;转换样式使用&nbsp;[-]d.ddd<code>E</code>±dd&nbsp;。 指数至少含二个数位，仅当所需时使用更多数位。 若值为&nbsp; 0 &nbsp;，则指数亦为&nbsp; 0 &nbsp;。&nbsp;精度指定小数点字符后出现的最小数位数。 默认精度是&nbsp;6&nbsp;。 在另一种实现中即使没有小数点后数位也写小数点。 无穷大和非数的转换样式见注意。 </td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 </tr> 
 <tr> 
 <th><code>a</code>&nbsp; <code>A</code> (C99) </th> 
 <td> 转换一个浮点数为十六进制记法。 <code>a</code>&nbsp;转换样式使用&nbsp;[-]<code>0x</code>h.hhh<code>p</code>±d&nbsp;。 <code>A</code>&nbsp;转换样式使用&nbsp;[-]<code>0X</code>h.hhh<code>P</code>±d&nbsp;。 若参数不是正规化的浮点值，则首个十六进制数位为&nbsp;<code>0</code>。 若值为&nbsp; 0 &nbsp;，则指数亦为&nbsp; 0 &nbsp;。&nbsp;精度指定小数点字符后出现的最小数位数。 默认精度足以准确表示该值。 在另一种实现中即使没有小数点后数位也写小数点。 无穷大和非数的转换样式见注意。 </td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 </tr> 
 <tr> 
 <th><code>g</code>&nbsp; <code>G</code></th> 
 <td> 转换一个浮点数为十进制小数或十进制指数记法，依赖于值和精度。 <code>g</code>&nbsp;转换样式将进行带样式&nbsp;<code>e</code>&nbsp;或&nbsp;<code>f</code>&nbsp;的转换。 <code>G</code>&nbsp;转换样式将进行带样式&nbsp;<code>E</code>&nbsp;或&nbsp;<code>F</code>&nbsp;的转换。 令&nbsp;<code>P</code>&nbsp;等于精度，若它非零，若精度未指定则为&nbsp;6&nbsp;，若精度为&nbsp; 0 &nbsp;则等于&nbsp;1&nbsp;。然后，若带样式&nbsp;<code>E</code>&nbsp;的转换会有指数&nbsp;<code>X</code>&nbsp;，则： 
 <ul> 
 <li>若&nbsp;P &gt; X ≥ −4&nbsp;，则转换带&nbsp;<code>f</code>&nbsp;或&nbsp;<code>F</code>&nbsp;风格，及精度&nbsp;P − 1 − X&nbsp;。</li> 
 <li>否则，转换带&nbsp;<code>e</code>&nbsp;或&nbsp;<code>E</code>&nbsp;风格，及精度&nbsp;P − 1&nbsp;。</li> 
 </ul>除非要求另一种表示，否则末尾零会被移除，且若不留下小数部分则小数点亦被移除。 无穷大和非数的转换样式见注意。 </td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 </tr> 
 <tr> 
 <th><code>n</code></th> 
 <td> 返回对函数的此调用迄今为止写入的字符数。 结果被写入到参数所指向的值。 该指定不可含有任何标签、域宽或精度。 </td> 
 <td> signed&nbsp;char* </td> 
 <td> short* </td> 
 <td> int* </td> 
 <td> long* </td> 
 <td> long&nbsp;long* </td> 
 <td> <a href="http://zh.cppreference.com/w/c/types/integer" rel="nofollow">intmax_t</a>* </td> 
 <td> 有符号&nbsp;<a href="http://zh.cppreference.com/w/c/types/size_t" rel="nofollow">size_t</a>* </td> 
 <td> <a href="http://zh.cppreference.com/w/c/types/ptrdiff_t" rel="nofollow">ptrdiff_t</a>* </td> 
 <td>N/A</td> 
 </tr> 
 <tr> 
 <th><code>p</code></th> 
 <td>写定义一个指针的实现定义字符序列。</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>void*</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 <td>N/A</td> 
 </tr> 
 </tbody> 
 </table>浮点转换函数转换无穷大到&nbsp;<code>inf</code>&nbsp;或&nbsp;<code>infinity</code>&nbsp;。使用哪一个是实现定义的。 非数转换成&nbsp;<code>nan</code>&nbsp;或&nbsp;<code>nan(char_sequence)</code>&nbsp;。使用哪一个是实现定义的。 转换&nbsp;<code>F</code>&nbsp;、&nbsp;<code>E</code>&nbsp;、&nbsp;<code>G</code>&nbsp;、&nbsp;<code>A</code>&nbsp;替代上面输出&nbsp;<code>INF</code>&nbsp;、&nbsp;<code>INFINITY</code>&nbsp;、&nbsp;<code>NAN</code>。 尽管&nbsp;<code>%c</code>&nbsp;期待&nbsp;<code>int</code>&nbsp;参数，传递&nbsp;<code>char</code>&nbsp;是安全的，因为在调用变参数函数时发生整数提升。 定宽整数类型（&nbsp;<a href="https://zh.cppreference.com/w/c/types/integer" rel="nofollow">int8_t</a>&nbsp;等）的正确转换指定定义于头文件&nbsp;<a href="https://zh.cppreference.com/w/c/types/integer" rel="nofollow">&lt;inttypes.h&gt;</a>&nbsp;（尽管&nbsp;<a href="https://zh.cppreference.com/w/c/types/integer" rel="nofollow">PRIdMAX</a>&nbsp;、&nbsp;<a href="https://zh.cppreference.com/w/c/types/integer" rel="nofollow">PRIuMAX</a>&nbsp;等就是&nbsp;<code>%jd</code>、&nbsp;<code>%ju</code>&nbsp;等的别名）。 内存写入转换指定符&nbsp;%n&nbsp;是安全漏洞的常见目标，这里格式字符串依赖用户输入，而此转换指定符不为边界检查的&nbsp;<code>printf_s</code>&nbsp;系列函数所支持。 在每个转换指定符的行动后有一个<a href="https://zh.cppreference.com/w/c/language/eval_order" rel="nofollow">序列点</a>；这允许存入多次&nbsp;%n&nbsp;的结果于同一变量，并在同一调用中打印出先前以&nbsp;%n&nbsp;存储的值。 若转换指定非法，则行为未定义。 &nbsp; </td> 
 </tr> 
 <tr> 
 <td>...</td> 
 <td>-</td> 
 <td>指定要打印数据的参数。若任何<a href="https://zh.cppreference.com/w/c/language/conversion#.E9.BB.98.E8.AE.A4.E5.8F.82.E6.95.B0.E6.8F.90.E5.8D.87" rel="nofollow">默认参数提升</a>后的参数不拥有对应转换指定符所期待的类型，或若参数数量少于&nbsp;<code>format</code>&nbsp;的要求，则行为未定义。若有多于&nbsp;<code>format</code>&nbsp;要求的参数，则求值并忽略多出的参数。</td> 
 </tr> 
 </tbody> 
</table>

### 返回值 ###

1,2) 传输到输出流的字符数，或若出现输出错误或编码错误（对于字符串和字符转换指定符）则为负值。

3) 写入到 `buffer` 的字符数（不计空终止字符），或若输出错误或编码错误（对于字符串和字符转换指定符）发生则为负值。

4) 假如忽略 `bufsz` 则本应写入到 `buffer` 的字符数（不计空终止字符），或若出现输出错误或编码错误（对于字符串和字符转换指定符）则为负值。

5,6) 传输到输出流的字符数，或若出现输出错误、运行时制约违规错误或编码错误则为负值。

7) 写入到`buffer`的字符数，不计空终止字符（只要 `buffer` 不是空指针且 `bufsz` 非零且不大于 `RSIZE_MAX` ，就写入它），在运行时制约违规时为零，而在编码错误时为负值。

8) 假如忽略 `bufsz` 则本应写入 `buffer` 的字符数的，不包含空终止字符（只要 `buffer` 不是空指针而 `bufsz` 非零且不大于 `RSIZE_MAX` ，就写入它），或若出现输出错误、运行时制约违规错误或编码错误则为负值。

### 注意 ###

C 标准及[POSIX][] 指定 `sprintf` 及其变体的行为在参数与目标缓冲区重叠时未定义。示例：

sprintf(dst, "%s and %s", dst, t); // <- 有错：未定义行为

[POSIX指定][POSIX]在错误时设置[errno][]。它亦指定附加的转换指定，最值得注意的是对参数重排序的支持（紧随%之后的n$指示第`n`个参数）。

以零为 `bufsz` 和空指针为 `buffer` 调用 `snprintf` 可用于决定包含输出的缓冲区大小：

const char *fmt = "sqrt(2) = %f";
    int sz = snprintf(NULL, 0, fmt, sqrt(2));
    char buf[sz + 1]; // 注意为终止空字符 +1
    snprintf(buf, sizeof buf, fmt, sqrt(2));

同 `snprintf` ，但不同于 `sprintf_s` ， `snprintf_s` 会将输出截断在 `bufsz-1` 之内。

### 示例 ###

运行此代码

#include <stdio.h>
  
 int main(void)
 {
 printf("Strings:\n");
 const char* s = "Hello";
 printf("\t.%10s.\n\t.%-10s.\n\t.%*s.\n", s, s, 10, s);
  
 printf("Characters:\t%c %%\n", 65);
  
 printf("Integers\n");
 printf("Decimal:\t%i %d %.6i %i %.0i %+i %u\n", 1, 2, 3, 0, 0, 4, -1);
 printf("Hexadecimal:\t%x %x %X %#x\n", 5, 10, 10, 6);
 printf("Octal:\t%o %#o %#o\n", 10, 10, 4);
  
 printf("Floating point\n");
 printf("Rounding:\t%f %.0f %.32f\n", 1.5, 1.5, 1.3);
 printf("Padding:\t%05.2f %.2f %5.2f\n", 1.5, 1.5, 1.5);
 printf("Scientific:\t%E %e\n", 1.5, 1.5);
 printf("Hexadecimal:\t%a %A\n", 1.5, 1.5);
 }

输出：

Strings:
        .     Hello.
        .Hello     .
        .     Hello.
    Characters:     A %
    Integers
    Decimal:        1 2 000003 0  +4 4294967295
    Hexadecimal:    5 a A 0x6
    Octal:          12 012 04
    Floating point
    Rounding:       1.500000 2 1.30000000000000004440892098500626
    Padding:        01.50 1.50  1.50
    Scientific:     1.500000E+00 1.500000e+00
    Hexadecimal:    0x1.8p+0 0X1.8P+0

### 引用 ###

*  C11 standard (ISO/IEC 9899:2011):

*  7.21.6.1 The fprintf function (p: 309-316)

*  7.21.6.3 The printf function (p: 324)

*  7.21.6.5 The snprintf function (p: 325)

*  7.21.6.6 The sprintf function (p: 325-326)

*  K.3.5.3.1 The fprintf\_s function (p: 591)

*  K.3.5.3.3 The printf\_s function (p: 593-594)

*  K.3.5.3.5 The snprintf\_s function (p: 594-595)

*  K.3.5.3.6 The sprintf\_s function (p: 595-596)

*  C99 standard (ISO/IEC 9899:1999):

*  7.19.6.1 The fprintf function (p: 274-282)

*  7.19.6.3 The printf function (p: 290)

*  7.19.6.5 The snprintf function (p: 290-291)

*  7.19.6.6 The sprintf function (p: 291)

*  C89/C90 standard (ISO/IEC 9899:1990):

*  4.9.6.1 The fprintf function

*  4.9.6.3 The printf function

*  4.9.6.5 The sprintf function

### 参阅 ###

<table> 
 <tbody> 
 <tr> 
 <td> <a href="https://zh.cppreference.com/w/c/io/fwprintf" rel="nofollow">wprintf fwprintf swprintf wprintf_s fwprintf_s swprintf_s snwprintf_s</a> (C95) (C95) (C95) (C11) (C11) (C11) (C11) </td> 
 <td>打印格式化宽字符输出到<a href="https://zh.cppreference.com/w/c/io" rel="nofollow">stdout</a>、文件流或缓冲区&nbsp; (函数)</td> 
 </tr> 
 <tr> 
 <td> <a href="https://zh.cppreference.com/w/c/io/vfprintf" rel="nofollow">vprintf vfprintf vsprintf vsnprintf vprintf_s vfprintf_s vsprintf_s vsnprintf_s</a> (C99) (C11) (C11) (C11) (C11) </td> 
 <td>打印格式化输出到<a href="https://zh.cppreference.com/w/c/io" rel="nofollow">stdout</a>、文件流或缓冲区 使用可变参数列表&nbsp; (函数)</td> 
 </tr> 
 <tr> 
 <td> <a href="https://zh.cppreference.com/w/c/io/fputs" rel="nofollow">fputs</a> </td> 
 <td>将一个字符串写入文件流&nbsp; (函数)</td> 
 </tr> 
 <tr> 
 <td> <a href="https://zh.cppreference.com/w/c/io/fscanf" rel="nofollow">scanf fscanf sscanf scanf_s fscanf_s sscanf_s</a> (C11) (C11) (C11) </td> 
 <td>从<a href="https://zh.cppreference.com/w/c/io" rel="nofollow">stdin</a>、文件流或缓冲区读取格式化输入&nbsp; (函数)</td> 
 </tr> 
 <tr> 
 <td colspan="2"> printf,&nbsp;fprintf,&nbsp;sprintf,&nbsp;snprintf&nbsp;的&nbsp;<a href="https://zh.cppreference.com/w/cpp/io/c/fprintf" rel="nofollow">C++ 文档</a> </td> 
 </tr> 
 </tbody> 
</table>

[https_zh.cppreference.com_w_c_io_fprintf]: https://zh.cppreference.com/w/c/io/fprintf
[stdout]: https://zh.cppreference.com/w/c/io
[Link 1]: https://zh.cppreference.com/w/c/error/set_constraint_handler_s
[POSIX]: http://pubs.opengroup.org/onlinepubs/9699919799/functions/fprintf.html
[errno]: https://zh.cppreference.com/w/c/error/errno