summaryrefslogtreecommitdiff
path: root/lib/libpthread/man/getc_unlocked.3
blob: c0fa284138207e653a753894fac02121a4a5d7e5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
.\" $OpenBSD: getc_unlocked.3,v 1.3 2003/05/18 13:06:33 jmc Exp $
.\" David Leonard <d@openbsd.org>, 1999. Public domain.
.Dd March 20, 1999
.Dt GETC_UNLOCKED 3
.Os
.Sh NAME
.Nm getc_unlocked ,
.Nm getchar_unlocked
.Nd get next character from stream, efficiently
.Sh SYNOPSIS
.Fd #include <stdio.h>
.Ft int
.Fn getc_unlocked "FILE *stream"
.Ft int
.Fn getchar_unlocked
.Sh DESCRIPTION
The
.Fn getc_unlocked
and
.Fn getchar_unlocked
functions are equivalent to their locked counterparts,
.Xr getc 3
and
.Xr getchar 3 .
However,
.Fn getc_unlocked
and
.Fn getchar_unlocked
assume that the relevant stream has either been previously locked
with
.Xr flockfile 3 ,
or that it will not be accessed by any other thread.
.Sh RETURN VALUES
The return values are as described for
.Xr getc 3
and
.Xr getchar 3 .
.Sh SEE ALSO
.Xr getc 3 ,
.Xr getchar 3
.Sh STANDARDS
.Fn getc_unlocked
and
.Fn getchar_unlocked
conform to ISO/IEC 9945-1 ANSI/IEEE
.Pq Dq Tn POSIX
Std 1003.1 Second Edition 1996-07-12.