OLD | NEW |
1 /* | 1 /* |
2 ****************************************************************************** | 2 ****************************************************************************** |
3 * | 3 * |
4 * Copyright (C) 1997-2011, International Business Machines | 4 * Copyright (C) 1997-2014, International Business Machines |
5 * Corporation and others. All Rights Reserved. | 5 * Corporation and others. All Rights Reserved. |
6 * | 6 * |
7 ****************************************************************************** | 7 ****************************************************************************** |
8 * | 8 * |
9 * FILE NAME : putil.h | 9 * FILE NAME : putil.h |
10 * | 10 * |
11 * Date Name Description | 11 * Date Name Description |
12 * 05/14/98 nos Creation (content moved here from utypes.h). | 12 * 05/14/98 nos Creation (content moved here from utypes.h). |
13 * 06/17/99 erm Added IEEE_754 | 13 * 06/17/99 erm Added IEEE_754 |
14 * 07/22/98 stephen Added IEEEremainder, max, min, trunc | 14 * 07/22/98 stephen Added IEEEremainder, max, min, trunc |
(...skipping 44 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
59 * </code> use that, | 59 * </code> use that, |
60 * otherwise no data directory is available. | 60 * otherwise no data directory is available. |
61 * | 61 * |
62 * @return the data directory, or an empty string ("") if no data directory has | 62 * @return the data directory, or an empty string ("") if no data directory has |
63 * been specified. | 63 * been specified. |
64 * | 64 * |
65 * @stable ICU 2.0 | 65 * @stable ICU 2.0 |
66 */ | 66 */ |
67 U_STABLE const char* U_EXPORT2 u_getDataDirectory(void); | 67 U_STABLE const char* U_EXPORT2 u_getDataDirectory(void); |
68 | 68 |
| 69 |
69 /** | 70 /** |
70 * Set the ICU data directory. | 71 * Set the ICU data directory. |
71 * The data directory is where common format ICU data files (.dat files) | 72 * The data directory is where common format ICU data files (.dat files) |
72 * are loaded from. Note that normal use of the built-in ICU | 73 * are loaded from. Note that normal use of the built-in ICU |
73 * facilities does not require loading of an external data file; | 74 * facilities does not require loading of an external data file; |
74 * unless you are adding custom data to ICU, the data directory | 75 * unless you are adding custom data to ICU, the data directory |
75 * does not need to be set. | 76 * does not need to be set. |
76 * | 77 * |
77 * This function should be called at most once in a process, before the | 78 * This function should be called at most once in a process, before the |
78 * first ICU operation (e.g., u_init()) that will require the loading of an | 79 * first ICU operation (e.g., u_init()) that will require the loading of an |
79 * ICU data file. | 80 * ICU data file. |
80 * This function is not thread-safe. Use it before calling ICU APIs from | 81 * This function is not thread-safe. Use it before calling ICU APIs from |
81 * multiple threads. | 82 * multiple threads. |
82 * | 83 * |
83 * @param directory The directory to be set. | 84 * @param directory The directory to be set. |
84 * | 85 * |
85 * @see u_init | 86 * @see u_init |
86 * @stable ICU 2.0 | 87 * @stable ICU 2.0 |
87 */ | 88 */ |
88 U_STABLE void U_EXPORT2 u_setDataDirectory(const char *directory); | 89 U_STABLE void U_EXPORT2 u_setDataDirectory(const char *directory); |
89 | 90 |
| 91 #ifndef U_HIDE_INTERNAL_API |
| 92 /** |
| 93 * Return the time zone files override directory, or an empty string if |
| 94 * no directory was specified. Certain time zone resources will be preferrentia
lly |
| 95 * loaded from individual files in this directory. |
| 96 * |
| 97 * @return the time zone data override directory. |
| 98 * @internal |
| 99 */ |
| 100 U_INTERNAL const char * U_EXPORT2 u_getTimeZoneFilesDirectory(UErrorCode *status
); |
| 101 |
| 102 /** |
| 103 * Set the time zone files override directory. |
| 104 * This function is not thread safe; it must not be called concurrently with |
| 105 * u_getTimeZoneFilesDirectory() or any other use of ICU time zone functions. |
| 106 * This function should only be called before using any ICU service that |
| 107 * will access the time zone data. |
| 108 * @internal |
| 109 */ |
| 110 U_INTERNAL void U_EXPORT2 u_setTimeZoneFilesDirectory(const char *path, UErrorCo
de *status); |
| 111 #endif /* U_HIDE_INTERNAL_API */ |
| 112 |
| 113 |
90 /** | 114 /** |
91 * @{ | 115 * @{ |
92 * Filesystem file and path separator characters. | 116 * Filesystem file and path separator characters. |
93 * Example: '/' and ':' on Unix, '\\' and ';' on Windows. | 117 * Example: '/' and ':' on Unix, '\\' and ';' on Windows. |
94 * @stable ICU 2.0 | 118 * @stable ICU 2.0 |
95 */ | 119 */ |
96 #if U_PLATFORM == U_PF_CLASSIC_MACOS | 120 #if U_PLATFORM_USES_ONLY_WIN32_API |
97 # define U_FILE_SEP_CHAR ':' | |
98 # define U_FILE_ALT_SEP_CHAR ':' | |
99 # define U_PATH_SEP_CHAR ';' | |
100 # define U_FILE_SEP_STRING ":" | |
101 # define U_FILE_ALT_SEP_STRING ":" | |
102 # define U_PATH_SEP_STRING ";" | |
103 #elif U_PLATFORM_USES_ONLY_WIN32_API | |
104 # define U_FILE_SEP_CHAR '\\' | 121 # define U_FILE_SEP_CHAR '\\' |
105 # define U_FILE_ALT_SEP_CHAR '/' | 122 # define U_FILE_ALT_SEP_CHAR '/' |
106 # define U_PATH_SEP_CHAR ';' | 123 # define U_PATH_SEP_CHAR ';' |
107 # define U_FILE_SEP_STRING "\\" | 124 # define U_FILE_SEP_STRING "\\" |
108 # define U_FILE_ALT_SEP_STRING "/" | 125 # define U_FILE_ALT_SEP_STRING "/" |
109 # define U_PATH_SEP_STRING ";" | 126 # define U_PATH_SEP_STRING ";" |
110 #else | 127 #else |
111 # define U_FILE_SEP_CHAR '/' | 128 # define U_FILE_SEP_CHAR '/' |
112 # define U_FILE_ALT_SEP_CHAR '/' | 129 # define U_FILE_ALT_SEP_CHAR '/' |
113 # define U_PATH_SEP_CHAR ':' | 130 # define U_PATH_SEP_CHAR ':' |
(...skipping 41 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
155 * @param length The number of characters to convert; this may | 172 * @param length The number of characters to convert; this may |
156 * include the terminating <code>NUL</code>. | 173 * include the terminating <code>NUL</code>. |
157 * | 174 * |
158 * @see U_CHARSET_FAMILY | 175 * @see U_CHARSET_FAMILY |
159 * @stable ICU 2.0 | 176 * @stable ICU 2.0 |
160 */ | 177 */ |
161 U_STABLE void U_EXPORT2 | 178 U_STABLE void U_EXPORT2 |
162 u_UCharsToChars(const UChar *us, char *cs, int32_t length); | 179 u_UCharsToChars(const UChar *us, char *cs, int32_t length); |
163 | 180 |
164 #endif | 181 #endif |
OLD | NEW |