ICU 50.1.2
50.1.2
|
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. More... | |
#define | U_FILE_ALT_SEP_CHAR ':' |
Filesystem file and path separator characters. More... | |
#define | U_PATH_SEP_CHAR ';' |
Filesystem file and path separator characters. More... | |
#define | U_FILE_SEP_STRING ":" |
Filesystem file and path separator characters. More... | |
#define | U_FILE_ALT_SEP_STRING ":" |
Filesystem file and path separator characters. More... | |
#define | U_PATH_SEP_STRING ";" |
Filesystem file and path separator characters. More... | |
Functions | |
const char * | u_getDataDirectory (void) |
Platform utilities isolates the platform dependencies of the libarary. More... | |
void | u_setDataDirectory (const char *directory) |
Set the ICU data directory. More... | |
void | u_charsToUChars (const char *cs, UChar *us, int32_t length) |
Convert char characters to UChar characters. More... | |
void | u_UCharsToChars (const UChar *us, char *cs, int32_t length) |
Convert UChar characters to char characters. More... | |
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.
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_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 . |