Loading...
--- Libc/Libc-583/stdio/putc.3
+++ Libc/Libc-262/stdio/putc.3
@@ -34,17 +34,15 @@
.\" SUCH DAMAGE.
.\"
.\" @(#)putc.3 8.1 (Berkeley) 6/4/93
-.\" $FreeBSD: src/lib/libc/stdio/putc.3,v 1.15 2004/03/17 12:46:17 tjr Exp $
+.\" $FreeBSD: src/lib/libc/stdio/putc.3,v 1.8 2001/10/01 16:08:59 ru Exp $
.\"
-.Dd January 10, 2003
+.Dd June 4, 1993
.Dt PUTC 3
.Os
.Sh NAME
.Nm fputc ,
.Nm putc ,
-.Nm putc_unlocked ,
.Nm putchar ,
-.Nm putchar_unlocked ,
.Nm putw
.Nd output a character or word to a stream
.Sh LIBRARY
@@ -52,33 +50,13 @@
.Sh SYNOPSIS
.In stdio.h
.Ft int
-.Fo fputc
-.Fa "int c"
-.Fa "FILE *stream"
-.Fc
+.Fn fputc "int c" "FILE *stream"
.Ft int
-.Fo putc
-.Fa "int c"
-.Fa "FILE *stream"
-.Fc
+.Fn putc "int c" "FILE *stream"
.Ft int
-.Fo putc_unlocked
-.Fa "int c"
-.Fa "FILE *stream"
-.Fc
+.Fn putchar "int c"
.Ft int
-.Fo putchar
-.Fa "int c"
-.Fc
-.Ft int
-.Fo putchar_unlocked
-.Fa "int c"
-.Fc
-.Ft int
-.Fo putw
-.Fa "int w"
-.Fa "FILE *stream"
-.Fc
+.Fn putw "int w" "FILE *stream"
.Sh DESCRIPTION
The
.Fn fputc
@@ -102,44 +80,25 @@
.Pp
The
.Fn putchar
-function
+macro
is identical to
.Fn putc
with an output stream of
-.Dv stdout .
+.Em stdout .
.Pp
The
.Fn putw
function
writes the specified
-.Vt int
+.Em int
to the named output
.Fa stream .
-.Pp
-The
-.Fn putc_unlocked
-and
-.Fn putchar_unlocked
-functions are equivalent to
+.Sh RETURN VALUES
+The functions,
+.Fn fputc ,
.Fn putc
and
.Fn putchar
-respectively,
-except that the caller is responsible for locking the stream
-with
-.Xr flockfile 3
-before calling them.
-These functions may be used to avoid the overhead of locking the stream
-for each character, and to avoid output being interspersed from multiple
-threads writing to the same stream.
-.Sh RETURN VALUES
-The functions,
-.Fn fputc ,
-.Fn putc ,
-.Fn putchar ,
-.Fn putc_unlocked ,
-and
-.Fn putchar_unlocked
return the character written.
If an error occurs, the value
.Dv EOF
@@ -154,10 +113,8 @@
or if an attempt is made to write a read-only stream.
.Sh SEE ALSO
.Xr ferror 3 ,
-.Xr flockfile 3 ,
.Xr fopen 3 ,
.Xr getc 3 ,
-.Xr putwc 3 ,
.Xr stdio 3
.Sh STANDARDS
The functions
@@ -167,19 +124,13 @@
.Fn putchar ,
conform to
.St -isoC .
-The
-.Fn putc_unlocked
-and
-.Fn putchar_unlocked
-functions conform to
-.St -p1003.1-2001 .
A function
.Fn putw
function appeared in
.At v6 .
.Sh BUGS
The size and byte order of an
-.Vt int
+.Em int
varies from one machine to another, and
.Fn putw
is not recommended for portable applications.