GETC_UNLOCKED(3) NEWLIB GETC_UNLOCKED(3)NAME
4.33 `getc_unlocked'--non-thread-safe version of getc (macro)
SYNOPSIS
#include <stdio.h>
int getc_unlocked(FILE *FP);
#include <stdio.h>
int _getc_unlocked_r(FILE *FP);
DESCRIPTION
`getc_unlocked' is a non-thread-safe version of `getc' declared in
`stdio.h'. `getc_unlocked' may only safely be used within a scope pro‐
tected by flockfile() (or ftrylockfile()) and funlockfile(). These
functions may safely be used in a multi-threaded program if and only if
they are called while the invoking thread owns the ( FILE *) object, as
is the case after a successful call to the flockfile() or ftrylock‐
file() functions. If threads are disabled, then `getc_unlocked' is
equivalent to `getc'.
The `_getc_unlocked_r' function is simply the reentrant version of
`get_unlocked' which passes an additional reentrancy structure pointer
argument: PTR.
RETURNS
See `getc'.
PORTABILITY
POSIX 1003.1 requires `getc_unlocked'. `getc_unlocked' may be imple‐
mented as a macro, so arguments should not have side-effects.
Supporting OS subroutines required: `close', `fstat', `isatty',
`lseek', `read', `sbrk', `write'.
SEE ALSOgetc_unlocked is part of the library. The full documentation for is
maintained as a Texinfo manual. If info and are properly installed at
your site, the command
info
will give you access to the complete manual.
NEWLIB April 2010 GETC_UNLOCKED(3)