X-Git-Url: https://git.saurik.com/apple/libc.git/blobdiff_plain/9385eb3d10ebe5eb398c52040ec3dbfba9b0cdcf..refs/heads/master:/stdio/FreeBSD/getwc.3 diff --git a/stdio/FreeBSD/getwc.3 b/stdio/FreeBSD/getwc.3 index fd6fcdb..d994aad 100644 --- 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. -.\" 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. @@ -36,16 +32,16 @@ .\" 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 -.Nd get next wide-character from input stream +.Nd get next wide character from input stream .Sh LIBRARY .Lb libc .Sh SYNOPSIS @@ -56,12 +52,12 @@ .Ft wint_t .Fn getwc "FILE *stream" .Ft wint_t -.Fn getwchar +.Fn getwchar "void" .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 . @@ -79,8 +75,14 @@ is equivalent to .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 -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, @@ -104,13 +106,14 @@ until the condition is cleared with .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 , -.Fn getwc +.Fn getwc , and .Fn getwchar functions