The Open Group Base Specifications Issue 7, 2018 edition
IEEE Std 1003.1-2017 (Revision of IEEE Std 1003.1-2008)
Copyright © 2001-2018 IEEE and The Open Group
NAME
getchar - get a byte from a stdin stream
SYNOPSIS
#include <stdio.h>
int getchar(void);
DESCRIPTION
[CX] ![[Option Start]](../images/opt-start.gif)
The functionality described on this reference page is aligned with the ISO C standard. Any conflict between the
requirements described here and the ISO C standard is unintentional. This volume of POSIX.1-2017 defers to the ISO C
standard.
![[Option End]](../images/opt-end.gif)
The getchar() function shall be equivalent to getc(stdin).
RETURN VALUE
Refer to fgetc.
ERRORS
Refer to fgetc.
The following sections are informative.
EXAMPLES
None.
APPLICATION USAGE
If the integer value returned by getchar() is stored into a variable of type char and then compared against the
integer constant EOF, the comparison may never succeed, because sign-extension of a variable of type char on widening to
integer is implementation-defined.
RATIONALE
None.
FUTURE DIRECTIONS
None.
SEE ALSO
Standard I/O Streams, getc
XBD <stdio.h>
CHANGE HISTORY
First released in Issue 1. Derived from Issue 1 of the SVID.
Issue 7
POSIX.1-2008, Technical Corrigendum 1, XSH/TC1-2008/0236 [14] is applied.
End of informative text.
return to top of page
UNIX ® is a registered Trademark of The Open Group.
POSIX ® is a registered Trademark of The IEEE.
Copyright © 2001-2018 IEEE and The Open Group, All Rights Reserved
[ Main Index | XBD | XSH | XCU | XRAT
]