Typedefs | |||
![]() | ![]() | typedef struct UFILE | UFILE |
![]() | ![]() | Forward declaration of a Unicode-aware file. | |
Functions | |||
![]() | ![]() | U_CAPI UFILE* U_EXPORT2 | u_fopen (const char *filename, const char *perm, const char *locale, const char *codepage) |
![]() | ![]() | Open a UFILE. More... | |
![]() | ![]() | U_CAPI UFILE* U_EXPORT2 | u_finit (FILE *f, const char *locale, const char *codepage) |
![]() | ![]() | Open a UFILE on top of an existing FILE* stream. More... | |
![]() | ![]() | U_CAPI void U_EXPORT2 | u_fclose (UFILE *file) |
![]() | ![]() | Close a UFILE. More... | |
![]() | ![]() | U_CAPI FILE* U_EXPORT2 | u_fgetfile (UFILE *f) |
![]() | ![]() | Get the FILE* associated with a UFILE. More... | |
![]() | ![]() | U_CAPI const char* U_EXPORT2 | u_fgetlocale (UFILE *file) |
![]() | ![]() | Get the locale whose conventions are used to format and parse output. More... | |
![]() | ![]() | U_CAPI int32_t U_EXPORT2 | u_fsetlocale (const char *locale, UFILE *file) |
![]() | ![]() | Set the locale whose conventions will be used to format and parse output. More... | |
![]() | ![]() | U_CAPI const char* U_EXPORT2 | u_fgetcodepage (UFILE *file) |
![]() | ![]() | Get the codepage in which data is written to and read from the UFILE. More... | |
![]() | ![]() | U_CAPI int32_t U_EXPORT2 | u_fsetcodepage (const char *codepage, UFILE *file) |
![]() | ![]() | Set the codepage in which data will be written to and read from the UFILE. More... | |
![]() | ![]() | U_CAPI UConverter U_EXPORT2* | u_fgetConverter (UFILE *f) |
![]() | ![]() | Returns an alias to the converter being used for this file. More... | |
![]() | ![]() | U_CAPI int32_t U_EXPORT2 | u_fprintf ( UFILE *f, const char *patternSpecification, ... ) |
![]() | ![]() | Write formatted data to a UFILE. More... | |
![]() | ![]() | U_CAPI int32_t U_EXPORT2 | u_vfprintf ( UFILE *f, const char *patternSpecification, va_list ap) |
![]() | ![]() | Write formatted data to a UFILE. More... | |
![]() | ![]() | U_CAPI int32_t U_EXPORT2 | u_fprintf_u ( UFILE *f, const UChar *patternSpecification, ... ) |
![]() | ![]() | Write formatted data to a UFILE. More... | |
![]() | ![]() | U_CAPI int32_t U_EXPORT2 | u_vfprintf_u ( UFILE *f, const UChar *patternSpecification, va_list ap) |
![]() | ![]() | Write formatted data to a UFILE. More... | |
![]() | ![]() | U_CAPI int32_t U_EXPORT2 | u_fputs (const UChar *s, UFILE *f) |
![]() | ![]() | Write a Unicode to a UFILE. More... | |
![]() | ![]() | U_CAPI int32_t U_EXPORT2 | u_fputc (UChar uc, UFILE *f) |
![]() | ![]() | Write a UChar to a UFILE. More... | |
![]() | ![]() | U_CAPI int32_t U_EXPORT2 | u_file_write (const UChar *chars, int32_t count, UFILE *f) |
![]() | ![]() | Write Unicode to a UFILE. More... | |
![]() | ![]() | U_CAPI int32_t U_EXPORT2 | u_fscanf ( UFILE *f, const char *patternSpecification, ... ) |
![]() | ![]() | Read formatted data from a UFILE. More... | |
![]() | ![]() | U_CAPI int32_t U_EXPORT2 | u_vfscanf ( UFILE *f, const char *patternSpecification, va_list ap) |
![]() | ![]() | Read formatted data from a UFILE. More... | |
![]() | ![]() | U_CAPI int32_t U_EXPORT2 | u_fscanf_u ( UFILE *f, const UChar *patternSpecification, ... ) |
![]() | ![]() | Read formatted data from a UFILE. More... | |
![]() | ![]() | U_CAPI int32_t U_EXPORT2 | u_vfscanf_u ( UFILE *f, const UChar *patternSpecification, va_list ap) |
![]() | ![]() | Read formatted data from a UFILE. More... | |
![]() | ![]() | U_CAPI UChar* U_EXPORT2 | u_fgets (UFILE *f, int32_t n, UChar *s) |
![]() | ![]() | Read a UChar* from a UFILE. More... | |
![]() | ![]() | U_CAPI UChar U_EXPORT2 | u_fgetc (UFILE *f) |
![]() | ![]() | Read a UChar from a UFILE. More... | |
![]() | ![]() | U_CAPI UChar U_EXPORT2 | u_fungetc (UChar c, UFILE *f) |
![]() | ![]() | Unget a UChar from a UFILE. More... | |
![]() | ![]() | U_CAPI int32_t U_EXPORT2 | u_file_read (UChar *chars, int32_t count, UFILE *f) |
![]() | ![]() | Read Unicode from a UFILE. More... |
typedef struct UFILE UFILE |
Forward declaration of a Unicode-aware file.
U_CAPI UFILE *U_EXPORT2 u_fopen (const char * filename, const char * perm, const char * locale, const char * codepage) |
Open a UFILE.
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 Locale; this data will be in the character set specified by that UFILE's codepage.
filename | The name of the file to open. |
perm | The read/write permission for the UFILE; one of "r", "w", "rw" |
locale | The locale whose conventions will be used to format and parse output. If this parameter is NULL, the default locale will be used. |
codepage |
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 locale , unless locale is NULL, in which case the system default codepage will be used. |
U_CAPI UFILE *U_EXPORT2 u_finit (FILE * f, const char * locale, const char * codepage) |
Open a UFILE on top of an existing FILE* stream.
f | The FILE* to which this UFILE will attach. |
locale | The locale whose conventions will be used to format and parse output. If this parameter is NULL, the default locale will be used. |
codepage |
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 locale , unless locale is NULL, in which case the system default codepage will be used. |
U_CAPI void U_EXPORT2 u_fclose (UFILE * file) |
Close a UFILE.
file | The UFILE to close. |
U_CAPI FILE *U_EXPORT2 u_fgetfile (UFILE * f) |
Get the FILE* associated with a UFILE.
f | The UFILE |
U_CAPI const char *U_EXPORT2 u_fgetlocale (UFILE * file) |
Get the locale whose conventions are used to format and parse output.
This is the same locale passed in the preceding call tou_fsetlocale
or u_fopen
.
file | The UFILE to set. |
U_CAPI int32_t U_EXPORT2 u_fsetlocale (const char * locale, UFILE * file) |
Set the locale whose conventions will be used to format and parse output.
locale | The locale whose conventions will be used to format and parse output. |
file | The UFILE to query. |
U_CAPI const char *U_EXPORT2 u_fgetcodepage (UFILE * file) |
Get the codepage in which data is written to and read from the UFILE.
This is the same codepage passed in the preceding call to u_fsetcodepage
or u_fopen
.
file | The UFILE to query. |
U_CAPI int32_t U_EXPORT2 u_fsetcodepage (const char * codepage, UFILE * file) |
Set the codepage in which data will be written to and read from the UFILE.
All Unicode data written to the UFILE will be converted to this codepage before it is written to the underlying FILE*.
codepage |
The codepage in which data will be written to and read from the file. For example "latin-1" or "ibm-943 . A value of NULL means the default codepage for the UFILE's current locale will be used. |
file | The UFILE to set. |
U_CAPI UConverter U_EXPORT2 * u_fgetConverter (UFILE * f) |
Returns an alias to the converter being used for this file.
file | The UFILE to set. |
U_CAPI int32_t U_EXPORT2 u_fprintf (UFILE * f, const char * patternSpecification, ...) |
Write formatted data to a UFILE.
f | The UFILE to which to write. |
patternSpecification |
A pattern specifying how u_fprintf will interpret the variable arguments received and format the data. |
f
. U_CAPI int32_t U_EXPORT2 u_vfprintf (UFILE * f, const char * patternSpecification, va_list ap) |
Write formatted data to a UFILE.
This is identical to u_fprintf
, except that it will not call va_start/TT> and
va_end
.
f
The UFILE to which to write. patternSpecification
A pattern specifying how u_fprintf
will interpret the variable arguments received and format the data. ap
The argument list to use. f
.
U_CAPI int32_t U_EXPORT2 u_fprintf_u (UFILE * f, const UChar * patternSpecification, ...) |
Write formatted data to a UFILE.
f | The UFILE to which to write. |
patternSpecification |
A pattern specifying how u_fprintf will interpret the variable arguments received and format the data. |
f
. U_CAPI int32_t U_EXPORT2 u_vfprintf_u (UFILE * f, const UChar * patternSpecification, va_list ap) |
Write formatted data to a UFILE.
This is identical to u_fprintf_u
, except that it will not call va_start/TT> and
va_end
.
f
The UFILE to which to write. patternSpecification
A pattern specifying how u_fprintf
will interpret the variable arguments received and format the data. ap
The argument list to use. f
.
U_CAPI int32_t U_EXPORT2 u_fputs (const UChar * s, UFILE * f) |
Write a Unicode to a UFILE.
The null (U+0000) terminated UChar* s
will be written to f
, excluding the NULL terminator. A newline will be added to f
.
s | The UChar* to write. |
f | The UFILE to which to write. |
U_CAPI int32_t U_EXPORT2 u_fputc (UChar uc, UFILE * f) |
Write a UChar to a UFILE.
uc | The UChar to write. |
f | The UFILE to which to write. |
U_CAPI int32_t U_EXPORT2 u_file_write (const UChar * chars, int32_t count, UFILE * f) |
Write Unicode to a UFILE.
The ustring passed in will be converted to the UFILE's underlying codepage before it is written.
chars | A pointer to the Unicode data to write. |
count | The number of Unicode characters to write |
f | The UFILE to which to write. |
U_CAPI int32_t U_EXPORT2 u_fscanf (UFILE * f, const char * patternSpecification, ...) |
Read formatted data from a UFILE.
f | The UFILE from which to read. |
patternSpecification |
A pattern specifying how u_fscanf will interpret the variable arguments received and parse the data. |
U_CAPI int32_t U_EXPORT2 u_vfscanf (UFILE * f, const char * patternSpecification, va_list ap) |
Read formatted data from a UFILE.
This is identical to u_fscanf
, except that it will not call va_start/TT> and
va_end
.
f
The UFILE from which to read. patternSpecification
A pattern specifying how u_fscanf
will interpret the variable arguments received and parse the data. ap
The argument list to use.
U_CAPI int32_t U_EXPORT2 u_fscanf_u (UFILE * f, const UChar * patternSpecification, ...) |
Read formatted data from a UFILE.
f | The UFILE from which to read. |
patternSpecification |
A pattern specifying how u_fscanf will interpret the variable arguments received and parse the data. |
U_CAPI int32_t U_EXPORT2 u_vfscanf_u (UFILE * f, const UChar * patternSpecification, va_list ap) |
Read formatted data from a UFILE.
This is identical to u_fscanf_u
, except that it will not call va_start/TT> and
va_end
.
f
The UFILE from which to read. patternSpecification
A pattern specifying how u_fscanf
will interpret the variable arguments received and parse the data. ap
The argument list to use.
U_CAPI UChar *U_EXPORT2 u_fgets (UFILE * f, int32_t n, UChar * s) |
Read a UChar* from a UFILE.
f | The UFILE from which to read. |
n | The maximum number of characters - 1 to read. |
s |
The UChar* to receive the read data. Characters will be stored successively in s until a newline or EOF is reached. A NULL character (U+0000) will be appended to s . |
s
, or 0 if no characters were available. U_CAPI UChar U_EXPORT2 u_fgetc (UFILE * f) |
Read a UChar from a UFILE.
f | The UFILE from which to read. |
U_CAPI UChar U_EXPORT2 u_fungetc (UChar c, UFILE * f) |
Unget a UChar from a UFILE.
If this function is not the first to operate on f
after a call to u_fgetc
, the results are undefined.
c | The UChar to put back on the stream. |
f |
The UFILE to receive c . |
U_CAPI int32_t U_EXPORT2 u_file_read (UChar * chars, int32_t count, UFILE * f) |
Read Unicode from a UFILE.
Bytes will be converted from the UFILE's underlying codepage, with subsequent conversion to Unicode.
chars | A pointer to receive the Unicode data. |
count | The number of Unicode characters to read. |
f | The UFILE from which to read. |