|
ICU 55.1
55.1
|
C API: Platform Utilities. More...
#include "unicode/utypes.h"Go to the source code of this file.
Macros | |
| #define | U_FILE_SEP_CHAR '/' |
| Filesystem file and path separator characters. | |
| #define | U_FILE_ALT_SEP_CHAR '/' |
| Filesystem file and path separator characters. | |
| #define | U_PATH_SEP_CHAR ':' |
| Filesystem file and path separator characters. | |
| #define | U_FILE_SEP_STRING "/" |
| Filesystem file and path separator characters. | |
| #define | U_FILE_ALT_SEP_STRING "/" |
| Filesystem file and path separator characters. | |
| #define | U_PATH_SEP_STRING ":" |
| Filesystem file and path separator characters. | |
Functions | |
| const char * | u_getDataDirectory (void) |
| Platform utilities isolates the platform dependencies of the libarary. | |
| void | u_setDataDirectory (const char *directory) |
| Set the ICU data directory. | |
| const char * | u_getTimeZoneFilesDirectory (UErrorCode *status) |
| Return the time zone files override directory, or an empty string if no directory was specified. | |
| void | u_setTimeZoneFilesDirectory (const char *path, UErrorCode *status) |
| Set the time zone files override directory. | |
| void | u_charsToUChars (const char *cs, UChar *us, int32_t length) |
| Convert char characters to UChar characters. | |
| void | u_UCharsToChars (const UChar *us, char *cs, int32_t length) |
| Convert UChar characters to char characters. | |
C API: Platform Utilities.
Definition in file putil.h.
| #define U_FILE_ALT_SEP_CHAR '/' |
| #define U_FILE_ALT_SEP_STRING "/" |
| #define U_FILE_SEP_CHAR '/' |
| #define U_FILE_SEP_STRING "/" |
| #define U_PATH_SEP_CHAR ':' |
| #define U_PATH_SEP_STRING ":" |
| void u_charsToUChars | ( | const char * | cs, |
| UChar * | us, | ||
| int32_t | length | ||
| ) |
Convert char characters to UChar characters.
This utility function is useful only for "invariant characters" that are encoded in the platform default encoding. They are a small, constant subset of the encoding and include just the latin letters, digits, and some punctuation. For details, see U_CHARSET_FAMILY.
| cs | Input string, points to length character bytes from a subset of the platform encoding. |
| us | Output string, points to memory for length Unicode characters. |
| length | The number of characters to convert; this may include the terminating NUL. |
| const char* u_getDataDirectory | ( | void | ) |
Platform utilities isolates the platform dependencies of the libarary.
For each platform which this code is ported to, these functions may have to be re-implemented. Return the ICU data directory. The data directory is where common format ICU data files (.dat files) are loaded from. Note that normal use of the built-in ICU facilities does not require loading of an external data file; unless you are adding custom data to ICU, the data directory does not need to be set.
The data directory is determined as follows: If u_setDataDirectory() has been called, that is it, otherwise if the ICU_DATA environment variable is set, use that, otherwise If a data directory was specifed at ICU build time
use that, otherwise no data directory is available.
| const char* u_getTimeZoneFilesDirectory | ( | UErrorCode * | status | ) |
Return the time zone files override directory, or an empty string if no directory was specified.
Certain time zone resources will be preferrentially loaded from individual files in this directory.
| void u_setDataDirectory | ( | const char * | directory | ) |
Set the ICU data directory.
The data directory is where common format ICU data files (.dat files) are loaded from. Note that normal use of the built-in ICU facilities does not require loading of an external data file; unless you are adding custom data to ICU, the data directory does not need to be set.
This function should be called at most once in a process, before the first ICU operation (e.g., u_init()) that will require the loading of an ICU data file. This function is not thread-safe. Use it before calling ICU APIs from multiple threads.
| directory | The directory to be set. |
| void u_setTimeZoneFilesDirectory | ( | const char * | path, |
| UErrorCode * | status | ||
| ) |
Set the time zone files override directory.
This function is not thread safe; it must not be called concurrently with u_getTimeZoneFilesDirectory() or any other use of ICU time zone functions. This function should only be called before using any ICU service that will access the time zone data.
| void u_UCharsToChars | ( | const UChar * | us, |
| char * | cs, | ||
| int32_t | length | ||
| ) |
Convert UChar characters to char characters.
This utility function is useful only for "invariant characters" that can be encoded in the platform default encoding. They are a small, constant subset of the encoding and include just the latin letters, digits, and some punctuation. For details, see U_CHARSET_FAMILY.
| us | Input string, points to length Unicode characters that can be encoded with the codepage-invariant subset of the platform encoding. |
| cs | Output string, points to memory for length character bytes. |
| length | The number of characters to convert; this may include the terminating NUL. |
1.8.1.2