Namespaces
Variants
Views
Actions

Difference between revisions of "cpp/io/c/fputc"

From cppreference.com
< cpp‎ | io‎ | c
m (Text replace - "{{see also}}" to "===See also===")
m ({{c}})
 
(16 intermediate revisions by 9 users not shown)
Line 1: Line 1:
−
{{cpp/title | fputc | putc}}
+
{{cpp/title|fputc|putc}}
−
{{cpp/io/c/sidebar}}
+
{{cpp/io/c/navbar}}
−
{{ddcl | header=cstdio |
+
{{ddcl|header=cstdio|
−
int fputc( int ch, FILE *stream );
+
int fputc( int ch, std::FILE* stream );
−
int putc( int ch, FILE *stream );
+
int putc( int ch, std::FILE* stream );
 
}}
 
}}
−
Writes a character {{tt|ch}} to the given output stream {{tt|stream}}. {{cpp|putc()}} function may be implemented as a macro.  
+
 
−
<!-- ======== -->
+
Writes a character {{c|ch}} to the given output stream {{c|stream}}.
 +
 
 +
Internally, the character is converted to {{c|unsigned char}} just before being written.
 +
 
 +
In C, [[c/io/putc|{{c|putc()}}]] may be implemented as a macro, which is disallowed in C++. Therefore, calls to {{c|std::fputc()}} and {{c|std::putc()}} always have the same effect.
 +
 
 
===Parameters===
 
===Parameters===
−
{{param list begin}}
+
{{par begin}}
−
{{param list item | ch | character to be written}}
+
{{par|ch|character to be written}}
−
{{param list item | stream | the output stream}}
+
{{par|stream|output stream}}
−
{{param list end}}
+
{{par end}}
  
−
<!-- ======== -->
 
 
===Return value===
 
===Return value===
 +
On success, returns the written character.
  
−
{{tt|ch}} on success, {{cpp|EOF}} on failure.
+
On failure, returns {{lc|EOF}} and sets the ''error'' indicator (see {{lc|std::ferror()}}) on {{lc|stream}}.
 +
 
 +
===Example===
 +
{{example
 +
|code=
 +
#include <cstdio>
 +
 
 +
int main()
 +
{
 +
    for (char c = 'a'; c != 'z'; c++)
 +
        std::putc(c, stdout);
 +
 
 +
    // putchar's return value is not equal to the argument
 +
    int r = 0x102A;
 +
    std::printf("\nr = 0x%x\n", r);
 +
 
 +
    r = std::putchar(r);
 +
    std::printf("\nr = 0x%x\n", r);
 +
}
 +
|p=true
 +
|output=
 +
abcdefghijklmnopqrstuvwxy
 +
r = 0x102A
 +
*
 +
r = 0x2A
 +
}}
  
−
<!-- ======== -->
 
 
===See also===
 
===See also===
−
{{dcl list begin}}
+
{{dsc begin}}
−
{{dcl list template | cpp/io/c/dcl list putchar}}
+
{{dsc inc|cpp/io/c/dsc putchar}}
−
{{dcl list end}}
+
{{dsc see c|c/io/fputc|fputc|putc}}
 +
{{dsc end}}
 +
 
 +
{{langlinks|de|es|fr|it|ja|pt|ru|zh}}

Latest revision as of 03:31, 29 September 2023

 
C++
 
Input/output library
 
C-style I/O
Types and objects
Functions
File access
Direct input/output
Unformatted input/output
fputcputc
(until C++14)
Formatted input
(C++11)(C++11)(C++11)    
(C++11)(C++11)(C++11)    
 
Defined in header <cstdio>
int fputc( int ch, std::FILE* stream );
int putc( int ch, std::FILE* stream );

Writes a character ch to the given output stream stream.

Internally, the character is converted to unsigned char just before being written.

In C, putc() may be implemented as a macro, which is disallowed in C++. Therefore, calls to std::fputc() and std::putc() always have the same effect.

Contents

[edit] Parameters

ch - character to be written
stream - output stream

[edit] Return value

On success, returns the written character.

On failure, returns EOF and sets the error indicator (see std::ferror()) on stream.

[edit] Example

Run this code
#include <cstdio>
 
int main()
{
    for (char c = 'a'; c != 'z'; c++)
        std::putc(c, stdout);
 
    // putchar's return value is not equal to the argument
    int r = 0x102A;
    std::printf("\nr = 0x%x\n", r);
 
    r = std::putchar(r);
    std::printf("\nr = 0x%x\n", r);
}

Possible output: 

abcdefghijklmnopqrstuvwxy
r = 0x102A
*
r = 0x2A

[edit] See also

 writes a character to stdout
(function) [edit]
C documentation for fputc, putc
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/io/c/fputc&oldid=159797"