fgetws - Online Linux Manual PageSection : 3
Updated : 2023-02-05
Source : Linux man-pages 6.03

---

NAMEfgetws − read a wide-character string from a FILE stream

---

LIBRARYStandard C library (libc, −lc)

---

SYNOPSIS#include <wchar.h>wchar_t *fgetws(wchar_t ws[restrict .n], int n, FILE *restrict stream);

---

DESCRIPTIONThe 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 VALUEThe fgetws() function, if successful, returns ws. If end of stream was already reached or if an error occurred, it returns NULL.

---

ATTRIBUTESFor an explanation of the terms used in this section, see attributes(7). InterfaceAttributeValue fgetws() Thread safetyMT-Safe

---

STANDARDSPOSIX.1-2001, POSIX.1-2008, C99.

---

NOTESThe 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 ALSOfgetwc(3), unlocked_stdio(3) 0

---

Johanes Gumabo

---

Data Size   :   7,627 byte
man-fgetws.3Build   :   2024-12-05, 20:55   :  
Visitor Screen   :   x
Visitor Counter ( page / site )   :   4 / 165,581
Visitor ID   :     :  
Visitor IP   :   18.117.145.41   :  
Visitor Provider   :   AMAZON-02   :  
Provider Position ( lat x lon )   :   39.962500 x -83.006100   :   x
Provider Accuracy Radius ( km )   :   1000   :  
Provider City   :   Columbus   :  
Provider Province   :   Ohio ,   :   ,
Provider Country   :   United States   :  
Provider Continent   :   North America   :  
Visitor Recorder   :   Version   :  
Visitor Recorder   :   Library   :  
Online Linux Manual Page   :   Version   :   Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.05
Online Linux Manual Page   :   Library   :   lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page   :   Library   :   lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base   :   Version   :   Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base   :   Library   :   lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36

---

Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .

---

If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.

---