Manpage of PUTC_UNLOCKED

PUTC_UNLOCKED

Section: NEWLIB (3)
Updated: 2005 Feb 23
Index Return to Main Contents

NAME

3.32 `putc_unlocked'--non-thread-safe version of putc (macro)

DESCRIPTION

`putc_unlocked' is a non-thread-safe version of `putc' declared in `stdio.h'. `putc_unlocked' may only safely be used within a scope protected 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 ftrylockfile() functions. If threads are disabled, then `putc_unlocked' is equivalent to `putc'.

RETURNS

See `putc'.

PORTABILITY

POSIX 1003.1 requires `putc_unlocked'. `putc_unlocked' may be implemented as a macro, so arguments should not have side-effects.

Supporting OS subroutines required: `close', `fstat', `isatty', `lseek', `read', `sbrk', `write'.