diff options
Diffstat (limited to 'man3/fgetws.3')
-rw-r--r-- | man3/fgetws.3 | 8 |
1 files changed, 4 insertions, 4 deletions
diff --git a/man3/fgetws.3 b/man3/fgetws.3 index b2b0eed9..09a0fdfe 100644 --- a/man3/fgetws.3 +++ b/man3/fgetws.3 @@ -22,7 +22,7 @@ fgetws \- read a wide character string from a FILE stream .BI "wchar_t *fgetws(wchar_t *" ws ", int " n ", FILE *" stream ); .fi .SH DESCRIPTION -The \fBfgetws\fP function is the wide-character equivalent of the \fBfgets\fP +The \fBfgetws\fP() function is the wide-character equivalent of the \fBfgets\fP function. It reads a string of at most \fIn-1\fP wide characters into the wide-character array pointed to by \fIws\fP, and adds a terminating L'\\0' character. It stops reading wide characters after it has encountered and @@ -34,16 +34,16 @@ characters at \fIws\fP. For a non-locking counterpart, see .BR unlocked_stdio (3). .SH "RETURN VALUE" -The \fBfgetws\fP function, if successful, returns \fIws\fP. If end of stream +The \fBfgetws\fP() function, if successful, returns \fIws\fP. If end of stream was already reached or if an error occurred, it returns NULL. .SH "CONFORMING TO" ISO/ANSI C, UNIX98 .SH NOTES -The behaviour of \fBfgetws\fP depends on the LC_CTYPE category of the +The behaviour of \fBfgetws\fP() depends on the LC_CTYPE category of the current locale. .PP In the absence of additional information passed to the fopen call, it is -reasonable to expect that \fBfgetws\fP will actually read a multibyte string +reasonable to expect that \fBfgetws\fP() will actually read a multibyte string from the stream and then convert it to a wide character string. .PP This function is unreliable, because it does not permit to deal properly with |