| | 1 | --- fgetws.3 2003-05-20 15:22:41.000000000 -0700 |
| | 2 | +++ fgetws.3.edit 2006-08-12 09:44:23.000000000 -0700 |
| | 3 | @@ -41,7 +41,8 @@ |
| | 4 | .Dt FGETWS 3 |
| | 5 | .Os |
| | 6 | .Sh NAME |
| | 7 | -.Nm fgetws |
| | 8 | +.Nm fgetws , |
| | 9 | +.Nm fgetws_l |
| | 10 | .Nd get a line of wide characters from a stream |
| | 11 | .Sh LIBRARY |
| | 12 | .Lb libc |
| | 13 | @@ -49,7 +50,21 @@ |
| | 14 | .In stdio.h |
| | 15 | .In wchar.h |
| | 16 | .Ft "wchar_t *" |
| | 17 | -.Fn fgetws "wchar_t * restrict ws" "int n" "FILE * restrict fp" |
| | 18 | +.Fo fgetws |
| | 19 | +.Fa "wchar_t *restrict ws" |
| | 20 | +.Fa "int n" |
| | 21 | +.Fa "FILE *restrict stream" |
| | 22 | +.Fc |
| | 23 | +.In stdio.h |
| | 24 | +.In wchar.h |
| | 25 | +.In xlocale.h |
| | 26 | +.Ft "wchar_t *" |
| | 27 | +.Fo fgetws_l |
| | 28 | +.Fa "wchar_t *restrict ws" |
| | 29 | +.Fa "int n" |
| | 30 | +.Fa "FILE *restrict stream" |
| | 31 | +.Fa "locale_t loc" |
| | 32 | +.Fc |
| | 33 | .Sh DESCRIPTION |
| | 34 | The |
| | 35 | .Fn fgetws |
| | 36 | @@ -57,7 +72,7 @@ |
| | 37 | reads at most one less than the number of characters specified by |
| | 38 | .Fa n |
| | 39 | from the given |
| | 40 | -.Fa fp |
| | 41 | +.Fa stream |
| | 42 | and stores them in the wide character string |
| | 43 | .Fa ws . |
| | 44 | Reading stops when a newline character is found, |
| | 45 | @@ -66,6 +81,14 @@ |
| | 46 | If any characters are read and there is no error, a |
| | 47 | .Ql \e0 |
| | 48 | character is appended to end the string. |
| | 49 | +.Pp |
| | 50 | +While the |
| | 51 | +.Fn fgetws |
| | 52 | +function uses the current locale, the |
| | 53 | +.Fn fgetws_l |
| | 54 | +function may be passed a locale directly. See |
| | 55 | +.Xr xlocale 3 |
| | 56 | +for more information. |
| | 57 | .Sh RETURN VALUES |
| | 58 | Upon successful completion, |
| | 59 | .Fn fgetws |
| | 60 | @@ -84,7 +107,8 @@ |
| | 61 | The |
| | 62 | .Fn fgetws |
| | 63 | function |
| | 64 | -does not distinguish between end-of-file and error, and callers must use |
| | 65 | +does not distinguish between end-of-file and error; |
| | 66 | +callers must use |
| | 67 | .Xr feof 3 |
| | 68 | and |
| | 69 | .Xr ferror 3 |
| | 70 | @@ -96,7 +120,7 @@ |
| | 71 | .Bl -tag -width Er |
| | 72 | .It Bq Er EBADF |
| | 73 | The given |
| | 74 | -.Fa fp |
| | 75 | +.Fa stream |
| | 76 | argument is not a readable stream. |
| | 77 | .It Bq Er EILSEQ |
| | 78 | The data obtained from the input stream does not form a valid |
| | 79 | @@ -116,7 +140,8 @@ |
| | 80 | .Sh SEE ALSO |
| | 81 | .Xr feof 3 , |
| | 82 | .Xr ferror 3 , |
| | 83 | -.Xr fgets 3 |
| | 84 | +.Xr fgets 3 , |
| | 85 | +.Xr xlocale 3 |
| | 86 | .Sh STANDARDS |
| | 87 | The |
| | 88 | .Fn fgetws |
projects / apple / libc.git / blame_incremental