summaryrefslogtreecommitdiff
path: root/Build/source/libs/icu-xetex/io/unicode/ustdio.h
diff options
context:
space:
mode:
Diffstat (limited to 'Build/source/libs/icu-xetex/io/unicode/ustdio.h')
-rw-r--r--Build/source/libs/icu-xetex/io/unicode/ustdio.h137
1 files changed, 70 insertions, 67 deletions
diff --git a/Build/source/libs/icu-xetex/io/unicode/ustdio.h b/Build/source/libs/icu-xetex/io/unicode/ustdio.h
index d7140fefea3..4675e77c928 100644
--- a/Build/source/libs/icu-xetex/io/unicode/ustdio.h
+++ b/Build/source/libs/icu-xetex/io/unicode/ustdio.h
@@ -1,7 +1,7 @@
/*
******************************************************************************
*
-* Copyright (C) 1998-2005, International Business Machines
+* Copyright (C) 1998-2006, International Business Machines
* Corporation and others. All Rights Reserved.
*
******************************************************************************
@@ -120,30 +120,30 @@
* %[*][format modifier][width][type modifier][format]
*
<table cellspacing="3">
-<tr><td>format</td><td>default<br>type</td><td>description</td></tr>
-<tr><td>%E</td><td>double</td><td>Scientific with an uppercase exponent</td></tr>
-<tr><td>%e</td><td>double</td><td>Scientific with a lowercase exponent</td></tr>
-<tr><td>%G</td><td>double</td><td>Use %E or %f for best format</td></tr>
-<tr><td>%g</td><td>double</td><td>Use %e or %f for best format</td></tr>
-<tr><td>%f</td><td>double</td><td>Simple floating point without the exponent</td></tr>
-<tr><td>%X</td><td>int32_t</td><td>ustdio special uppercase hex radix formatting</td></tr>
-<tr><td>%x</td><td>int32_t</td><td>ustdio special lowercase hex radix formatting</td></tr>
-<tr><td>%d</td><td>int32_t</td><td>Decimal format</td></tr>
-<tr><td>%i</td><td>int32_t</td><td>Same as %d</td></tr>
-<tr><td>%n</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>ustdio special octal radix formatting</td></tr>
-<tr><td>%u</td><td>uint32_t</td><td>Decimal format</td></tr>
-<tr><td>%p</td><td>void *</td><td>Prints the pointer value</td></tr>
-<tr><td>%s</td><td>char *</td><td>Use default converter or specified converter from fopen</td></tr>
-<tr><td>%c</td><td>char</td><td>Use default converter or specified converter from fopen<br>
-When width is specified, this acts like a non-NULL-terminated char * string.<br>
+<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>Null terminated UTF-16 string</td></tr>
-<tr><td>%C</td><td>UChar</td><td>16-bit Unicode code unit<br>
-When width is specified, this acts like a non-NULL-terminated UChar * string<br>
+<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>UChar *</td><td>(scanf only) Null terminated UTF-16 string which contains the filtered set of characters specified by the UnicodeSet</td></tr>
-<tr><td>%%</td><td>N/A</td><td>Show a percent sign</td></tr>
+<tr><td>%[]</td><td>&nbsp;</td><td>UChar *</td><td>Null terminated UTF-16 string which contains the filtered set of characters specified by the UnicodeSet</td></tr>
+<tr><td>%%</td><td>&nbsp;</td><td>&nbsp;</td><td>Show a percent sign</td></tr>
</table>
Format modifiers
@@ -186,13 +186,14 @@ scanf modifier
/**
* When an end of file is encountered, this value can be returned.
* @see u_fgetc
- * @draft 3.0
+ * @stable 3.0
*/
#define U_EOF 0xFFFF
-/** Forward declaration of a Unicode-aware file @draft 3.0 */
+/** Forward declaration of a Unicode-aware file @stable 3.0 */
typedef struct UFILE UFILE;
+#ifndef U_HIDE_DRAFT_API
/**
* Enum for which direction of stream a transliterator applies to.
* @see u_fsettransliterator
@@ -204,6 +205,8 @@ typedef enum {
U_READWRITE =3 /* == (U_READ | U_WRITE) */
} UFileDirection;
+#endif /* U_HIDE_DRAFT_API */
+
/**
* Open a UFILE.
* A UFILE is a wrapper around a FILE* that is locale and codepage aware.
@@ -221,7 +224,7 @@ typedef enum {
* @return A new UFILE, or NULL if an error occurred.
* @draft 3.0
*/
-U_CAPI UFILE* U_EXPORT2
+U_DRAFT UFILE* U_EXPORT2
u_fopen(const char *filename,
const char *perm,
const char *locale,
@@ -240,7 +243,7 @@ u_fopen(const char *filename,
* @return A new UFILE, or NULL if an error occurred.
* @draft 3.0
*/
-U_CAPI UFILE* U_EXPORT2
+U_DRAFT UFILE* U_EXPORT2
u_finit(FILE *f,
const char *locale,
const char *codepage);
@@ -259,7 +262,7 @@ u_finit(FILE *f,
* @return A new UFILE, or NULL if an error occurred.
* @draft 3.0
*/
-U_CAPI UFILE* U_EXPORT2
+U_DRAFT UFILE* U_EXPORT2
u_fstropen(UChar *stringBuf,
int32_t capacity,
const char *locale);
@@ -269,7 +272,7 @@ u_fstropen(UChar *stringBuf,
* @param file The UFILE to close.
* @draft 3.0
*/
-U_CAPI void U_EXPORT2
+U_DRAFT void U_EXPORT2
u_fclose(UFILE *file);
/**
@@ -280,7 +283,7 @@ u_fclose(UFILE *file);
* not end of file.
* @draft 3.0
*/
-U_CAPI UBool U_EXPORT2
+U_DRAFT UBool U_EXPORT2
u_feof(UFILE *f);
/**
@@ -291,7 +294,7 @@ u_feof(UFILE *f);
* @param file The UFILE to flush.
* @draft 3.0
*/
-U_CAPI void U_EXPORT2
+U_DRAFT void U_EXPORT2
u_fflush(UFILE *file);
/**
@@ -299,7 +302,7 @@ u_fflush(UFILE *file);
* @param file The UFILE to rewind.
* @draft 3.0
*/
-U_CAPI void
+U_DRAFT void
u_frewind(UFILE *file);
/**
@@ -308,7 +311,7 @@ u_frewind(UFILE *file);
* @return A FILE*, owned by the UFILE. The FILE <EM>must not</EM> be closed.
* @draft 3.0
*/
-U_CAPI FILE* U_EXPORT2
+U_DRAFT FILE* U_EXPORT2
u_fgetfile(UFILE *f);
#if !UCONFIG_NO_FORMATTING
@@ -321,7 +324,7 @@ u_fgetfile(UFILE *f);
* @return The locale whose conventions are used to format and parse output.
* @draft 3.0
*/
-U_CAPI const char* U_EXPORT2
+U_DRAFT const char* U_EXPORT2
u_fgetlocale(UFILE *file);
/**
@@ -332,7 +335,7 @@ u_fgetlocale(UFILE *file);
* @return NULL if successful, otherwise a negative number.
* @draft 3.0
*/
-U_CAPI int32_t U_EXPORT2
+U_DRAFT int32_t U_EXPORT2
u_fsetlocale(UFILE *file,
const char *locale);
@@ -347,7 +350,7 @@ u_fsetlocale(UFILE *file,
* or NULL if an error occurred.
* @draft 3.0
*/
-U_CAPI const char* U_EXPORT2
+U_DRAFT const char* U_EXPORT2
u_fgetcodepage(UFILE *file);
/**
@@ -365,7 +368,7 @@ u_fgetcodepage(UFILE *file);
* @see u_frewind
* @draft 3.0
*/
-U_CAPI int32_t U_EXPORT2
+U_DRAFT int32_t U_EXPORT2
u_fsetcodepage(const char *codepage,
UFILE *file);
@@ -376,7 +379,7 @@ u_fsetcodepage(const char *codepage,
* @return alias to the converter
* @draft 3.0
*/
-U_CAPI UConverter* U_EXPORT2 u_fgetConverter(UFILE *f);
+U_DRAFT UConverter* U_EXPORT2 u_fgetConverter(UFILE *f);
#if !UCONFIG_NO_FORMATTING
@@ -390,7 +393,7 @@ U_CAPI UConverter* U_EXPORT2 u_fgetConverter(UFILE *f);
* @return The number of Unicode characters written to <TT>f</TT>.
* @draft 3.0
*/
-U_CAPI int32_t U_EXPORT2
+U_DRAFT int32_t U_EXPORT2
u_fprintf(UFILE *f,
const char *patternSpecification,
... );
@@ -407,7 +410,7 @@ u_fprintf(UFILE *f,
* @see u_fprintf
* @draft 3.0
*/
-U_CAPI int32_t U_EXPORT2
+U_DRAFT int32_t U_EXPORT2
u_vfprintf(UFILE *f,
const char *patternSpecification,
va_list ap);
@@ -420,7 +423,7 @@ u_vfprintf(UFILE *f,
* @return The number of Unicode characters written to <TT>f</TT>.
* @draft 3.0
*/
-U_CAPI int32_t U_EXPORT2
+U_DRAFT int32_t U_EXPORT2
u_fprintf_u(UFILE *f,
const UChar *patternSpecification,
... );
@@ -437,7 +440,7 @@ u_fprintf_u(UFILE *f,
* @see u_fprintf_u
* @draft 3.0
*/
-U_CAPI int32_t U_EXPORT2
+U_DRAFT int32_t U_EXPORT2
u_vfprintf_u(UFILE *f,
const UChar *patternSpecification,
va_list ap);
@@ -452,7 +455,7 @@ u_vfprintf_u(UFILE *f,
* @see u_file_write
* @draft 3.0
*/
-U_CAPI int32_t U_EXPORT2
+U_DRAFT int32_t U_EXPORT2
u_fputs(const UChar *s,
UFILE *f);
@@ -463,7 +466,7 @@ u_fputs(const UChar *s,
* @return The character written if successful, EOF otherwise.
* @draft 3.0
*/
-U_CAPI UChar32 U_EXPORT2
+U_DRAFT UChar32 U_EXPORT2
u_fputc(UChar32 uc,
UFILE *f);
@@ -478,7 +481,7 @@ u_fputc(UChar32 uc,
* @see u_fputs
* @draft 3.0
*/
-U_CAPI int32_t U_EXPORT2
+U_DRAFT int32_t U_EXPORT2
u_file_write(const UChar *ustring,
int32_t count,
UFILE *f);
@@ -496,7 +499,7 @@ u_file_write(const UChar *ustring,
* if an error occurred.
* @draft 3.0
*/
-U_CAPI int32_t U_EXPORT2
+U_DRAFT int32_t U_EXPORT2
u_fscanf(UFILE *f,
const char *patternSpecification,
... );
@@ -514,7 +517,7 @@ u_fscanf(UFILE *f,
* @see u_fscanf
* @draft 3.0
*/
-U_CAPI int32_t U_EXPORT2
+U_DRAFT int32_t U_EXPORT2
u_vfscanf(UFILE *f,
const char *patternSpecification,
va_list ap);
@@ -528,7 +531,7 @@ u_vfscanf(UFILE *f,
* if an error occurred.
* @draft 3.0
*/
-U_CAPI int32_t U_EXPORT2
+U_DRAFT int32_t U_EXPORT2
u_fscanf_u(UFILE *f,
const UChar *patternSpecification,
... );
@@ -546,7 +549,7 @@ u_fscanf_u(UFILE *f,
* @see u_fscanf_u
* @draft 3.0
*/
-U_CAPI int32_t U_EXPORT2
+U_DRAFT int32_t U_EXPORT2
u_vfscanf_u(UFILE *f,
const UChar *patternSpecification,
va_list ap);
@@ -564,7 +567,7 @@ u_vfscanf_u(UFILE *f,
* @return A pointer to <TT>s</TT>, or NULL if no characters were available.
* @draft 3.0
*/
-U_CAPI UChar* U_EXPORT2
+U_DRAFT UChar* U_EXPORT2
u_fgets(UChar *s,
int32_t n,
UFILE *f);
@@ -578,7 +581,7 @@ u_fgets(UChar *s,
* @return The UChar value read, or U+FFFF if no character was available.
* @draft 3.0
*/
-U_CAPI UChar U_EXPORT2
+U_DRAFT UChar U_EXPORT2
u_fgetc(UFILE *f);
/**
@@ -591,7 +594,7 @@ u_fgetc(UFILE *f);
* @see u_unescape()
* @draft 3.0
*/
-U_CAPI UChar32 U_EXPORT2
+U_DRAFT UChar32 U_EXPORT2
u_fgetcx(UFILE *f);
/**
@@ -605,7 +608,7 @@ u_fgetcx(UFILE *f);
* @return The UChar32 value put back if successful, U_EOF otherwise.
* @draft 3.0
*/
-U_CAPI UChar32 U_EXPORT2
+U_DRAFT UChar32 U_EXPORT2
u_fungetc(UChar32 c,
UFILE *f);
@@ -619,7 +622,7 @@ u_fungetc(UChar32 c,
* @return The number of Unicode characters read.
* @draft 3.0
*/
-U_CAPI int32_t U_EXPORT2
+U_DRAFT int32_t U_EXPORT2
u_file_read(UChar *chars,
int32_t count,
UFILE *f);
@@ -643,7 +646,7 @@ u_file_read(UChar *chars,
* on the result of this function.
* @draft 3.0
*/
-U_CAPI UTransliterator* U_EXPORT2
+U_DRAFT UTransliterator* U_EXPORT2
u_fsettransliterator(UFILE *file, UFileDirection direction,
UTransliterator *adopt, UErrorCode *status);
@@ -664,7 +667,7 @@ u_fsettransliterator(UFILE *file, UFileDirection direction,
* does not include the terminating null character.
* @draft 3.0
*/
-U_CAPI int32_t U_EXPORT2
+U_DRAFT int32_t U_EXPORT2
u_sprintf(UChar *buffer,
const char *patternSpecification,
... );
@@ -685,7 +688,7 @@ u_sprintf(UChar *buffer,
* does not include the terminating null character.
* @draft 3.0
*/
-U_CAPI int32_t U_EXPORT2
+U_DRAFT int32_t U_EXPORT2
u_snprintf(UChar *buffer,
int32_t count,
const char *patternSpecification,
@@ -704,7 +707,7 @@ u_snprintf(UChar *buffer,
* @see u_sprintf
* @draft 3.0
*/
-U_CAPI int32_t U_EXPORT2
+U_DRAFT int32_t U_EXPORT2
u_vsprintf(UChar *buffer,
const char *patternSpecification,
va_list ap);
@@ -728,7 +731,7 @@ u_vsprintf(UChar *buffer,
* @see u_sprintf
* @draft 3.0
*/
-U_CAPI int32_t U_EXPORT2
+U_DRAFT int32_t U_EXPORT2
u_vsnprintf(UChar *buffer,
int32_t count,
const char *patternSpecification,
@@ -743,7 +746,7 @@ u_vsnprintf(UChar *buffer,
* @return The number of Unicode characters written to <TT>buffer</TT>.
* @draft 3.0
*/
-U_CAPI int32_t U_EXPORT2
+U_DRAFT int32_t U_EXPORT2
u_sprintf_u(UChar *buffer,
const UChar *patternSpecification,
... );
@@ -763,7 +766,7 @@ u_sprintf_u(UChar *buffer,
* @return The number of Unicode characters written to <TT>buffer</TT>.
* @draft 3.0
*/
-U_CAPI int32_t U_EXPORT2
+U_DRAFT int32_t U_EXPORT2
u_snprintf_u(UChar *buffer,
int32_t count,
const UChar *patternSpecification,
@@ -782,7 +785,7 @@ u_snprintf_u(UChar *buffer,
* @see u_sprintf_u
* @draft 3.0
*/
-U_CAPI int32_t U_EXPORT2
+U_DRAFT int32_t U_EXPORT2
u_vsprintf_u(UChar *buffer,
const UChar *patternSpecification,
va_list ap);
@@ -806,7 +809,7 @@ u_vsprintf_u(UChar *buffer,
* @see u_sprintf_u
* @draft 3.0
*/
-U_CAPI int32_t U_EXPORT2
+U_DRAFT int32_t U_EXPORT2
u_vsnprintf_u(UChar *buffer,
int32_t count,
const UChar *patternSpecification,
@@ -824,7 +827,7 @@ u_vsnprintf_u(UChar *buffer,
* if an error occurred.
* @draft 3.0
*/
-U_CAPI int32_t U_EXPORT2
+U_DRAFT int32_t U_EXPORT2
u_sscanf(const UChar *buffer,
const char *patternSpecification,
... );
@@ -843,7 +846,7 @@ u_sscanf(const UChar *buffer,
* @see u_sscanf
* @draft 3.0
*/
-U_CAPI int32_t U_EXPORT2
+U_DRAFT int32_t U_EXPORT2
u_vsscanf(const UChar *buffer,
const char *patternSpecification,
va_list ap);
@@ -858,7 +861,7 @@ u_vsscanf(const UChar *buffer,
* if an error occurred.
* @draft 3.0
*/
-U_CAPI int32_t U_EXPORT2
+U_DRAFT int32_t U_EXPORT2
u_sscanf_u(const UChar *buffer,
const UChar *patternSpecification,
... );
@@ -877,7 +880,7 @@ u_sscanf_u(const UChar *buffer,
* @see u_sscanf_u
* @draft 3.0
*/
-U_CAPI int32_t U_EXPORT2
+U_DRAFT int32_t U_EXPORT2
u_vsscanf_u(const UChar *buffer,
const UChar *patternSpecification,
va_list ap);