xref: /openbsd-src/lib/libpthread/man/getc_unlocked.3 (revision 31b5c4b0770b2e3cbd0f9123d4431f396b0d7f86)
1*31b5c4b0Sschwarze.\" $OpenBSD: getc_unlocked.3,v 1.6 2015/09/14 13:45:25 schwarze Exp $
20dce2936Sd.\" David Leonard <d@openbsd.org>, 1999. Public domain.
3*31b5c4b0Sschwarze.Dd $Mdocdate: September 14 2015 $
40dce2936Sd.Dt GETC_UNLOCKED 3
57f3168a2Saaron.Os
60dce2936Sd.Sh NAME
70dce2936Sd.Nm getc_unlocked ,
80dce2936Sd.Nm getchar_unlocked
90dce2936Sd.Nd get next character from stream, efficiently
100dce2936Sd.Sh SYNOPSIS
1186f9d4cdStedu.In stdio.h
120dce2936Sd.Ft int
130dce2936Sd.Fn getc_unlocked "FILE *stream"
140dce2936Sd.Ft int
15*31b5c4b0Sschwarze.Fn getchar_unlocked void
160dce2936Sd.Sh DESCRIPTION
170dce2936SdThe
180dce2936Sd.Fn getc_unlocked
190dce2936Sdand
200dce2936Sd.Fn getchar_unlocked
210dce2936Sdfunctions are equivalent to their locked counterparts,
220dce2936Sd.Xr getc 3
230dce2936Sdand
240dce2936Sd.Xr getchar 3 .
250dce2936SdHowever,
260dce2936Sd.Fn getc_unlocked
270dce2936Sdand
280dce2936Sd.Fn getchar_unlocked
2979ad192cSjmcassume that the relevant stream has either been previously locked
300dce2936Sdwith
310dce2936Sd.Xr flockfile 3 ,
320dce2936Sdor that it will not be accessed by any other thread.
330dce2936Sd.Sh RETURN VALUES
340dce2936SdThe return values are as described for
350dce2936Sd.Xr getc 3
360dce2936Sdand
370dce2936Sd.Xr getchar 3 .
380dce2936Sd.Sh SEE ALSO
390dce2936Sd.Xr getc 3 ,
400dce2936Sd.Xr getchar 3
410dce2936Sd.Sh STANDARDS
420dce2936Sd.Fn getc_unlocked
430dce2936Sdand
440dce2936Sd.Fn getchar_unlocked
450dce2936Sdconform to ISO/IEC 9945-1 ANSI/IEEE
460dce2936Sd.Pq Dq Tn POSIX
470dce2936SdStd 1003.1 Second Edition 1996-07-12.
48