1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>snprintf</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="The Linux Kernel API"><link rel="up" href="libc.html#idp1122555668" title="String Conversions"><link rel="prev" href="API-vscnprintf.html" title="vscnprintf"><link rel="next" href="API-scnprintf.html" title="scnprintf"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span class="phrase">snprintf</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-vscnprintf.html">Prev</a>&#160;</td><th width="60%" align="center">String Conversions</th><td width="20%" align="right">&#160;<a accesskey="n" href="API-scnprintf.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="API-snprintf"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>snprintf &#8212; 
2     Format a string and place it in a buffer
3 </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">int <b class="fsfunc">snprintf </b>(</code></td><td>char * <var class="pdparam">buf</var>, </td></tr><tr><td>&#160;</td><td>size_t <var class="pdparam">size</var>, </td></tr><tr><td>&#160;</td><td>const char * <var class="pdparam">fmt</var>, </td></tr><tr><td>&#160;</td><td> <var class="pdparam">...</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div></div><div class="refsect1"><a name="idp1122631844"></a><h2>Arguments</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><em class="parameter"><code>buf</code></em></span></dt><dd><p>
4     The buffer to place the result into
5    </p></dd><dt><span class="term"><em class="parameter"><code>size</code></em></span></dt><dd><p>
6     The size of the buffer, including the trailing null space
7    </p></dd><dt><span class="term"><em class="parameter"><code>fmt</code></em></span></dt><dd><p>
8     The format string to use
9     @...: Arguments for the format string
10    </p></dd><dt><span class="term"><em class="parameter"><code>...</code></em></span></dt><dd><p>
11     variable arguments
12    </p></dd></dl></div></div><div class="refsect1"><a name="idp1122636492"></a><h2>Description</h2><p>
13   The return value is the number of characters which would be
14   generated for the given input, excluding the trailing null,
15   as per ISO C99.  If the return is greater than or equal to
16   <em class="parameter"><code>size</code></em>, the resulting string is truncated.
17   </p><p>
18
19   See the <code class="function">vsnprintf</code> documentation for format string extensions over C99.
20</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-vscnprintf.html">Prev</a>&#160;</td><td width="20%" align="center"><a accesskey="u" href="libc.html#idp1122555668">Up</a></td><td width="40%" align="right">&#160;<a accesskey="n" href="API-scnprintf.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span class="phrase">vscnprintf</span>&#160;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">&#160;<span class="phrase">scnprintf</span></td></tr></table></div></body></html>
21