<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
lang="en" dir="ltr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>
snprintf [C++ Reference]
</title>
<meta name="generator" content="DokuWiki Release 2009-12-25c "Lemming"" />
<meta name="robots" content="index,follow" />
<meta name="date" content="2008-11-11T05:16:38-0800" />
<meta name="keywords" content="c,io,snprintf" />
<link rel="search" type="application/opensearchdescription+xml" href="/wiki/lib/exe/opensearch.php" title="C++ Reference" />
<link rel="start" href="/wiki/" />
<link rel="contents" href="/wiki/c/io/snprintf?do=index" title="Index" />
<link rel="alternate" type="application/rss+xml" title="Recent Changes" href="/wiki/feed.php" />
<link rel="alternate" type="application/rss+xml" title="Current Namespace" href="/wiki/feed.php?mode=list&ns=c:io" />
<link rel="edit" title="Edit this page" href="/wiki/c/io/snprintf?do=edit" />
<link rel="alternate" type="text/html" title="Plain HTML" href="/wiki/_export/xhtml/c/io/snprintf" />
<link rel="alternate" type="text/plain" title="Wiki Markup" href="/wiki/_export/raw/c/io/snprintf" />
<link rel="canonical" href="http://www.cppreference.com/wiki/c/io/snprintf" />
<link rel="stylesheet" media="all" type="text/css" href="/wiki/lib/exe/css.php?s=all&t=custom1&tseed=1272971091" />
<link rel="stylesheet" media="screen" type="text/css" href="/wiki/lib/exe/css.php?t=custom1&tseed=1272971091" />
<link rel="stylesheet" media="print" type="text/css" href="/wiki/lib/exe/css.php?s=print&t=custom1&tseed=1272971091" />
<script type="text/javascript" charset="utf-8" ><!--//--><![CDATA[//><!--
var NS='c:io';var JSINFO = {"id":"c:io:snprintf","namespace":"c:io"};
//--><!]]></script>
<script type="text/javascript" charset="utf-8" src="/wiki/lib/exe/js.php?tseed=1272971091" ></script>
<link rel="shortcut icon" href="/wiki/lib/tpl/custom1/images/favicon.png" />
</head>
<body>
<div class="dokuwiki">
<div class="stylehead">
<div class="header">
<div class="pagename">
[[<a href="../../c/io/snprintf.html" title="Backlinks">snprintf</a>]]
</div>
<div class="logo">
<a href="http://www.cppreference.com" name="dokuwiki__top" id="dokuwiki__top" accesskey="h" title="[ALT+H]">C++ Reference</a> </div>
<div class="clearer"></div>
</div>
<div class="breadcrumbs">
<span class="bchead">You are here: </span><a href="../../start.html" title="start">C++ Reference</a> » <a href="../../c/start.html" title="c:start">The Standard C Library</a> » <a href="../../c/io/start.html" title="c:io:start">Standard C I/O</a> » <a href="../../c/io/snprintf.html" title="c:io:snprintf">snprintf</a> </div>
</div>
<div class="plugin_translation"><span>Translations of this page<sup><a href="../../localization.html" class="wikilink1" title="localization">?</a></sup>:</span> <ul> <li><div class="li"><span class="curid"><a href="../../c/io/snprintf.html" class="wikilink1" title="c:io:snprintf">en</a></span></div></li> <li><div class="li"><a href="../../br-pt/c/io/snprintf.html" class="wikilink2" title="br-pt:c:io:snprintf" rel="nofollow">br-pt</a></div></li> <li><div class="li"><a href="../../cn/c/io/snprintf.html" class="wikilink2" title="cn:c:io:snprintf" rel="nofollow">cn</a></div></li> <li><div class="li"><a href="../../cz/c/io/snprintf.html" class="wikilink2" title="cz:c:io:snprintf" rel="nofollow">cz</a></div></li> <li><div class="li"><a href="../../de/c/io/snprintf.html" class="wikilink2" title="de:c:io:snprintf" rel="nofollow">de</a></div></li> <li><div class="li"><a href="../../es/c/io/snprintf.html" class="wikilink2" title="es:c:io:snprintf" rel="nofollow">es</a></div></li> <li><div class="li"><a href="../../fr/c/io/snprintf.html" class="wikilink1" title="fr:c:io:snprintf">fr</a></div></li> <li><div class="li"><a href="../../it/c/io/snprintf.html" class="wikilink2" title="it:c:io:snprintf" rel="nofollow">it</a></div></li> <li><div class="li"><a href="../../jp/c/io/snprintf.html" class="wikilink1" title="jp:c:io:snprintf">jp</a></div></li> <li><div class="li"><a href="../../nl/c/io/snprintf.html" class="wikilink2" title="nl:c:io:snprintf" rel="nofollow">nl</a></div></li> <li><div class="li"><a href="../../pl/c/io/snprintf.html" class="wikilink2" title="pl:c:io:snprintf" rel="nofollow">pl</a></div></li> <li><div class="li"><a href="../../ro/c/io/snprintf.html" class="wikilink2" title="ro:c:io:snprintf" rel="nofollow">ro</a></div></li> <li><div class="li"><a href="../../ru/c/io/snprintf.html" class="wikilink2" title="ru:c:io:snprintf" rel="nofollow">ru</a></div></li> <li><div class="li"><a href="../../sk/c/io/snprintf.html" class="wikilink2" title="sk:c:io:snprintf" rel="nofollow">sk</a></div></li> <li><div class="li"><a href="../../tr/c/io/snprintf.html" class="wikilink2" title="tr:c:io:snprintf" rel="nofollow">tr</a></div></li> <li><div class="li"><a href="../../tw/c/io/snprintf.html" class="wikilink2" title="tw:c:io:snprintf" rel="nofollow">tw</a></div></li></ul></div>
<div class="page">
<script src="http://www.google-analytics.com/urchin.js" type="text/javascript">
</script>
<script type="text/javascript">
_uacct = "UA-2828341-1";
urchinTracker();
</script>
<!-- wikipage start -->
<h2><a name="snprintf" id="snprintf">snprintf</a></h2>
<div class="level2">
<p>
Syntax:
</p>
<pre class="c code c++" style="font-family:monospace;"> <span class="co2">#include <cstdio></span>
<span class="kw4">int</span> snprintf<span class="br0">(</span> <span class="kw4">char</span> <span class="sy0">*</span>buffer<span class="sy0">,</span> <span class="kw4">int</span> buff_size<span class="sy0">,</span> <span class="kw4">const</span> <span class="kw4">char</span> <span class="sy0">*</span>format<span class="sy0">,</span> ... <span class="br0">)</span><span class="sy0">;</span></pre>
<p>
The snprintf() function is just like sprintf(), except that the length of the buffer is given. This prevents buffer overflows.
</p>
<p>
The return value is the number of characters written. If the output was truncated due to buff_size limit then the return value is the number of characters (not including the trailing '\0') which would have been written to the final string if enough space had been available.
</p>
<p>
Related Topics: <a href="../../c/io/sprintf.html" class="wikilink1" title="c:io:sprintf">sprintf</a>, <a href="../../c/string/atof.html" class="wikilink1" title="c:string:atof">atof</a>, <a href="../../c/string/atoi.html" class="wikilink1" title="c:string:atoi">atoi</a>, <a href="../../c/string/atol.html" class="wikilink1" title="c:string:atol">atol</a>, <a href="../../c/io/fprintf.html" class="wikilink1" title="c:io:fprintf">fprintf</a>, <a href="../../c/io/printf.html" class="wikilink1" title="c:io:printf">printf</a>
</p>
</div>
<div class="secedit"><form class="button btn_secedit" method="post" action="/wiki/c/io/snprintf"><div class="no"><input type="hidden" name="do" value="edit" /><input type="hidden" name="lines" value="3-" /><input type="hidden" name="rev" value="1226409398" /><input type="submit" value="Edit" class="button" title="snprintf" /></div></form></div>
<!-- wikipage stop -->
</div>
<div class="clearer"> </div>
<div class="stylefoot">
<div class="meta">
<div class="user">
</div>
<!--
<div class="doc">
c/io/snprintf.txt · Last modified: 11/11/2008 05:16 by 213.120.90.67 </div>
-->
</div>
<div class="bar" id="bar__bottom">
<div class="bar-left" id="bar__bottomleft">
<a href="../../c/io/snprintf.html" class="action edit" accesskey="e" rel="nofollow">Edit this page</a> •
<a href="../../c/io/snprintf.html" class="action revisions" accesskey="o" rel="nofollow">Old revisions</a> </div>
<div class="bar-right" id="bar__bottomright">
•
•
•
<a href="../../c/io/snprintf.html" class="action login" rel="nofollow">Login</a> •
<a href="../../c/io/snprintf.html" class="action index" accesskey="x" rel="nofollow">Index</a> •
<a href="../../c/io/snprintf.html" class="action recent" accesskey="r" rel="nofollow">Recent changes</a> •
<a href="../../feed.php.html" title="Recent changes RSS feed">RSS</a> •
<a href='http://creativecommons.org/licenses/by/3.0/us/' title='Creative Commons license'>cc</a> •
<form action="/wiki/" accept-charset="utf-8" class="search" id="dw__search"><div class="no"><input type="hidden" name="do" value="search" /><input type="text" id="qsearch__in" accesskey="f" name="id" class="edit" title="[ALT+F]" /><input type="submit" value="Search" class="button" title="Search" /><div id="qsearch__out" class="ajax_qsearch JSpopup"></div></div></form>
</div>
<div class="clearer"></div>
</div>
</div>
</div>
<div class="no"><img src="/wiki/lib/exe/indexer.php?id=c%3Aio%3Asnprintf&1273193751" width="1" height="1" alt="" /></div>
</body>
</html>