svcadm(8)을 검색하려면 섹션에서 8 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.
getws(3c)
getws(3C) Standard C Library Functions getws(3C)
NAME
getws, fgetws - get a wide-character string from a stream
SYNOPSIS
#include <stdio.h>
#include <widec.h>
wchar_t *getws(wchar_t *ws);
#include <stdio.h>
#include <wchar.h>
wchar_t *fgetws(wchar_t *restrict ws, int n, FILE *restrict stream);
DESCRIPTION
The getws() function reads a string of characters from the standard in‐
put stream, stdin, converts these characters to the corresponding wide-
character codes, and writes them to the array pointed to by ws, until a
newline character is read, converted, and transferred to ws or an end-
of-file condition is encountered. The wide-character string, ws, is
then terminated with a null wide-character code.
If the length of an input line exceeds the size of ws, indeterminate
behavior may result. For this reason, it is strongly recommended that
the getws() function be avoided in favor of fgetws().
Note -
The use of the getws() function is discouraged since the user cannot
specify the length of the buffer passed to getws(). The length of the
string read is unlimited. It is possible to overflow this buffer in
such a way as to cause applications to fail, or possible system secu‐
rity violations. Applications should use the fgetws() function in‐
stead of the obsolescent getws() function.
The fgetws() function reads characters from the stream, converts them
to the corresponding wide-character codes, and places them in the
wchar_t array pointed to by ws until n−1 characters are read, or until
a newline character is read, converted and transferred to ws, or an
end-of-file condition is encountered. The wide-character string, ws, is
then terminated with a null wide-character code.
If an error occurs, the resulting value of the file position indicator
for the stream is indeterminate.
The fgetws() function may mark the st_atime field of the file associ‐
ated with stream for update. The st_atime field will be marked for up‐
date by the first successful execution of fgetc(3C), fgets(3C),
fgetwc(3C), fgetws(), fread(3C), fscanf(3C), getc(3C), getchar(3C),
gets(3C), or scanf(3C) using stream that returns data not supplied by a
prior call to ungetc(3C) or ungetwc(3C).
RETURN VALUES
Upon successful completion, getws() and fgetws() return ws. If the
stream is at end-of-file, the end-of-file indicator for the stream is
set and fgetws() returns a null pointer. For standard-conforming (see
standards(7)) applications, if the end-of-file indicator for the stream
is set, fgetws() returns a null pointer whether or not the stream is at
end-of-file. If a read error occurs, the error indicator for the stream
is set and fgetws() returns a null pointer and sets errno to indicate
the error.
ERRORS
See fgetwc(3C) for the conditions that will cause fgetws() to fail.
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
TRIBUTE VALUE _ Interface StabilityT{ fgetws() is Committed. getws()
is Obsolete. T} _ MT-LevelMT-Safe
SEE ALSO
fread(3C), ferror(3C), fgetwc(3C), getwc(3C), putws(3C), scanf(3C),
ungetc(3C), ungetwc(3C), standards(7), attributes(7)
Handling Characters and Character Strings in Internationalizing and Lo‐
calizing Applications in Oracle Solaris
HISTORY
The getws() and fgetws() functions were added to Solaris in the Solaris
2.0 release. In Solaris 2.0 through 2.5, they were located in the libw
library. In Solaris 2.6 and later, they are located in libc.
Oracle Solaris 11.4 25 Nov 2024 getws(3C)