NAME
fgetws - read a wide-character string from a FILE stream
SYNOPSIS
#include <wchar.h> wchar_t *fgetws(wchar_t *ws, int n, FILE *stream);
DESCRIPTION
The fgetws() function is the wide-character equivalent of the fgets(3) function. It reads a string of at most n-1 wide characters into the wide-character array pointed to by ws, and adds a terminating null wide character (L'\0'). It stops reading wide characters after it has encountered and stored a newline wide character. It also stops when end of stream is reached. The programmer must ensure that there is room for at least n wide characters at ws. For a nonlocking counterpart, see unlocked_stdio(3).
RETURN VALUE
The fgetws() function, if successful, returns ws. If end of stream was already reached or if an error occurred, it returns NULL.
ATTRIBUTES
For an explanation of the terms used in this section, see attributes(7). Interface Attribute Value fgetws() Thread safety MT-Safe
CONFORMING TO
POSIX.1-2001, POSIX.1-2008, C99.
NOTES
The behavior of fgetws() depends on the LC_CTYPE category of the current locale. In the absence of additional information passed to the fopen(3) call, it is reasonable to expect that fgetws() will actually read a multibyte string from the stream and then convert it to a wide-character string. This function is unreliable, because it does not permit to deal properly with null wide characters that may be present in the input.
SEE ALSO
fgetwc(3), unlocked_stdio(3)
COLOPHON
This page is part of release 4.09 of the Linux man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at https://www.kernel.org/doc/man-pages/.
More Linux Commands
manpages/roundf.3.html
roundf(3) - round to nearest integer, away from zero........
These functions round x to the nearest integer, but round halfway cases away from zero (regardless of the current rounding direction, see fenv(3)), instead of t
manpages/Tk_GetCursorFromData.3.html
Tk_GetCursorFromData(3) - maintain database of cursors......
These procedures manage a collection of cursors being used by an application. The procedures allow cursors to be re-used efficiently, thereby avoiding server ov
manpages/pam_end.3.html
pam_end(3) - termination of PAM transaction - Linux man page
The pam_end function terminates the PAM transaction and is the last function an application should call in the PAM context. Upon return the handle pamh is no lo
manpages/cpupower-idle-set.1.html
cpupower-idle-set(1) Utility to set cpu idle state specific
The cpupower idle-set subcommand allows to set cpu idle, also called cpu sleep state, specific options offered by the kernel. One example is disabling sleep sta
manpages/dsa.1ssl.html
dsa(1ssl) - DSA key processing (Commands - Linux man page)
The dsa command processes DSA keys. They can be converted between various forms and their components printed out. Note This command uses the traditional SSLeay
manpages/inn.conf.5.html
inn.conf(5) - Configuration data for InterNetNews programs
inn.conf in pathetc is the primary general configuration file for all InterNetNews programs. Settings which control the general operation of various programs, a
manpages/XpGetPrinterList.3x.html
XpGetPrinterList(3x) - Retrieves a list of all printers supp
XpGetPrinterList returns a list of printer records where each record describes a printer supported by the X Print Server, or NULL if any errors occur. If printe
manpages/kismet.conf.5.html
kismet.conf(5) Wireless sniffing and monitoring configuratio
kismet expects a configuration file (/usr/local/etc/kismet.conf by default) which should conform to the following rules. A default configuration is provided wit
manpages/Tcl_StringMatch.3.html
Tcl_StringMatch(3) - test whether a string matches a pattern
This utility procedure determines whether a string matches a given pattern. If it does, then Tcl_StringMatch returns 1. Otherwise Tcl_StringMatch returns 0. The
manpages/jcf-dump.1.html
jcf-dump(1) - print information about Java class files......
This is a class file examiner, similar to javap. It will print information about a number of classes, which are specified by class name or file name. OPTIONS -c
manpages/find_member.8.html
find_member(8) - Find all Mailman lists that a member's addr
find_member [options] regex [regex [...]] OPTIONS l listname, listname=listname Include only the named list in the search. x listname, exclude=listname... (Man)
manpages/XML::Simple::FAQ.3pm.html
XML::Simple::FAQ.3pm (Manual - Linux man page).............
XML::Simple is a Perl module that was originally developed as a tool for reading and writing configuration data in XML format. You can use it for many other ...
