1<html lang="en"> 2<head> 3<title>fgetws - Untitled</title> 4<meta http-equiv="Content-Type" content="text/html"> 5<meta name="description" content="Untitled"> 6<meta name="generator" content="makeinfo 4.13"> 7<link title="Top" rel="start" href="index.html#Top"> 8<link rel="up" href="Stdio.html#Stdio" title="Stdio"> 9<link rel="prev" href="fgetwc.html#fgetwc" title="fgetwc"> 10<link rel="next" href="fileno.html#fileno" title="fileno"> 11<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> 12<meta http-equiv="Content-Style-Type" content="text/css"> 13<style type="text/css"><!-- 14 pre.display { font-family:inherit } 15 pre.format { font-family:inherit } 16 pre.smalldisplay { font-family:inherit; font-size:smaller } 17 pre.smallformat { font-family:inherit; font-size:smaller } 18 pre.smallexample { font-size:smaller } 19 pre.smalllisp { font-size:smaller } 20 span.sc { font-variant:small-caps } 21 span.roman { font-family:serif; font-weight:normal; } 22 span.sansserif { font-family:sans-serif; font-weight:normal; } 23--></style> 24<link rel="stylesheet" type="text/css" href="../cs.css"> 25</head> 26<body> 27<div class="node"> 28<a name="fgetws"></a> 29<p> 30Next: <a rel="next" accesskey="n" href="fileno.html#fileno">fileno</a>, 31Previous: <a rel="previous" accesskey="p" href="fgetwc.html#fgetwc">fgetwc</a>, 32Up: <a rel="up" accesskey="u" href="Stdio.html#Stdio">Stdio</a> 33<hr> 34</div> 35 36<h3 class="section">4.14 <code>fgetws</code>—get wide character string from a file or stream</h3> 37 38<p><a name="index-fgetws-174"></a><a name="index-g_t_005ffgetws_005fr-175"></a><strong>Synopsis</strong> 39<pre class="example"> #include <wchar.h> 40 wchar_t *fgetws(wchar_t *<var>ws</var>, int <var>n</var>, FILE *<var>fp</var>); 41 42 #include <wchar.h> 43 wchar_t *_fgetws_r(struct _reent *<var>ptr</var>, wchar_t *<var>ws</var>, int <var>n</var>, FILE *<var>fp</var>); 44 45</pre> 46 <p><strong>Description</strong><br> 47Reads at most <var>n-1</var> wide characters from <var>fp</var> until a newline 48is found. The wide characters including to the newline are stored 49in <var>ws</var>. The buffer is terminated with a 0. 50 51 <p>The <code>_fgetws_r</code> function is simply the reentrant version of 52<code>fgetws</code> and is passed an additional reentrancy structure 53pointer: <var>ptr</var>. 54 55 <p><br> 56<strong>Returns</strong><br> 57<code>fgetws</code> returns the buffer passed to it, with the data 58filled in. If end of file occurs with some data already 59accumulated, the data is returned with no other indication. If 60no data are read, NULL is returned instead. 61 62 <p><br> 63<strong>Portability</strong><br> 64C99, POSIX.1-2001 65 66 <p><br> 67 68 </body></html> 69 70