Libc-1439.100.3.tar.gz

[apple/libc.git] / stdio / FreeBSD / getwc.3

diff --git a/stdio/FreeBSD/getwc.3 b/stdio/FreeBSD/getwc.3
index fd6fcdbfffa9bd84f637d4870fc18698f03eb1e5..d994aadba1cf5b273b746185950969011cf7f9d1 100644 (file)
--- a/stdio/FreeBSD/getwc.3
+++ b/stdio/FreeBSD/getwc.3
@@ -15,10 +15,6 @@
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.
 .\" 2. Redistributions in binary form must reproduce the above copyright
 .\"    notice, this list of conditions and the following disclaimer in the
 .\"    documentation and/or other materials provided with the distribution.

-.\" 3. All advertising materials mentioning features or use of this software
-.\"    must display the following acknowledgement:
-.\"    This product includes software developed by the University of
-.\"    California, Berkeley and its contributors.

 .\" 4. Neither the name of the University nor the names of its contributors
 .\"    may be used to endorse or promote products derived from this software
 .\"    without specific prior written permission.
 .\" 4. Neither the name of the University nor the names of its contributors
 .\"    may be used to endorse or promote products derived from this software
 .\"    without specific prior written permission.


@@ -36,16 +32,16 @@
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)getc.3     8.1 (Berkeley) 6/4/93
 .\" SUCH DAMAGE.
 .\"
 .\"     @(#)getc.3     8.1 (Berkeley) 6/4/93

-.\" $FreeBSD: src/lib/libc/stdio/getwc.3,v 1.5 2002/12/04 18:57:45 ru Exp $
+.\" $FreeBSD: src/lib/libc/stdio/getwc.3,v 1.8 2007/01/09 00:28:06 imp Exp $

 .\"
 .\"

-.Dd October 10, 2002
+.Dd March 3, 2004

 .Dt GETWC 3
 .Os
 .Sh NAME
 .Nm fgetwc ,
 .Nm getwc ,
 .Nm getwchar
 .Dt GETWC 3
 .Os
 .Sh NAME
 .Nm fgetwc ,
 .Nm getwc ,
 .Nm getwchar

-.Nd get next wide-character from input stream
+.Nd get next wide character from input stream

 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS


@@ -56,12 +52,12 @@
 .Ft wint_t
 .Fn getwc "FILE *stream"
 .Ft wint_t
 .Ft wint_t
 .Fn getwc "FILE *stream"
 .Ft wint_t

-.Fn getwchar
+.Fn getwchar "void"

 .Sh DESCRIPTION
 The
 .Fn fgetwc
 function
 .Sh DESCRIPTION
 The
 .Fn fgetwc
 function

-obtains the next input wide-character (if present) from the stream pointed at by
+obtains the next input wide character (if present) from the stream pointed at by

 .Fa stream ,
 or the next character pushed back on the stream via
 .Xr ungetwc 3 .
 .Fa stream ,
 or the next character pushed back on the stream via
 .Xr ungetwc 3 .


@@ -79,8 +75,14 @@ is equivalent to
 .Fn getwc
 with the argument
 .Dv stdin .
 .Fn getwc
 with the argument
 .Dv stdin .

+.Pp
+Extended locale versions of these functions are documented in
+.Xr getwc_l 3 .
+See
+.Xr xlocale 3
+for more information.

 .Sh RETURN VALUES
 .Sh RETURN VALUES

-If successful, these routines return the next wide-character
+If successful, these routines return the next wide character

 from the
 .Fa stream .
 If the stream is at end-of-file or a read error occurs,
 from the
 .Fa stream .
 If the stream is at end-of-file or a read error occurs,


@@ -104,13 +106,14 @@ until the condition is cleared with
 .Xr fopen 3 ,
 .Xr fread 3 ,
 .Xr getc 3 ,
 .Xr fopen 3 ,
 .Xr fread 3 ,
 .Xr getc 3 ,

+.Xr getwc_l ,

 .Xr putwc 3 ,
 .Xr stdio 3 ,
 .Xr ungetwc 3
 .Sh STANDARDS
 The
 .Fn fgetwc ,
 .Xr putwc 3 ,
 .Xr stdio 3 ,
 .Xr ungetwc 3
 .Sh STANDARDS
 The
 .Fn fgetwc ,

-.Fn getwc
+.Fn getwc ,

 and
 .Fn getwchar
 functions
 and
 .Fn getwchar
 functions