<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>ICU 3.6: ustdio.h File Reference</title>
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head><body>
<!-- Generated by Doxygen 1.4.7 -->
<div class="tabs">
<ul>
<li><a href="index.html"><span>Main Page</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="classes.html"><span>Data Structures</span></a></li>
<li id="current"><a href="files.html"><span>Files</span></a></li>
<li><a href="pages.html"><span>Related Pages</span></a></li>
<li>
<form action="search.php" method="get">
<table cellspacing="0" cellpadding="0" border="0">
<tr>
<td><label> <u>S</u>earch for </label></td>
<td><input type="text" name="query" value="" size="20" accesskey="s"/></td>
</tr>
</table>
</form>
</li>
</ul></div>
<div class="tabs">
<ul>
<li><a href="files.html"><span>File List</span></a></li>
<li><a href="globals.html"><span>Globals</span></a></li>
</ul></div>
<h1>ustdio.h File Reference</h1>C API: Unicode stdio-like API. <a href="#_details">More...</a>
<p>
<code>#include <stdio.h></code><br>
<code>#include <stdarg.h></code><br>
<code>#include "<a class="el" href="utypes_8h-source.html">unicode/utypes.h</a>"</code><br>
<code>#include "<a class="el" href="ucnv_8h-source.html">unicode/ucnv.h</a>"</code><br>
<code>#include "<a class="el" href="utrans_8h-source.html">unicode/utrans.h</a>"</code><br>
<p>
<a href="ustdio_8h-source.html">Go to the source code of this file.</a><table border="0" cellpadding="0" cellspacing="0">
<tr><td></td></tr>
<tr><td colspan="2"><br><h2>Defines</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#aac069b40c7881fae9cd7dfd93550dd9">U_EOF</a> 0xFFFF</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">When an end of file is encountered, this value can be returned. <a href="#aac069b40c7881fae9cd7dfd93550dd9"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Typedefs</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">typedef <a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a></td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Forward declaration of a Unicode-aware file. <a href="#b64abe9afc8691b9d6d6bc76977979c0"></a><br></td></tr>
<tr><td colspan="2"><br><h2>Enumerations</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">enum </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#c050dbeb30e941bb635530045b41288f">UFileDirection</a> { <b>U_READ</b> = 1,
<b>U_WRITE</b> = 2,
<b>U_READWRITE</b> = 3
}</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Enum for which direction of stream a transliterator applies to. <a href="ustdio_8h.html#c050dbeb30e941bb635530045b41288f">More...</a><br></td></tr>
<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#071b9e3e222bfcc642184874b2fa34a4">u_fopen</a> (const char *filename, const char *perm, const char *locale, const char *codepage)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Open a UFILE. <a href="#071b9e3e222bfcc642184874b2fa34a4"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#e1eb0edb12a14ad8294ae8018d99c37f">u_finit</a> (FILE *f, const char *locale, const char *codepage)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Open a UFILE on top of an existing FILE* stream. <a href="#e1eb0edb12a14ad8294ae8018d99c37f"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#69d2f8daa7073d78966744abdec0605b">u_fstropen</a> (UChar *stringBuf, <a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> capacity, const char *locale)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Create a UFILE that can be used for localized formatting or parsing. <a href="#69d2f8daa7073d78966744abdec0605b"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#510c90a9e1480f78d23e14716ae55c12">u_fclose</a> (<a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *file)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Close a UFILE. <a href="#510c90a9e1480f78d23e14716ae55c12"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="umachine_8h.html#d373ce262c37cc047b0df2ad7b5dbba7">UBool</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#ced6a21f61d5055e040c000dedb7c7a4">u_feof</a> (<a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *f)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Tests if the UFILE is at the end of the file stream. <a href="#ced6a21f61d5055e040c000dedb7c7a4"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#7224cf6a73aed6d2fe6c1a9c8f549c13">u_fflush</a> (<a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *file)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Flush output of a UFILE. <a href="#7224cf6a73aed6d2fe6c1a9c8f549c13"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#96040d6fef431a3ef8ce91efe8aa5997">u_frewind</a> (<a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *file)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Rewind the file pointer to the beginning of the file. <a href="#96040d6fef431a3ef8ce91efe8aa5997"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">FILE * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#10b5600ebe7fb312dd6cb13bc44129b7">u_fgetfile</a> (<a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *f)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the FILE* associated with a UFILE. <a href="#10b5600ebe7fb312dd6cb13bc44129b7"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#ae03860b53594e32c63ba0f3a93a2a6c">u_fgetlocale</a> (<a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *file)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the locale whose conventions are used to format and parse output. <a href="#ae03860b53594e32c63ba0f3a93a2a6c"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#25258d566d65fb64bbe1b7cf041e5e99">u_fsetlocale</a> (<a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *file, const char *locale)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the locale whose conventions will be used to format and parse output. <a href="#25258d566d65fb64bbe1b7cf041e5e99"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#68aa779a8cdb56a41ea9ca6d135264f3">u_fgetcodepage</a> (<a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *file)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Get the codepage in which data is written to and read from the UFILE. <a href="#68aa779a8cdb56a41ea9ca6d135264f3"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#627c291ee606a11354aa4fe0e3e52982">u_fsetcodepage</a> (const char *codepage, <a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *file)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the codepage in which data will be written to and read from the UFILE. <a href="#627c291ee606a11354aa4fe0e3e52982"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="ucnv__err_8h.html#ef46b643e2e61fb93ce8b972756539ea">UConverter</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#e24374f7ed99cbeeaec4cc28d2914ba0">u_fgetConverter</a> (<a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *f)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Returns an alias to the converter being used for this file. <a href="#e24374f7ed99cbeeaec4cc28d2914ba0"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#28f8f1f5b3f6e898ee9383ddec537c60">u_fprintf</a> (<a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *f, const char *patternSpecification,...)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Write formatted data to a UFILE. <a href="#28f8f1f5b3f6e898ee9383ddec537c60"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#b0dc36c4d83d46433d7260d761da8da7">u_vfprintf</a> (<a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *f, const char *patternSpecification, va_list ap)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Write formatted data to a UFILE. <a href="#b0dc36c4d83d46433d7260d761da8da7"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#ab9f1461211b7f9cef3f125f7c819107">u_fprintf_u</a> (<a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *f, const UChar *patternSpecification,...)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Write formatted data to a UFILE. <a href="#ab9f1461211b7f9cef3f125f7c819107"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#89140702e806585905ef4906c533da95">u_vfprintf_u</a> (<a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *f, const UChar *patternSpecification, va_list ap)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Write formatted data to a UFILE. <a href="#89140702e806585905ef4906c533da95"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#78b7d628896c47691b107cc732d3fb90">u_fputs</a> (const UChar *s, <a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *f)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Write a Unicode to a UFILE. <a href="#78b7d628896c47691b107cc732d3fb90"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="umachine_8h.html#a5c18ea10e60c576fe5ec420a7ef7b28">UChar32</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#86199073c9e073dbc7ad6a8f02b1fc52">u_fputc</a> (<a class="el" href="umachine_8h.html#a5c18ea10e60c576fe5ec420a7ef7b28">UChar32</a> uc, <a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *f)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Write a UChar to a UFILE. <a href="#86199073c9e073dbc7ad6a8f02b1fc52"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#b47826c936ddc8096144d1d4360cd1da">u_file_write</a> (const UChar *ustring, <a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> count, <a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *f)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Write Unicode to a UFILE. <a href="#b47826c936ddc8096144d1d4360cd1da"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#a75bf38f906695dde98458b22b4593d5">u_fscanf</a> (<a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *f, const char *patternSpecification,...)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Read formatted data from a UFILE. <a href="#a75bf38f906695dde98458b22b4593d5"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#0f59af360869d8c33bed8c033f1feec8">u_vfscanf</a> (<a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *f, const char *patternSpecification, va_list ap)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Read formatted data from a UFILE. <a href="#0f59af360869d8c33bed8c033f1feec8"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#cc97e7946c1c60b6dcb4e975b4abd1f1">u_fscanf_u</a> (<a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *f, const UChar *patternSpecification,...)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Read formatted data from a UFILE. <a href="#cc97e7946c1c60b6dcb4e975b4abd1f1"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#0efaf37b28088255532aa6438e1edb44">u_vfscanf_u</a> (<a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *f, const UChar *patternSpecification, va_list ap)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Read formatted data from a UFILE. <a href="#0efaf37b28088255532aa6438e1edb44"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">UChar * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#1161da3e8ce14a9ecff13c69e090c4e1">u_fgets</a> (UChar *s, <a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> n, <a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *f)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Read one line of text into a UChar* string from a UFILE. <a href="#1161da3e8ce14a9ecff13c69e090c4e1"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top">UChar </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#f11feead65c7db7491a355be21e7d955">u_fgetc</a> (<a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *f)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Read a UChar from a UFILE. <a href="#f11feead65c7db7491a355be21e7d955"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="umachine_8h.html#a5c18ea10e60c576fe5ec420a7ef7b28">UChar32</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#65a2ad3c2dea1853bdac0c4b96738643">u_fgetcx</a> (<a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *f)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Read a UChar32 from a UFILE. <a href="#65a2ad3c2dea1853bdac0c4b96738643"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="umachine_8h.html#a5c18ea10e60c576fe5ec420a7ef7b28">UChar32</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#b7af5c4e67fb85222cd17f4b72dd37d3">u_fungetc</a> (<a class="el" href="umachine_8h.html#a5c18ea10e60c576fe5ec420a7ef7b28">UChar32</a> c, <a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *f)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Unget a UChar from a UFILE. <a href="#b7af5c4e67fb85222cd17f4b72dd37d3"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#edaa2e8a00eaff9badd354daa9131013">u_file_read</a> (UChar *chars, <a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> count, <a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *f)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Read Unicode from a UFILE. <a href="#edaa2e8a00eaff9badd354daa9131013"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="utrans_8h.html#82f93a05baa5261b7761cbeabc215463">UTransliterator</a> * </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#67b8ea54be62ed38a4165094d8d973be">u_fsettransliterator</a> (<a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> *file, <a class="el" href="ustdio_8h.html#c050dbeb30e941bb635530045b41288f">UFileDirection</a> direction, <a class="el" href="utrans_8h.html#82f93a05baa5261b7761cbeabc215463">UTransliterator</a> *adopt, <a class="el" href="utypes_8h.html#863c11989634c998849cc946d04dfabe">UErrorCode</a> *status)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set a transliterator on the UFILE. <a href="#67b8ea54be62ed38a4165094d8d973be"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#93adbe84f54e0b10cfd1bdd3f8cf55f5">u_sprintf</a> (UChar *buffer, const char *patternSpecification,...)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Write formatted data to a Unicode string. <a href="#93adbe84f54e0b10cfd1bdd3f8cf55f5"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#6ba527404930481df717c0cb39c1bf44">u_snprintf</a> (UChar *buffer, <a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> count, const char *patternSpecification,...)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Write formatted data to a Unicode string. <a href="#6ba527404930481df717c0cb39c1bf44"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#0371020d25c4adf0b9e91eca291b1ba4">u_vsprintf</a> (UChar *buffer, const char *patternSpecification, va_list ap)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Write formatted data to a Unicode string. <a href="#0371020d25c4adf0b9e91eca291b1ba4"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#08dd63aa5987875df610a26fb17301ad">u_vsnprintf</a> (UChar *buffer, <a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> count, const char *patternSpecification, va_list ap)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Write formatted data to a Unicode string. <a href="#08dd63aa5987875df610a26fb17301ad"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#66a9ea5d891b4ebe21545fea9d3c7754">u_sprintf_u</a> (UChar *buffer, const UChar *patternSpecification,...)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Write formatted data to a Unicode string. <a href="#66a9ea5d891b4ebe21545fea9d3c7754"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#ca966c49bcf2267ce4034fb2a4a0572a">u_snprintf_u</a> (UChar *buffer, <a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> count, const UChar *patternSpecification,...)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Write formatted data to a Unicode string. <a href="#ca966c49bcf2267ce4034fb2a4a0572a"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#f5b433ef037b3f3154b8d2193a8dded5">u_vsprintf_u</a> (UChar *buffer, const UChar *patternSpecification, va_list ap)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Write formatted data to a Unicode string. <a href="#f5b433ef037b3f3154b8d2193a8dded5"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#6ff9eae8064d77238350a88009597071">u_vsnprintf_u</a> (UChar *buffer, <a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> count, const UChar *patternSpecification, va_list ap)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Write formatted data to a Unicode string. <a href="#6ff9eae8064d77238350a88009597071"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#2846495827c41434a1c0745792844d7b">u_sscanf</a> (const UChar *buffer, const char *patternSpecification,...)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Read formatted data from a Unicode string. <a href="#2846495827c41434a1c0745792844d7b"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#52bdbdf16334b09ae4985e497d9662d2">u_vsscanf</a> (const UChar *buffer, const char *patternSpecification, va_list ap)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Read formatted data from a Unicode string. <a href="#52bdbdf16334b09ae4985e497d9662d2"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#64731359739dc52e6b5d71c14f61067d">u_sscanf_u</a> (const UChar *buffer, const UChar *patternSpecification,...)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Read formatted data from a Unicode string. <a href="#64731359739dc52e6b5d71c14f61067d"></a><br></td></tr>
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="ustdio_8h.html#09a0181d6e73b16df1d3fb6a35c81c31">u_vsscanf_u</a> (const UChar *buffer, const UChar *patternSpecification, va_list ap)</td></tr>
<tr><td class="mdescLeft"> </td><td class="mdescRight">Read formatted data from a Unicode string. <a href="#09a0181d6e73b16df1d3fb6a35c81c31"></a><br></td></tr>
</table>
<hr><a name="_details"></a><h2>Detailed Description</h2>
C API: Unicode stdio-like API.
<p>
<h2>Unicode stdio-like C API</h2>
<p>
This API provides an stdio-like API wrapper around ICU's other formatting and parsing APIs. It is meant to ease the transition of adding Unicode support to a preexisting applications using stdio. The following is a small list of noticable differences between stdio and ICU I/O's ustdio implementation.<p>
<ul>
<li>
<a class="el" href="classLocale.html">Locale</a> specific formatting and parsing is only done with file IO. </li>
<li>
u_fstropen can be used to simulate file IO with strings. This is similar to the iostream API, and it allows locale specific formatting and parsing to be used. </li>
<li>
This API provides uniform formatting and parsing behavior between platforms (unlike the standard stdio implementations found on various platforms). </li>
<li>
This API is better suited for text data handling than binary data handling when compared to the typical stdio implementation. </li>
<li>
You can specify a <a class="el" href="classTransliterator.html">Transliterator</a> while using the file IO. </li>
<li>
You can specify a file's codepage separately from the default system codepage. </li>
</ul>
<p>
<h2>Formatting and Parsing Specification</h2>
<p>
General printf format:<br>
%[format modifier][width][.precision][type modifier][format]<p>
General scanf format:<br>
%[*][format modifier][width][type modifier][format]<p>
<table cellspacing="3" border="1" cellpadding="3">
<tr>
<td>format</td><td>default<br>
printf<br>
type</td><td>default<br>
scanf<br>
type</td><td>description </td></tr>
<tr>
<td>E</td><td>double</td><td>float</td><td>Scientific with an uppercase exponent </td></tr>
<tr>
<td>e</td><td>double</td><td>float</td><td>Scientific with a lowercase exponent </td></tr>
<tr>
<td>G</td><td>double</td><td>float</td><td>Use E or f for best format </td></tr>
<tr>
<td>g</td><td>double</td><td>float</td><td>Use e or f for best format </td></tr>
<tr>
<td>f</td><td>double</td><td>float</td><td>Simple floating point without the exponent </td></tr>
<tr>
<td>X</td><td>int32_t</td><td>int32_t</td><td>ustdio special uppercase hex radix formatting </td></tr>
<tr>
<td>x</td><td>int32_t</td><td>int32_t</td><td>ustdio special lowercase hex radix formatting </td></tr>
<tr>
<td>d</td><td>int32_t</td><td>int32_t</td><td>Decimal format </td></tr>
<tr>
<td>i</td><td>int32_t</td><td>int32_t</td><td>Same as d </td></tr>
<tr>
<td>n</td><td>int32_t</td><td>int32_t</td><td>count (write the number of UTF-16 codeunits read/written) </td></tr>
<tr>
<td>o</td><td>int32_t</td><td>int32_t</td><td>ustdio special octal radix formatting </td></tr>
<tr>
<td>u</td><td>uint32_t</td><td>uint32_t</td><td>Decimal format </td></tr>
<tr>
<td>p</td><td>void *</td><td>void *</td><td>Prints the pointer value </td></tr>
<tr>
<td>s</td><td>char *</td><td>char *</td><td>Use default converter or specified converter from fopen </td></tr>
<tr>
<td>c</td><td>char</td><td>char</td><td>Use default converter or specified converter from fopen<br>
When width is specified for scanf, this acts like a non-NULL-terminated char * string.<br>
By default, only one char is written. </td></tr>
<tr>
<td>S</td><td>UChar *</td><td>UChar *</td><td>Null terminated UTF-16 string </td></tr>
<tr>
<td>C</td><td>UChar</td><td>UChar</td><td>16-bit Unicode code unit<br>
When width is specified for scanf, this acts like a non-NULL-terminated UChar * string<br>
By default, only one codepoint is written. </td></tr>
<tr>
<td>%[]</td><td> </td><td>UChar *</td><td>Null terminated UTF-16 string which contains the filtered set of characters specified by the <a class="el" href="classUnicodeSet.html">UnicodeSet</a> </td></tr>
<tr>
<td>%%</td><td> </td><td> </td><td>Show a percent sign </td></tr>
</table>
<p>
<a class="el" href="classFormat.html">Format</a> modifiers <table border="1" cellspacing="3" cellpadding="3">
<tr>
<td>modifier</td><td>formats</td><td>type</td><td>comments </td></tr>
<tr>
<td>h</td><td>d, i, o, x</td><td>int16_t</td><td>short format </td></tr>
<tr>
<td>h</td><td>u</td><td>uint16_t</td><td>short format </td></tr>
<tr>
<td>h</td><td>c</td><td>char</td><td><b>(Unimplemented)</b> Use invariant converter </td></tr>
<tr>
<td>h</td><td>s</td><td>char *</td><td><b>(Unimplemented)</b> Use invariant converter </td></tr>
<tr>
<td>h</td><td>C</td><td>char</td><td><b>(Unimplemented)</b> 8-bit Unicode code unit </td></tr>
<tr>
<td>h</td><td>S</td><td>char *</td><td><b>(Unimplemented)</b> Null terminated UTF-8 string </td></tr>
<tr>
<td>l</td><td>d, i, o, x</td><td>int32_t</td><td>long format (no effect) </td></tr>
<tr>
<td>l</td><td>u</td><td>uint32_t</td><td>long format (no effect) </td></tr>
<tr>
<td>l</td><td>c</td><td>N/A</td><td><b>(Unimplemented)</b> Reserved for future implementation </td></tr>
<tr>
<td>l</td><td>s</td><td>N/A</td><td><b>(Unimplemented)</b> Reserved for future implementation </td></tr>
<tr>
<td>l</td><td>C</td><td>UChar32</td><td><b>(Unimplemented)</b> 32-bit Unicode code unit </td></tr>
<tr>
<td>l</td><td>S</td><td>UChar32 *</td><td><b>(Unimplemented)</b> Null terminated UTF-32 string </td></tr>
<tr>
<td>ll</td><td>d, i, o, x</td><td>int64_t</td><td>long long format </td></tr>
<tr>
<td>ll</td><td>u</td><td>uint64_t</td><td><b>(Unimplemented)</b> long long format </td></tr>
<tr>
<td>-</td><td><em>all</em></td><td>N/A</td><td>Left justify </td></tr>
<tr>
<td>+</td><td>d, i, o, x, e, f, g, E, G</td><td>N/A</td><td>Always show the plus or minus sign. Needs data for plus sign. </td></tr>
<tr>
<td>% </td><td>d, i, o, x, e, f, g, E, G</td><td>N/A</td><td>Instead of a "+" output a blank character for positive numbers. </td></tr>
<tr>
<td>%#</td><td>d, i, o, x, e, f, g, E, G</td><td>N/A</td><td>Precede octal value with 0, hex with 0x and show the decimal point for floats. </td></tr>
<tr>
<td>%<em>n</em></td><td><em>all</em></td><td>N/A</td><td>Width of input/output. num is an actual number from 0 to some large number. </td></tr>
<tr>
<td>%.<em>n</em></td><td>e, f, g, E, F, G</td><td>N/A</td><td>Significant digits precision. num is an actual number from 0 to some large number.<br>
If * is used in printf, then the precision is passed in as an argument before the number to be formatted. </td></tr>
</table>
<p>
printf modifier * int32_t Next argument after this one specifies the width<p>
scanf modifier * N/A This field is scanned, but not stored
<p>
Definition in file <a class="el" href="ustdio_8h-source.html">ustdio.h</a>.<hr><h2>Define Documentation</h2>
<a class="anchor" name="aac069b40c7881fae9cd7dfd93550dd9"></a><!-- doxytag: member="ustdio.h::U_EOF" ref="aac069b40c7881fae9cd7dfd93550dd9" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">#define U_EOF 0xFFFF </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
When an end of file is encountered, this value can be returned.
<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="ustdio_8h.html#f11feead65c7db7491a355be21e7d955">u_fgetc</a> </dd></dl>
<dl compact><dt><b><a class="el" href="stable.html#_stable003079">Stable:</a></b></dt><dd>3.0 </dd></dl>
<p>
Definition at line <a class="el" href="ustdio_8h-source.html#l00191">191</a> of file <a class="el" href="ustdio_8h-source.html">ustdio.h</a>.
</div>
</div><p>
<hr><h2>Typedef Documentation</h2>
<a class="anchor" name="b64abe9afc8691b9d6d6bc76977979c0"></a><!-- doxytag: member="ustdio.h::UFILE" ref="b64abe9afc8691b9d6d6bc76977979c0" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">typedef struct <a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> <a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Forward declaration of a Unicode-aware file.
<p>
<dl compact><dt><b><a class="el" href="stable.html#_stable003080">Stable:</a></b></dt><dd>3.0 </dd></dl>
<p>
Definition at line <a class="el" href="ustdio_8h-source.html#l00194">194</a> of file <a class="el" href="ustdio_8h-source.html">ustdio.h</a>.
</div>
</div><p>
<hr><h2>Enumeration Type Documentation</h2>
<a class="anchor" name="c050dbeb30e941bb635530045b41288f"></a><!-- doxytag: member="ustdio.h::UFileDirection" ref="c050dbeb30e941bb635530045b41288f" args="" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">enum <a class="el" href="ustdio_8h.html#c050dbeb30e941bb635530045b41288f">UFileDirection</a> </td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Enum for which direction of stream a transliterator applies to.
<p>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="ustdio_8h.html#67b8ea54be62ed38a4165094d8d973be">u_fsettransliterator</a> </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000226">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
<p>
Definition at line <a class="el" href="ustdio_8h-source.html#l00202">202</a> of file <a class="el" href="ustdio_8h-source.html">ustdio.h</a>.
</div>
</div><p>
<hr><h2>Function Documentation</h2>
<a class="anchor" name="510c90a9e1480f78d23e14716ae55c12"></a><!-- doxytag: member="ustdio.h::u_fclose" ref="510c90a9e1480f78d23e14716ae55c12" args="(UFILE *file)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void u_fclose </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>file</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Close a UFILE.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>file</em> </td><td>The UFILE to close. </td></tr>
</table>
</dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000230">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="ced6a21f61d5055e040c000dedb7c7a4"></a><!-- doxytag: member="ustdio.h::u_feof" ref="ced6a21f61d5055e040c000dedb7c7a4" args="(UFILE *f)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#d373ce262c37cc047b0df2ad7b5dbba7">UBool</a> u_feof </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>f</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Tests if the UFILE is at the end of the file stream.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>f</em> </td><td>The UFILE from which to read. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>Returns TRUE after the first read operation that attempts to read past the end of the file. It returns FALSE if the current position is not end of file. </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000231">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="7224cf6a73aed6d2fe6c1a9c8f549c13"></a><!-- doxytag: member="ustdio.h::u_fflush" ref="7224cf6a73aed6d2fe6c1a9c8f549c13" args="(UFILE *file)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void u_fflush </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>file</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Flush output of a UFILE.
<p>
Implies a flush of converter/transliterator state. (That is, a logical break is made in the output stream - for example if a different type of output is desired.) The underlying OS level file is also flushed. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>file</em> </td><td>The UFILE to flush. </td></tr>
</table>
</dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000232">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="f11feead65c7db7491a355be21e7d955"></a><!-- doxytag: member="ustdio.h::u_fgetc" ref="f11feead65c7db7491a355be21e7d955" args="(UFILE *f)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">UChar u_fgetc </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>f</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Read a UChar from a UFILE.
<p>
It is recommended that <code>u_fgetcx</code> used instead for proper parsing functions, but sometimes reading code units is needed instead of codepoints.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>f</em> </td><td>The UFILE from which to read. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The UChar value read, or U+FFFF if no character was available. </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000252">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="68aa779a8cdb56a41ea9ca6d135264f3"></a><!-- doxytag: member="ustdio.h::u_fgetcodepage" ref="68aa779a8cdb56a41ea9ca6d135264f3" args="(UFILE *file)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* u_fgetcodepage </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>file</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the codepage in which data is written to and read from the UFILE.
<p>
This is the same codepage passed in the preceding call to <code>u_fsetcodepage</code> or <code>u_fopen</code>. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>file</em> </td><td>The UFILE to query. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The codepage in which data is written to and read from the UFILE, or NULL if an error occurred. </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000237">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="e24374f7ed99cbeeaec4cc28d2914ba0"></a><!-- doxytag: member="ustdio.h::u_fgetConverter" ref="e24374f7ed99cbeeaec4cc28d2914ba0" args="(UFILE *f)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="ucnv__err_8h.html#ef46b643e2e61fb93ce8b972756539ea">UConverter</a>* u_fgetConverter </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>f</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Returns an alias to the converter being used for this file.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>f</em> </td><td>The UFILE to get the value from </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>alias to the converter </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000239">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="65a2ad3c2dea1853bdac0c4b96738643"></a><!-- doxytag: member="ustdio.h::u_fgetcx" ref="65a2ad3c2dea1853bdac0c4b96738643" args="(UFILE *f)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a5c18ea10e60c576fe5ec420a7ef7b28">UChar32</a> u_fgetcx </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>f</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Read a UChar32 from a UFILE.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>f</em> </td><td>The UFILE from which to read. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The UChar32 value read, or U_EOF if no character was available, or U+FFFFFFFF if an ill-formed character was encountered. </dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="ustring_8h.html#befe4e1415fed5a5a63bfb6b23162f8e">u_unescape()</a> </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000253">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="10b5600ebe7fb312dd6cb13bc44129b7"></a><!-- doxytag: member="ustdio.h::u_fgetfile" ref="10b5600ebe7fb312dd6cb13bc44129b7" args="(UFILE *f)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">FILE* u_fgetfile </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>f</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the FILE* associated with a UFILE.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>f</em> </td><td>The UFILE </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>A FILE*, owned by the UFILE. The FILE <em>must not</em> be closed. </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000234">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="ae03860b53594e32c63ba0f3a93a2a6c"></a><!-- doxytag: member="ustdio.h::u_fgetlocale" ref="ae03860b53594e32c63ba0f3a93a2a6c" args="(UFILE *file)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">const char* u_fgetlocale </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>file</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Get the locale whose conventions are used to format and parse output.
<p>
This is the same locale passed in the preceding call to<code>u_fsetlocale</code> or <code>u_fopen</code>. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>file</em> </td><td>The UFILE to set. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The locale whose conventions are used to format and parse output. </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000235">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="1161da3e8ce14a9ecff13c69e090c4e1"></a><!-- doxytag: member="ustdio.h::u_fgets" ref="1161da3e8ce14a9ecff13c69e090c4e1" args="(UChar *s, int32_t n, UFILE *f)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">UChar* u_fgets </td>
<td>(</td>
<td class="paramtype">UChar * </td>
<td class="paramname"> <em>s</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td>
<td class="paramname"> <em>n</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>f</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Read one line of text into a UChar* string from a UFILE.
<p>
The newline at the end of the line is read into the string. The string is always null terminated <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>f</em> </td><td>The UFILE from which to read. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>n</em> </td><td>The maximum number of characters - 1 to read. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>s</em> </td><td>The UChar* to receive the read data. Characters will be stored successively in <code>s</code> until a newline or EOF is reached. A null character (U+0000) will be appended to <code>s</code>. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>A pointer to <code>s</code>, or NULL if no characters were available. </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000251">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="edaa2e8a00eaff9badd354daa9131013"></a><!-- doxytag: member="ustdio.h::u_file_read" ref="edaa2e8a00eaff9badd354daa9131013" args="(UChar *chars, int32_t count, UFILE *f)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> u_file_read </td>
<td>(</td>
<td class="paramtype">UChar * </td>
<td class="paramname"> <em>chars</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td>
<td class="paramname"> <em>count</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>f</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Read Unicode from a UFILE.
<p>
Bytes will be converted from the UFILE's underlying codepage, with subsequent conversion to Unicode. The data will not be NULL terminated. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>chars</em> </td><td>A pointer to receive the Unicode data. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>count</em> </td><td>The number of Unicode characters to read. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>f</em> </td><td>The UFILE from which to read. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of Unicode characters read. </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000255">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="b47826c936ddc8096144d1d4360cd1da"></a><!-- doxytag: member="ustdio.h::u_file_write" ref="b47826c936ddc8096144d1d4360cd1da" args="(const UChar *ustring, int32_t count, UFILE *f)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> u_file_write </td>
<td>(</td>
<td class="paramtype">const UChar * </td>
<td class="paramname"> <em>ustring</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td>
<td class="paramname"> <em>count</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>f</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Write Unicode to a UFILE.
<p>
The ustring passed in will be converted to the UFILE's underlying codepage before it is written. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>ustring</em> </td><td>A pointer to the Unicode data to write. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>count</em> </td><td>The number of Unicode characters to write </td></tr>
<tr><td valign="top"></td><td valign="top"><em>f</em> </td><td>The UFILE to which to write. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of Unicode characters written. </dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="ustdio_8h.html#78b7d628896c47691b107cc732d3fb90">u_fputs</a> </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000246">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="e1eb0edb12a14ad8294ae8018d99c37f"></a><!-- doxytag: member="ustdio.h::u_finit" ref="e1eb0edb12a14ad8294ae8018d99c37f" args="(FILE *f, const char *locale, const char *codepage)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a>* u_finit </td>
<td>(</td>
<td class="paramtype">FILE * </td>
<td class="paramname"> <em>f</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>locale</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>codepage</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Open a UFILE on top of an existing FILE* stream.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>f</em> </td><td>The FILE* to which this UFILE will attach. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>locale</em> </td><td>The locale whose conventions will be used to format and parse output. If this parameter is NULL, the default locale will be used. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>codepage</em> </td><td>The codepage in which data will be written to and read from the file. If this paramter is NULL, data will be written and read using the default codepage for <code>locale</code>, unless <code>locale</code> is NULL, in which case the system default codepage will be used. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>A new UFILE, or NULL if an error occurred. </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000228">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="071b9e3e222bfcc642184874b2fa34a4"></a><!-- doxytag: member="ustdio.h::u_fopen" ref="071b9e3e222bfcc642184874b2fa34a4" args="(const char *filename, const char *perm, const char *locale, const char *codepage)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a>* u_fopen </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>filename</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>perm</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>locale</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>codepage</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Open a UFILE.
<p>
A UFILE is a wrapper around a FILE* that is locale and codepage aware. That is, data written to a UFILE will be formatted using the conventions specified by that UFILE's <a class="el" href="classLocale.html">Locale</a>; this data will be in the character set specified by that UFILE's codepage. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>filename</em> </td><td>The name of the file to open. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>perm</em> </td><td>The read/write permission for the UFILE; one of "r", "w", "rw" </td></tr>
<tr><td valign="top"></td><td valign="top"><em>locale</em> </td><td>The locale whose conventions will be used to format and parse output. If this parameter is NULL, the default locale will be used. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>codepage</em> </td><td>The codepage in which data will be written to and read from the file. If this paramter is NULL the system default codepage will be used. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>A new UFILE, or NULL if an error occurred. </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000227">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="28f8f1f5b3f6e898ee9383ddec537c60"></a><!-- doxytag: member="ustdio.h::u_fprintf" ref="28f8f1f5b3f6e898ee9383ddec537c60" args="(UFILE *f, const char *patternSpecification,...)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> u_fprintf </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>f</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>patternSpecification</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname"> <em>...</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Write formatted data to a UFILE.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>f</em> </td><td>The UFILE to which to write. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>patternSpecification</em> </td><td>A pattern specifying how <code>u_fprintf</code> will interpret the variable arguments received and format the data. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of Unicode characters written to <code>f</code>. </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000240">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="ab9f1461211b7f9cef3f125f7c819107"></a><!-- doxytag: member="ustdio.h::u_fprintf_u" ref="ab9f1461211b7f9cef3f125f7c819107" args="(UFILE *f, const UChar *patternSpecification,...)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> u_fprintf_u </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>f</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const UChar * </td>
<td class="paramname"> <em>patternSpecification</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname"> <em>...</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Write formatted data to a UFILE.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>f</em> </td><td>The UFILE to which to write. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>patternSpecification</em> </td><td>A pattern specifying how <code>u_fprintf</code> will interpret the variable arguments received and format the data. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of Unicode characters written to <code>f</code>. </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000242">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="86199073c9e073dbc7ad6a8f02b1fc52"></a><!-- doxytag: member="ustdio.h::u_fputc" ref="86199073c9e073dbc7ad6a8f02b1fc52" args="(UChar32 uc, UFILE *f)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a5c18ea10e60c576fe5ec420a7ef7b28">UChar32</a> u_fputc </td>
<td>(</td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a5c18ea10e60c576fe5ec420a7ef7b28">UChar32</a> </td>
<td class="paramname"> <em>uc</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>f</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Write a UChar to a UFILE.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>uc</em> </td><td>The UChar to write. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>f</em> </td><td>The UFILE to which to write. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The character written if successful, EOF otherwise. </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000245">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="78b7d628896c47691b107cc732d3fb90"></a><!-- doxytag: member="ustdio.h::u_fputs" ref="78b7d628896c47691b107cc732d3fb90" args="(const UChar *s, UFILE *f)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> u_fputs </td>
<td>(</td>
<td class="paramtype">const UChar * </td>
<td class="paramname"> <em>s</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>f</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Write a Unicode to a UFILE.
<p>
The null (U+0000) terminated UChar* <code>s</code> will be written to <code>f</code>, excluding the NULL terminator. A newline will be added to <code>f</code>. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>s</em> </td><td>The UChar* to write. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>f</em> </td><td>The UFILE to which to write. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>A non-negative number if successful, EOF otherwise. </dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="ustdio_8h.html#b47826c936ddc8096144d1d4360cd1da">u_file_write</a> </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000244">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="96040d6fef431a3ef8ce91efe8aa5997"></a><!-- doxytag: member="ustdio.h::u_frewind" ref="96040d6fef431a3ef8ce91efe8aa5997" args="(UFILE *file)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void u_frewind </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>file</em> </td>
<td> ) </td>
<td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Rewind the file pointer to the beginning of the file.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>file</em> </td><td>The UFILE to rewind. </td></tr>
</table>
</dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000233">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="a75bf38f906695dde98458b22b4593d5"></a><!-- doxytag: member="ustdio.h::u_fscanf" ref="a75bf38f906695dde98458b22b4593d5" args="(UFILE *f, const char *patternSpecification,...)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> u_fscanf </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>f</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>patternSpecification</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname"> <em>...</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Read formatted data from a UFILE.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>f</em> </td><td>The UFILE from which to read. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>patternSpecification</em> </td><td>A pattern specifying how <code>u_fscanf</code> will interpret the variable arguments received and parse the data. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of items successfully converted and assigned, or EOF if an error occurred. </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000247">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="cc97e7946c1c60b6dcb4e975b4abd1f1"></a><!-- doxytag: member="ustdio.h::u_fscanf_u" ref="cc97e7946c1c60b6dcb4e975b4abd1f1" args="(UFILE *f, const UChar *patternSpecification,...)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> u_fscanf_u </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>f</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const UChar * </td>
<td class="paramname"> <em>patternSpecification</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname"> <em>...</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Read formatted data from a UFILE.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>f</em> </td><td>The UFILE from which to read. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>patternSpecification</em> </td><td>A pattern specifying how <code>u_fscanf</code> will interpret the variable arguments received and parse the data. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of items successfully converted and assigned, or EOF if an error occurred. </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000249">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="627c291ee606a11354aa4fe0e3e52982"></a><!-- doxytag: member="ustdio.h::u_fsetcodepage" ref="627c291ee606a11354aa4fe0e3e52982" args="(const char *codepage, UFILE *file)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> u_fsetcodepage </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>codepage</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>file</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Set the codepage in which data will be written to and read from the UFILE.
<p>
All Unicode data written to the UFILE will be converted to this codepage before it is written to the underlying FILE*. It it generally a bad idea to mix codepages within a file. This should only be called right after opening the <code>UFile</code>, or after calling <code>u_frewind</code>. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>codepage</em> </td><td>The codepage in which data will be written to and read from the file. For example <code>"latin-1"</code> or <code>"ibm-943</code>. A value of NULL means the default codepage for the UFILE's current locale will be used. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>file</em> </td><td>The UFILE to set. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>0 if successful, otherwise a negative number. </dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="ustdio_8h.html#96040d6fef431a3ef8ce91efe8aa5997">u_frewind</a> </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000238">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="25258d566d65fb64bbe1b7cf041e5e99"></a><!-- doxytag: member="ustdio.h::u_fsetlocale" ref="25258d566d65fb64bbe1b7cf041e5e99" args="(UFILE *file, const char *locale)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> u_fsetlocale </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>file</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>locale</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Set the locale whose conventions will be used to format and parse output.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>locale</em> </td><td>The locale whose conventions will be used to format and parse output. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>file</em> </td><td>The UFILE to query. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>NULL if successful, otherwise a negative number. </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000236">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="67b8ea54be62ed38a4165094d8d973be"></a><!-- doxytag: member="ustdio.h::u_fsettransliterator" ref="67b8ea54be62ed38a4165094d8d973be" args="(UFILE *file, UFileDirection direction, UTransliterator *adopt, UErrorCode *status)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="utrans_8h.html#82f93a05baa5261b7761cbeabc215463">UTransliterator</a>* u_fsettransliterator </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>file</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#c050dbeb30e941bb635530045b41288f">UFileDirection</a> </td>
<td class="paramname"> <em>direction</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utrans_8h.html#82f93a05baa5261b7761cbeabc215463">UTransliterator</a> * </td>
<td class="paramname"> <em>adopt</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="utypes_8h.html#863c11989634c998849cc946d04dfabe">UErrorCode</a> * </td>
<td class="paramname"> <em>status</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Set a transliterator on the UFILE.
<p>
The transliterator will be owned by the UFILE. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>file</em> </td><td>The UFILE to set transliteration on </td></tr>
<tr><td valign="top"></td><td valign="top"><em>adopt</em> </td><td>The UTransliterator to set. Can be NULL, which will mean that no transliteration is used. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>direction</em> </td><td>either U_READ, U_WRITE, or U_READWRITE - sets which direction the transliterator is to be applied to. If U_READWRITE, the "Read" transliteration will be in the inverse direction. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>status</em> </td><td>ICU error code. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The previously set transliterator, owned by the caller. If U_READWRITE is specified, only the WRITE transliterator is returned. In most cases, the caller should call <a class="el" href="utrans_8h.html#38d1cbc59276137642765d1f33c06a1e">utrans_close()</a> on the result of this function. </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000256">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="69d2f8daa7073d78966744abdec0605b"></a><!-- doxytag: member="ustdio.h::u_fstropen" ref="69d2f8daa7073d78966744abdec0605b" args="(UChar *stringBuf, int32_t capacity, const char *locale)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a>* u_fstropen </td>
<td>(</td>
<td class="paramtype">UChar * </td>
<td class="paramname"> <em>stringBuf</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td>
<td class="paramname"> <em>capacity</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>locale</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Create a UFILE that can be used for localized formatting or parsing.
<p>
The u_sprintf and u_sscanf functions do not read or write numbers for a specific locale. The <a class="el" href="ustdio_8h.html">ustdio.h</a> file functions can be used on this UFILE. The string is usable once u_fclose or u_fflush has been called on the returned UFILE. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>stringBuf</em> </td><td>The string used for reading or writing. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>capacity</em> </td><td>The number of code units available for use in stringBuf </td></tr>
<tr><td valign="top"></td><td valign="top"><em>locale</em> </td><td>The locale whose conventions will be used to format and parse output. If this parameter is NULL, the default locale will be used. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>A new UFILE, or NULL if an error occurred. </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000229">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="b7af5c4e67fb85222cd17f4b72dd37d3"></a><!-- doxytag: member="ustdio.h::u_fungetc" ref="b7af5c4e67fb85222cd17f4b72dd37d3" args="(UChar32 c, UFILE *f)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="umachine_8h.html#a5c18ea10e60c576fe5ec420a7ef7b28">UChar32</a> u_fungetc </td>
<td>(</td>
<td class="paramtype"><a class="el" href="umachine_8h.html#a5c18ea10e60c576fe5ec420a7ef7b28">UChar32</a> </td>
<td class="paramname"> <em>c</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>f</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Unget a UChar from a UFILE.
<p>
If this function is not the first to operate on <code>f</code> after a call to <code>u_fgetc</code>, the results are undefined. If this function is passed a character that was not recieved from the previous <code>u_fgetc</code> or <code>u_fgetcx</code> call, the results are undefined. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>c</em> </td><td>The UChar to put back on the stream. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>f</em> </td><td>The UFILE to receive <code>c</code>. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The UChar32 value put back if successful, U_EOF otherwise. </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000254">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="6ba527404930481df717c0cb39c1bf44"></a><!-- doxytag: member="ustdio.h::u_snprintf" ref="6ba527404930481df717c0cb39c1bf44" args="(UChar *buffer, int32_t count, const char *patternSpecification,...)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> u_snprintf </td>
<td>(</td>
<td class="paramtype">UChar * </td>
<td class="paramname"> <em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td>
<td class="paramname"> <em>count</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>patternSpecification</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname"> <em>...</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Write formatted data to a Unicode string.
<p>
When the number of code units required to store the data exceeds <code>count</code>, then <code>count</code> code units of data are stored in <code>buffer</code> and a negative value is returned. When the number of code units required to store the data equals <code>count</code>, the string is not null terminated and <code>count</code> is returned.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>buffer</em> </td><td>The Unicode String to which to write. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>count</em> </td><td>The number of code units to read. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>patternSpecification</em> </td><td>A pattern specifying how <code>u_sprintf</code> will interpret the variable arguments received and format the data. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of Unicode code units written to <code>buffer</code>. This does not include the terminating null character. </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000258">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="ca966c49bcf2267ce4034fb2a4a0572a"></a><!-- doxytag: member="ustdio.h::u_snprintf_u" ref="ca966c49bcf2267ce4034fb2a4a0572a" args="(UChar *buffer, int32_t count, const UChar *patternSpecification,...)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> u_snprintf_u </td>
<td>(</td>
<td class="paramtype">UChar * </td>
<td class="paramname"> <em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td>
<td class="paramname"> <em>count</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const UChar * </td>
<td class="paramname"> <em>patternSpecification</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname"> <em>...</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Write formatted data to a Unicode string.
<p>
When the number of code units required to store the data exceeds <code>count</code>, then <code>count</code> code units of data are stored in <code>buffer</code> and a negative value is returned. When the number of code units required to store the data equals <code>count</code>, the string is not null terminated and <code>count</code> is returned.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>buffer</em> </td><td>The Unicode string to which to write. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>count</em> </td><td>The number of code units to read. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>patternSpecification</em> </td><td>A pattern specifying how <code>u_sprintf</code> will interpret the variable arguments received and format the data. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of Unicode characters written to <code>buffer</code>. </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000262">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="93adbe84f54e0b10cfd1bdd3f8cf55f5"></a><!-- doxytag: member="ustdio.h::u_sprintf" ref="93adbe84f54e0b10cfd1bdd3f8cf55f5" args="(UChar *buffer, const char *patternSpecification,...)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> u_sprintf </td>
<td>(</td>
<td class="paramtype">UChar * </td>
<td class="paramname"> <em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>patternSpecification</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname"> <em>...</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Write formatted data to a Unicode string.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>buffer</em> </td><td>The Unicode String to which to write. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>patternSpecification</em> </td><td>A pattern specifying how <code>u_sprintf</code> will interpret the variable arguments received and format the data. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of Unicode code units written to <code>buffer</code>. This does not include the terminating null character. </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000257">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="66a9ea5d891b4ebe21545fea9d3c7754"></a><!-- doxytag: member="ustdio.h::u_sprintf_u" ref="66a9ea5d891b4ebe21545fea9d3c7754" args="(UChar *buffer, const UChar *patternSpecification,...)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> u_sprintf_u </td>
<td>(</td>
<td class="paramtype">UChar * </td>
<td class="paramname"> <em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const UChar * </td>
<td class="paramname"> <em>patternSpecification</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname"> <em>...</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Write formatted data to a Unicode string.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>buffer</em> </td><td>The Unicode string to which to write. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>patternSpecification</em> </td><td>A pattern specifying how <code>u_sprintf</code> will interpret the variable arguments received and format the data. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of Unicode characters written to <code>buffer</code>. </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000261">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="2846495827c41434a1c0745792844d7b"></a><!-- doxytag: member="ustdio.h::u_sscanf" ref="2846495827c41434a1c0745792844d7b" args="(const UChar *buffer, const char *patternSpecification,...)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> u_sscanf </td>
<td>(</td>
<td class="paramtype">const UChar * </td>
<td class="paramname"> <em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>patternSpecification</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname"> <em>...</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Read formatted data from a Unicode string.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>buffer</em> </td><td>The Unicode string from which to read. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>patternSpecification</em> </td><td>A pattern specifying how <code>u_sscanf</code> will interpret the variable arguments received and parse the data. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of items successfully converted and assigned, or EOF if an error occurred. </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000265">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="64731359739dc52e6b5d71c14f61067d"></a><!-- doxytag: member="ustdio.h::u_sscanf_u" ref="64731359739dc52e6b5d71c14f61067d" args="(const UChar *buffer, const UChar *patternSpecification,...)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> u_sscanf_u </td>
<td>(</td>
<td class="paramtype">const UChar * </td>
<td class="paramname"> <em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const UChar * </td>
<td class="paramname"> <em>patternSpecification</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"> </td>
<td class="paramname"> <em>...</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Read formatted data from a Unicode string.
<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>buffer</em> </td><td>The Unicode string from which to read. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>patternSpecification</em> </td><td>A pattern specifying how <code>u_sscanf</code> will interpret the variable arguments received and parse the data. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of items successfully converted and assigned, or EOF if an error occurred. </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000267">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="b0dc36c4d83d46433d7260d761da8da7"></a><!-- doxytag: member="ustdio.h::u_vfprintf" ref="b0dc36c4d83d46433d7260d761da8da7" args="(UFILE *f, const char *patternSpecification, va_list ap)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> u_vfprintf </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>f</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>patternSpecification</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">va_list </td>
<td class="paramname"> <em>ap</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Write formatted data to a UFILE.
<p>
This is identical to <code>u_fprintf</code>, except that it will <em>not</em> call <code>va_start</code> and <code>va_end</code>. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>f</em> </td><td>The UFILE to which to write. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>patternSpecification</em> </td><td>A pattern specifying how <code>u_fprintf</code> will interpret the variable arguments received and format the data. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>ap</em> </td><td>The argument list to use. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of Unicode characters written to <code>f</code>. </dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="ustdio_8h.html#28f8f1f5b3f6e898ee9383ddec537c60">u_fprintf</a> </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000241">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="89140702e806585905ef4906c533da95"></a><!-- doxytag: member="ustdio.h::u_vfprintf_u" ref="89140702e806585905ef4906c533da95" args="(UFILE *f, const UChar *patternSpecification, va_list ap)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> u_vfprintf_u </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>f</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const UChar * </td>
<td class="paramname"> <em>patternSpecification</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">va_list </td>
<td class="paramname"> <em>ap</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Write formatted data to a UFILE.
<p>
This is identical to <code>u_fprintf_u</code>, except that it will <em>not</em> call <code>va_start</code> and <code>va_end</code>. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>f</em> </td><td>The UFILE to which to write. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>patternSpecification</em> </td><td>A pattern specifying how <code>u_fprintf</code> will interpret the variable arguments received and format the data. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>ap</em> </td><td>The argument list to use. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of Unicode characters written to <code>f</code>. </dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="ustdio_8h.html#ab9f1461211b7f9cef3f125f7c819107">u_fprintf_u</a> </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000243">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="0f59af360869d8c33bed8c033f1feec8"></a><!-- doxytag: member="ustdio.h::u_vfscanf" ref="0f59af360869d8c33bed8c033f1feec8" args="(UFILE *f, const char *patternSpecification, va_list ap)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> u_vfscanf </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>f</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>patternSpecification</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">va_list </td>
<td class="paramname"> <em>ap</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Read formatted data from a UFILE.
<p>
This is identical to <code>u_fscanf</code>, except that it will <em>not</em> call <code>va_start</code> and <code>va_end</code>. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>f</em> </td><td>The UFILE from which to read. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>patternSpecification</em> </td><td>A pattern specifying how <code>u_fscanf</code> will interpret the variable arguments received and parse the data. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>ap</em> </td><td>The argument list to use. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of items successfully converted and assigned, or EOF if an error occurred. </dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="ustdio_8h.html#a75bf38f906695dde98458b22b4593d5">u_fscanf</a> </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000248">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="0efaf37b28088255532aa6438e1edb44"></a><!-- doxytag: member="ustdio.h::u_vfscanf_u" ref="0efaf37b28088255532aa6438e1edb44" args="(UFILE *f, const UChar *patternSpecification, va_list ap)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> u_vfscanf_u </td>
<td>(</td>
<td class="paramtype"><a class="el" href="ustdio_8h.html#b64abe9afc8691b9d6d6bc76977979c0">UFILE</a> * </td>
<td class="paramname"> <em>f</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const UChar * </td>
<td class="paramname"> <em>patternSpecification</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">va_list </td>
<td class="paramname"> <em>ap</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Read formatted data from a UFILE.
<p>
This is identical to <code>u_fscanf_u</code>, except that it will <em>not</em> call <code>va_start</code> and <code>va_end</code>. <dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>f</em> </td><td>The UFILE from which to read. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>patternSpecification</em> </td><td>A pattern specifying how <code>u_fscanf</code> will interpret the variable arguments received and parse the data. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>ap</em> </td><td>The argument list to use. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of items successfully converted and assigned, or EOF if an error occurred. </dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="ustdio_8h.html#cc97e7946c1c60b6dcb4e975b4abd1f1">u_fscanf_u</a> </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000250">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="08dd63aa5987875df610a26fb17301ad"></a><!-- doxytag: member="ustdio.h::u_vsnprintf" ref="08dd63aa5987875df610a26fb17301ad" args="(UChar *buffer, int32_t count, const char *patternSpecification, va_list ap)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> u_vsnprintf </td>
<td>(</td>
<td class="paramtype">UChar * </td>
<td class="paramname"> <em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td>
<td class="paramname"> <em>count</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>patternSpecification</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">va_list </td>
<td class="paramname"> <em>ap</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Write formatted data to a Unicode string.
<p>
This is identical to <code>u_snprintf</code>, except that it will <em>not</em> call <code>va_start</code> and <code>va_end</code>.<br>
<br>
When the number of code units required to store the data exceeds <code>count</code>, then <code>count</code> code units of data are stored in <code>buffer</code> and a negative value is returned. When the number of code units required to store the data equals <code>count</code>, the string is not null terminated and <code>count</code> is returned.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>buffer</em> </td><td>The Unicode string to which to write. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>count</em> </td><td>The number of code units to read. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>patternSpecification</em> </td><td>A pattern specifying how <code>u_sprintf</code> will interpret the variable arguments received and format the data. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>ap</em> </td><td>The argument list to use. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of Unicode characters written to <code>buffer</code>. </dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="ustdio_8h.html#93adbe84f54e0b10cfd1bdd3f8cf55f5">u_sprintf</a> </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000260">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="6ff9eae8064d77238350a88009597071"></a><!-- doxytag: member="ustdio.h::u_vsnprintf_u" ref="6ff9eae8064d77238350a88009597071" args="(UChar *buffer, int32_t count, const UChar *patternSpecification, va_list ap)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> u_vsnprintf_u </td>
<td>(</td>
<td class="paramtype">UChar * </td>
<td class="paramname"> <em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> </td>
<td class="paramname"> <em>count</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const UChar * </td>
<td class="paramname"> <em>patternSpecification</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">va_list </td>
<td class="paramname"> <em>ap</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Write formatted data to a Unicode string.
<p>
This is identical to <code>u_snprintf_u</code>, except that it will <em>not</em> call <code>va_start</code> and <code>va_end</code>. When the number of code units required to store the data exceeds <code>count</code>, then <code>count</code> code units of data are stored in <code>buffer</code> and a negative value is returned. When the number of code units required to store the data equals <code>count</code>, the string is not null terminated and <code>count</code> is returned.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>buffer</em> </td><td>The Unicode string to which to write. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>count</em> </td><td>The number of code units to read. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>patternSpecification</em> </td><td>A pattern specifying how <code>u_sprintf</code> will interpret the variable arguments received and format the data. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>ap</em> </td><td>The argument list to use. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of Unicode characters written to <code>f</code>. </dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="ustdio_8h.html#66a9ea5d891b4ebe21545fea9d3c7754">u_sprintf_u</a> </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000264">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="0371020d25c4adf0b9e91eca291b1ba4"></a><!-- doxytag: member="ustdio.h::u_vsprintf" ref="0371020d25c4adf0b9e91eca291b1ba4" args="(UChar *buffer, const char *patternSpecification, va_list ap)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> u_vsprintf </td>
<td>(</td>
<td class="paramtype">UChar * </td>
<td class="paramname"> <em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>patternSpecification</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">va_list </td>
<td class="paramname"> <em>ap</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Write formatted data to a Unicode string.
<p>
This is identical to <code>u_sprintf</code>, except that it will <em>not</em> call <code>va_start</code> and <code>va_end</code>.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>buffer</em> </td><td>The Unicode string to which to write. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>patternSpecification</em> </td><td>A pattern specifying how <code>u_sprintf</code> will interpret the variable arguments received and format the data. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>ap</em> </td><td>The argument list to use. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of Unicode characters written to <code>buffer</code>. </dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="ustdio_8h.html#93adbe84f54e0b10cfd1bdd3f8cf55f5">u_sprintf</a> </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000259">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="f5b433ef037b3f3154b8d2193a8dded5"></a><!-- doxytag: member="ustdio.h::u_vsprintf_u" ref="f5b433ef037b3f3154b8d2193a8dded5" args="(UChar *buffer, const UChar *patternSpecification, va_list ap)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> u_vsprintf_u </td>
<td>(</td>
<td class="paramtype">UChar * </td>
<td class="paramname"> <em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const UChar * </td>
<td class="paramname"> <em>patternSpecification</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">va_list </td>
<td class="paramname"> <em>ap</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Write formatted data to a Unicode string.
<p>
This is identical to <code>u_sprintf_u</code>, except that it will <em>not</em> call <code>va_start</code> and <code>va_end</code>.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>buffer</em> </td><td>The Unicode string to which to write. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>patternSpecification</em> </td><td>A pattern specifying how <code>u_sprintf</code> will interpret the variable arguments received and format the data. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>ap</em> </td><td>The argument list to use. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of Unicode characters written to <code>f</code>. </dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="ustdio_8h.html#66a9ea5d891b4ebe21545fea9d3c7754">u_sprintf_u</a> </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000263">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="52bdbdf16334b09ae4985e497d9662d2"></a><!-- doxytag: member="ustdio.h::u_vsscanf" ref="52bdbdf16334b09ae4985e497d9662d2" args="(const UChar *buffer, const char *patternSpecification, va_list ap)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> u_vsscanf </td>
<td>(</td>
<td class="paramtype">const UChar * </td>
<td class="paramname"> <em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const char * </td>
<td class="paramname"> <em>patternSpecification</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">va_list </td>
<td class="paramname"> <em>ap</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Read formatted data from a Unicode string.
<p>
This is identical to <code>u_sscanf</code>, except that it will <em>not</em> call <code>va_start</code> and <code>va_end</code>.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>buffer</em> </td><td>The Unicode string from which to read. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>patternSpecification</em> </td><td>A pattern specifying how <code>u_sscanf</code> will interpret the variable arguments received and parse the data. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>ap</em> </td><td>The argument list to use. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of items successfully converted and assigned, or EOF if an error occurred. </dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="ustdio_8h.html#2846495827c41434a1c0745792844d7b">u_sscanf</a> </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000266">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<a class="anchor" name="09a0181d6e73b16df1d3fb6a35c81c31"></a><!-- doxytag: member="ustdio.h::u_vsscanf_u" ref="09a0181d6e73b16df1d3fb6a35c81c31" args="(const UChar *buffer, const UChar *patternSpecification, va_list ap)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="el" href="pwin32_8h.html#f03f47ee300d26bee7dd521b1169f394">int32_t</a> u_vsscanf_u </td>
<td>(</td>
<td class="paramtype">const UChar * </td>
<td class="paramname"> <em>buffer</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const UChar * </td>
<td class="paramname"> <em>patternSpecification</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">va_list </td>
<td class="paramname"> <em>ap</em></td><td> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td><td width="100%"></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>
Read formatted data from a Unicode string.
<p>
This is identical to <code>u_sscanf_u</code>, except that it will <em>not</em> call <code>va_start</code> and <code>va_end</code>.<p>
<dl compact><dt><b>Parameters:</b></dt><dd>
<table border="0" cellspacing="2" cellpadding="0">
<tr><td valign="top"></td><td valign="top"><em>buffer</em> </td><td>The Unicode string from which to read. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>patternSpecification</em> </td><td>A pattern specifying how <code>u_sscanf</code> will interpret the variable arguments received and parse the data. </td></tr>
<tr><td valign="top"></td><td valign="top"><em>ap</em> </td><td>The argument list to use. </td></tr>
</table>
</dl>
<dl compact><dt><b>Returns:</b></dt><dd>The number of items successfully converted and assigned, or EOF if an error occurred. </dd></dl>
<dl compact><dt><b>See also:</b></dt><dd><a class="el" href="ustdio_8h.html#64731359739dc52e6b5d71c14f61067d">u_sscanf_u</a> </dd></dl>
<dl compact><dt><b><a class="el" href="draft.html#_draft000268">Draft:</a></b></dt><dd>This API may be changed in the future versions and was introduced in 3.0 </dd></dl>
</div>
</div><p>
<hr size="1"><address style="align: right;"><small>Generated on Tue Dec 13 17:29:52 2011 for ICU 3.6 by
<a href="http://www.doxygen.org/index.html">
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.4.7 </small></address>
</body>
</html>
