visus
/
toolchain-gcc-arm-embedded

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ -->
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>putc (The Red Hat newlib C Library)</title>

<meta name="description" content="putc (The Red Hat newlib C Library)">
<meta name="keywords" content="putc (The Red Hat newlib C Library)">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<link href="index.html#Top" rel="start" title="Top">
<link href="Document-Index.html#Document-Index" rel="index" title="Document Index">
<link href="Document-Index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="Stdio.html#Stdio" rel="up" title="Stdio">
<link href="putc_005funlocked.html#putc_005funlocked" rel="next" title="putc_unlocked">
<link href="perror.html#perror" rel="prev" title="perror">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>


</head>

<body lang="en">
<a name="putc"></a>
<div class="header">
<p>
Next: <a href="putc_005funlocked.html#putc_005funlocked" accesskey="n" rel="next">putc_unlocked</a>, Previous: <a href="perror.html#perror" accesskey="p" rel="prev">perror</a>, Up: <a href="Stdio.html#Stdio" accesskey="u" rel="up">Stdio</a> &nbsp; [<a href="Document-Index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Document-Index.html#Document-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="putc_002d_002d_002dwrite-a-character-_0028macro_0029"></a>
<h3 class="section">4.45 <code>putc</code>&mdash;write a character (macro)</h3>
<a name="index-putc"></a>
<a name="index-_005fputc_005fr"></a>
<p><strong>Synopsis</strong>
</p><div class="example">
<pre class="example">#include &lt;stdio.h&gt;
int putc(int <var>ch</var>, FILE *<var>fp</var>);

#include &lt;stdio.h&gt;
int _putc_r(struct _reent *<var>ptr</var>, int <var>ch</var>, FILE *<var>fp</var>);

</pre></div>
<p><strong>Description</strong><br>
<code>putc</code> is a macro, defined in <code>stdio.h</code>.  <code>putc</code>
writes the argument <var>ch</var> to the file or stream identified by
<var>fp</var>, after converting it from an <code>int</code> to an <code>unsigned char</code>.
</p>
<p>If the file was opened with append mode (or if the stream cannot
support positioning), then the new character goes at the end of the
file or stream.  Otherwise, the new character is written at the
current value of the position indicator, and the position indicator
advances by one.
</p>
<p>For a subroutine version of this macro, see <code>fputc</code>.
</p>
<p>The <code>_putc_r</code> function is simply the reentrant version of
<code>putc</code> that takes an additional reentrant structure argument: <var>ptr</var>.
</p>
<br>
<p><strong>Returns</strong><br>
If successful, <code>putc</code> returns its argument <var>ch</var>.  If an error
intervenes, the result is <code>EOF</code>.  You can use &lsquo;<code>ferror(<var>fp</var>)</code>&rsquo; to
query for errors.
</p>
<br>
<p><strong>Portability</strong><br>
ANSI C requires <code>putc</code>; it suggests, but does not require, that
<code>putc</code> be implemented as a macro.  The standard explicitly permits
macro implementations of <code>putc</code> to use the <var>fp</var> argument more than once;
therefore, in a portable program, you should not use an expression
with side effects as this argument.
</p>
<p>Supporting OS subroutines required: <code>close</code>, <code>fstat</code>, <code>isatty</code>,
<code>lseek</code>, <code>read</code>, <code>sbrk</code>, <code>write</code>.
</p>
<br>


</body>
</html>