Go to the documentation of this file.
43 #if !U_NO_DEFAULT_INCLUDE_UTF_HEADERS
63 # ifndef U_SHOW_CPLUSPLUS_API
64 # define U_SHOW_CPLUSPLUS_API 1
67 # undef U_SHOW_CPLUSPLUS_API
68 # define U_SHOW_CPLUSPLUS_API 0
83 #if !U_DEFAULT_SHOW_DRAFT && !defined(U_SHOW_DRAFT_API)
84 #define U_HIDE_DRAFT_API 1
86 #if !U_DEFAULT_SHOW_DRAFT && !defined(U_SHOW_INTERNAL_API)
87 #define U_HIDE_INTERNAL_API 1
115 # define U_ICUDATA_TYPE_LETTER "e"
116 # define U_ICUDATA_TYPE_LITLETTER e
118 # error "Don't know what to do with little endian EBCDIC!"
119 # define U_ICUDATA_TYPE_LETTER "x"
120 # define U_ICUDATA_TYPE_LITLETTER x
125 # define U_ICUDATA_TYPE_LETTER "b"
126 # define U_ICUDATA_TYPE_LITLETTER b
129 # define U_ICUDATA_TYPE_LETTER "l"
130 # define U_ICUDATA_TYPE_LITLETTER l
139 #define U_ICUDATA_NAME "icudt" U_ICU_VERSION_SHORT U_ICUDATA_TYPE_LETTER
140 #ifndef U_HIDE_INTERNAL_API
141 #define U_USRDATA_NAME "usrdt" U_ICU_VERSION_SHORT U_ICUDATA_TYPE_LETTER
142 #define U_USE_USRDATA 0
156 #define U_ICUDATA_ENTRY_POINT U_DEF2_ICUDATA_ENTRY_POINT(U_ICU_VERSION_MAJOR_NUM,U_LIB_SUFFIX_C_NAME)
158 #ifndef U_HIDE_INTERNAL_API
163 #define U_DEF2_ICUDATA_ENTRY_POINT(major,suff) U_DEF_ICUDATA_ENTRY_POINT(major,suff)
169 #ifndef U_DEF_ICUDATA_ENTRY_POINT
171 #ifndef U_LIB_SUFFIX_C_NAME
172 #define U_DEF_ICUDATA_ENTRY_POINT(major, suff) icudt##major##_dat
174 #define U_DEF_ICUDATA_ENTRY_POINT(major, suff) icudt##suff ## major##_dat
188 #define NULL ((void *)0)
206 #define U_MILLIS_PER_SECOND (1000)
208 #define U_MILLIS_PER_MINUTE (60000)
210 #define U_MILLIS_PER_HOUR (3600000)
212 #define U_MILLIS_PER_DAY (86400000)
218 #define U_DATE_MAX DBL_MAX
224 #define U_DATE_MIN -U_DATE_MAX
293 #if defined(U_COMBINED_IMPLEMENTATION)
294 #define U_DATA_API U_EXPORT
295 #define U_COMMON_API U_EXPORT
296 #define U_I18N_API U_EXPORT
297 #define U_LAYOUT_API U_EXPORT
298 #define U_LAYOUTEX_API U_EXPORT
299 #define U_IO_API U_EXPORT
300 #define U_TOOLUTIL_API U_EXPORT
301 #elif defined(U_STATIC_IMPLEMENTATION)
306 #define U_LAYOUTEX_API
308 #define U_TOOLUTIL_API
309 #elif defined(U_COMMON_IMPLEMENTATION)
310 #define U_DATA_API U_IMPORT
311 #define U_COMMON_API U_EXPORT
312 #define U_I18N_API U_IMPORT
313 #define U_LAYOUT_API U_IMPORT
314 #define U_LAYOUTEX_API U_IMPORT
315 #define U_IO_API U_IMPORT
316 #define U_TOOLUTIL_API U_IMPORT
317 #elif defined(U_I18N_IMPLEMENTATION)
318 #define U_DATA_API U_IMPORT
319 #define U_COMMON_API U_IMPORT
320 #define U_I18N_API U_EXPORT
321 #define U_LAYOUT_API U_IMPORT
322 #define U_LAYOUTEX_API U_IMPORT
323 #define U_IO_API U_IMPORT
324 #define U_TOOLUTIL_API U_IMPORT
325 #elif defined(U_LAYOUT_IMPLEMENTATION)
326 #define U_DATA_API U_IMPORT
327 #define U_COMMON_API U_IMPORT
328 #define U_I18N_API U_IMPORT
329 #define U_LAYOUT_API U_EXPORT
330 #define U_LAYOUTEX_API U_IMPORT
331 #define U_IO_API U_IMPORT
332 #define U_TOOLUTIL_API U_IMPORT
333 #elif defined(U_LAYOUTEX_IMPLEMENTATION)
334 #define U_DATA_API U_IMPORT
335 #define U_COMMON_API U_IMPORT
336 #define U_I18N_API U_IMPORT
337 #define U_LAYOUT_API U_IMPORT
338 #define U_LAYOUTEX_API U_EXPORT
339 #define U_IO_API U_IMPORT
340 #define U_TOOLUTIL_API U_IMPORT
341 #elif defined(U_IO_IMPLEMENTATION)
342 #define U_DATA_API U_IMPORT
343 #define U_COMMON_API U_IMPORT
344 #define U_I18N_API U_IMPORT
345 #define U_LAYOUT_API U_IMPORT
346 #define U_LAYOUTEX_API U_IMPORT
347 #define U_IO_API U_EXPORT
348 #define U_TOOLUTIL_API U_IMPORT
349 #elif defined(U_TOOLUTIL_IMPLEMENTATION)
350 #define U_DATA_API U_IMPORT
351 #define U_COMMON_API U_IMPORT
352 #define U_I18N_API U_IMPORT
353 #define U_LAYOUT_API U_IMPORT
354 #define U_LAYOUTEX_API U_IMPORT
355 #define U_IO_API U_IMPORT
356 #define U_TOOLUTIL_API U_EXPORT
358 #define U_DATA_API U_IMPORT
359 #define U_COMMON_API U_IMPORT
360 #define U_I18N_API U_IMPORT
361 #define U_LAYOUT_API U_IMPORT
362 #define U_LAYOUTEX_API U_IMPORT
363 #define U_IO_API U_IMPORT
364 #define U_TOOLUTIL_API U_IMPORT
373 #define U_STANDARD_CPP_NAMESPACE ::
375 #define U_STANDARD_CPP_NAMESPACE
422 #ifndef U_HIDE_DEPRECATED_API
428 #endif // U_HIDE_DEPRECATED_API
464 #ifndef U_HIDE_DEPRECATED_API
470 #endif // U_HIDE_DEPRECATED_API
511 #ifndef U_HIDE_DEPRECATED_API
517 #endif // U_HIDE_DEPRECATED_API
542 #ifndef U_HIDE_DRAFT_API
543 U_NUMBER_ARG_OUTOFBOUNDS_ERROR,
544 #endif // U_HIDE_DRAFT_API
545 #ifndef U_HIDE_DRAFT_API
546 U_NUMBER_SKELETON_SYNTAX_ERROR,
547 #endif // U_HIDE_DRAFT_API
548 #ifndef U_HIDE_DEPRECATED_API
554 #endif // U_HIDE_DEPRECATED_API
574 #ifndef U_HIDE_DEPRECATED_API
580 #endif // U_HIDE_DEPRECATED_API
600 #ifndef U_HIDE_DEPRECATED_API
610 #ifndef U_HIDE_DEPRECATED_API
616 #endif // U_HIDE_DEPRECATED_API
621 U_IDNA_PROHIBITED_ERROR=0x10400,
622 U_IDNA_ERROR_START=0x10400,
623 U_IDNA_UNASSIGNED_ERROR,
624 U_IDNA_CHECK_BIDI_ERROR,
625 U_IDNA_STD3_ASCII_RULES_ERROR,
626 U_IDNA_ACE_PREFIX_ERROR,
627 U_IDNA_VERIFICATION_ERROR,
628 U_IDNA_LABEL_TOO_LONG_ERROR,
629 U_IDNA_ZERO_LENGTH_LABEL_ERROR,
630 U_IDNA_DOMAIN_NAME_TOO_LONG_ERROR,
631 #ifndef U_HIDE_DEPRECATED_API
637 #endif // U_HIDE_DEPRECATED_API
641 U_STRINGPREP_PROHIBITED_ERROR = U_IDNA_PROHIBITED_ERROR,
642 U_STRINGPREP_UNASSIGNED_ERROR = U_IDNA_UNASSIGNED_ERROR,
643 U_STRINGPREP_CHECK_BIDI_ERROR = U_IDNA_CHECK_BIDI_ERROR,
651 #ifndef U_HIDE_DEPRECATED_API
657 #endif // U_HIDE_DEPRECATED_API
659 #ifndef U_HIDE_DEPRECATED_API
665 #endif // U_HIDE_DEPRECATED_API
689 # define U_SUCCESS(x) ((x)<=U_ZERO_ERROR)
694 # define U_FAILURE(x) ((x)>U_ZERO_ERROR)
@ U_PLUGIN_DIDNT_SET_LEVEL
The plugin didn't call uplug_setPlugLevel in response to a QUERY.
@ U_MALFORMED_SYMBOL_REFERENCE
UNUSED as of ICU 2.4.
@ U_REGEX_INVALID_CAPTURE_GROUP_NAME
Invalid capture group name.
@ U_BRK_HEX_DIGITS_EXPECTED
Hex digits expected as part of a escaped char in a rule.
@ U_UNDEFINED_KEYWORD
Undefined Plural keyword.
@ U_INVALID_ID
A "::id" rule specifies an unknown transliterator.
@ U_ILLEGAL_PAD_POSITION
Pad symbol misplaced in number pattern.
@ U_PARSE_ERROR_START
Start of Transliterator errors.
@ U_INDEX_OUTOFBOUNDS_ERROR
Trying to access the index that is out of bounds.
@ U_UNCLOSED_SEGMENT
A closing ')' is missing.
@ U_BRK_MALFORMED_RULE_TAG
The {nnn} tag on a rule is malformed
@ U_BRK_ERROR_LIMIT
One more than the highest normal BreakIterator error code.
@ U_INVALID_FORMAT_ERROR
Data format is not what is expected.
@ U_STRING_NOT_TERMINATED_WARNING
An output string could not be NUL-terminated because output length==destCapacity.
@ U_DECIMAL_NUMBER_SYNTAX_ERROR
Decimal number syntax error.
@ U_BRK_ERROR_START
Start of codes indicating Break Iterator failures.
@ U_INVALID_PROPERTY_PATTERN
UNUSED as of ICU 2.4.
@ U_ERROR_LIMIT
One more than the highest normal error code.
@ U_USING_FALLBACK_WARNING
A resource bundle lookup returned a fallback result (not an error)
@ U_REGEX_INVALID_RANGE
In a character range [x-y], x is greater than y.
int8_t UBool
The ICU boolean type.
@ U_MALFORMED_VARIABLE_DEFINITION
A variable definition is invalid.
@ U_COLLATOR_VERSION_MISMATCH
Collator version is not compatible with the base version.
@ U_MULTIPLE_ANTE_CONTEXTS
More than one ante context.
@ U_REGEX_TIME_OUT
Maximum allowed match time exceeded
@ U_UNSUPPORTED_ESCAPE_SEQUENCE
ISO-2022 unsupported escape sequence.
@ U_BRK_SEMICOLON_EXPECTED
Missing ';' at the end of a RBBI rule.
@ U_ENUM_OUT_OF_SYNC_ERROR
UEnumeration out of sync with underlying collection.
@ U_FORMAT_INEXACT_ERROR
Cannot format a number exactly and rounding mode is ROUND_UNNECESSARY.
@ U_INTERNAL_PROGRAM_ERROR
Indicates a bug in the library code.
@ U_REGEX_PATTERN_TOO_BIG
Pattern exceeds limits on size or complexity.
@ U_BAD_VARIABLE_DEFINITION
Missing '$' or duplicate variable name.
@ U_BRK_NEW_LINE_IN_QUOTED_STRING
Missing closing quote in an RBBI rule.
@ U_MULTIPLE_DECIMAL_SEPERATORS
Typo: kept for backward compatibility.
@ U_STANDARD_ERROR_LIMIT
One more than the highest standard error code.
@ U_UNMATCHED_BRACES
Braces do not match in message pattern.
@ U_REGEX_ERROR_START
Start of codes indicating Regexp failures
@ U_UNTERMINATED_QUOTE
A closing single quote is missing.
C API: Code point macros.
@ U_MISSING_SEGMENT_CLOSE
UNUSED as of ICU 2.4.
C API: API for accessing ICU version numbers.
@ U_ERROR_WARNING_START
Start of information results (semantically successful)
@ U_SORT_KEY_TOO_SHORT_WARNING
Number of levels requested in getBound is higher than the number of levels in the sort key.
@ U_DUPLICATE_KEYWORD
Duplicate keyword in PluralFormat.
@ U_INTERNAL_TRANSLITERATOR_ERROR
Internal transliterator system error.
@ U_ILLEGAL_ESCAPE_SEQUENCE
ISO-2022 illegal escape sequence.
@ U_REGEX_INVALID_FLAG
Invalid value for match mode flags.
@ U_MISPLACED_CURSOR_OFFSET
A cursor offset occurs at an illegal position.
@ U_MEMORY_ALLOCATION_ERROR
Memory allocation error.
@ U_ILLEGAL_CHAR_IN_SEGMENT
UNUSED as of ICU 2.4.
@ U_REGEX_ERROR_LIMIT
One more than the highest normal regular expression error code.
@ U_REGEX_RULE_SYNTAX
Syntax error in regexp pattern.
@ U_SAFECLONE_ALLOCATED_WARNING
A SafeClone operation required allocating memory (informational only)
@ U_FMT_PARSE_ERROR_START
Start of format library errors.
@ U_MALFORMED_EXPONENTIAL_PATTERN
Grouping symbol in exponent pattern.
@ U_MULTIPLE_POST_CONTEXTS
More than one post context.
@ U_CE_NOT_FOUND_ERROR
Currently used only while setting variable top, but can be used generally.
@ U_MALFORMED_SET
A UnicodeSet pattern is invalid.
@ U_STATE_TOO_OLD_ERROR
ICU cannot construct a service from this state, as it is no longer supported.
@ U_DIFFERENT_UCA_VERSION
ucol_open encountered a mismatch between UCA version and collator image version, so the collator was ...
@ U_BRK_INIT_ERROR
Initialization failure.
@ U_REGEX_BAD_ESCAPE_SEQUENCE
Unrecognized backslash escape sequence in pattern
#define U_FAILURE(x)
Does the error code indicate a failure?
@ U_MISSING_RESOURCE_ERROR
The requested resource cannot be found.
@ U_MISMATCHED_SEGMENT_DELIMITERS
UNUSED as of ICU 2.4.
@ U_NO_WRITE_PERMISSION
Attempt to modify read-only or constant data.
@ U_PARSE_ERROR_LIMIT
One more than the highest normal Transliterator error code.
@ U_PLUGIN_ERROR_LIMIT
One more than the highest normal plug-in error code.
UErrorCode
Error code to replace exception handling, so that the code is compatible with all C++ compilers,...
@ U_INVALID_FUNCTION
A "&fn()" rule specifies an unknown transliterator.
@ U_STATE_OLD_WARNING
ICU has to use compatibility layer to construct the service.
@ U_UNEXPECTED_TOKEN
Syntax error in format pattern.
@ U_NO_SPACE_AVAILABLE
No space available for in-buffer expansion for Arabic shaping.
@ U_MISPLACED_COMPOUND_FILTER
A compound filter is in an invalid location.
@ U_DEFAULT_KEYWORD_MISSING
Missing DEFAULT rule in plural rules.
@ U_MALFORMED_VARIABLE_REFERENCE
A variable reference is invalid.
@ U_MISPLACED_ANCHOR_START
A start anchor appears at an illegal position.
@ U_BUFFER_OVERFLOW_ERROR
A result would not fit in the supplied buffer.
@ U_BRK_RULE_EMPTY_SET
Rule contains an empty Unicode Set.
@ U_USELESS_COLLATOR_ERROR
Collator is options only and no base is specified.
@ U_PLUGIN_CHANGED_LEVEL_WARNING
A plugin caused a level change.
@ U_FILE_ACCESS_ERROR
The requested file cannot be found.
@ U_BRK_MISMATCHED_PAREN
Mis-matched parentheses in an RBBI rule.
@ U_REGEX_STACK_OVERFLOW
Regular expression backtrack stack overflow.
Basic types and constants for UTF.
@ U_INVALID_CHAR_FOUND
Character conversion: Unmappable input sequence.
@ U_ZERO_ERROR
No error, no warning.
@ U_BRK_ASSIGN_ERROR
Syntax error in RBBI rule assignment statement.
@ U_VARIABLE_RANGE_EXHAUSTED
Too many stand-ins generated for the given variable range.
@ U_RULE_MASK_ERROR
A rule is hidden by an earlier more general rule.
@ U_BRK_INTERNAL_ERROR
An internal error (bug) was detected.
@ U_MULTIPLE_PERMILL_SYMBOLS
More than one permill symbol in number pattern.
@ U_REGEX_OCTAL_TOO_BIG
Octal character constants must be <= 0377.
@ U_REGEX_MISSING_CLOSE_BRACKET
Missing closing bracket on a bracket expression.
@ U_UNQUOTED_SPECIAL
A special character was not quoted or escaped.
@ U_AMBIGUOUS_ALIAS_WARNING
This converter alias can go to different converter implementations.
@ U_REGEX_MISMATCHED_PAREN
Incorrectly nested parentheses in regexp pattern.
@ U_ILLEGAL_CHAR_FOUND
Character conversion: Illegal input sequence/combination of input units.
@ U_ERROR_WARNING_LIMIT
One more than the highest normal UErrorCode warning value.
@ U_BRK_VARIABLE_REDFINITION
RBBI rule $Variable redefined.
@ U_REGEX_MAX_LT_MIN
In {min,max}, max is less than min.
@ U_ARGUMENT_TYPE_MISMATCH
Argument name and argument index mismatch in MessageFormat functions.
#define U_SUCCESS(x)
Does the error code indicate success?
const char * u_errorName(UErrorCode code)
Return a string for a UErrorCode value.
@ U_BRK_UNRECOGNIZED_OPTION
!!option in RBBI rules not recognized.
@ U_MULTIPLE_CURSORS
More than one cursor.
@ U_MALFORMED_UNICODE_ESCAPE
A Unicode escape pattern is invalid.
@ U_FMT_PARSE_ERROR_LIMIT
One more than the highest normal formatting API error code.
@ U_UNDEFINED_VARIABLE
A variable reference does not correspond to a defined variable.
@ U_MISSING_OPERATOR
A rule contains no operator.
@ U_IDNA_ERROR_LIMIT
One more than the highest normal IDNA error code.
@ U_INVALID_TABLE_FILE
Conversion table file not found.
@ U_REGEX_BAD_INTERVAL
Error in {min,max} interval
@ U_MALFORMED_PRAGMA
A 'use' pragma is invalid.
@ U_REGEX_SET_CONTAINS_STRING
Regexps cannot have UnicodeSets containing strings.
@ U_INVARIANT_CONVERSION_ERROR
Unable to convert a UChar* string to char* with the invariant converter.
@ U_ILLEGAL_ARGUMENT_ERROR
Start of codes indicating failure.
double UDate
Date and Time data type.
@ U_MULTIPLE_DECIMAL_SEPARATORS
More than one decimal separator in number pattern.
@ U_TOO_MANY_ALIASES_ERROR
There are too many aliases in the path to the requested resource.
@ U_REGEX_PROPERTY_SYNTAX
Incorrect Unicode property
@ U_PRIMARY_TOO_LONG_ERROR
User tried to set variable top to a primary that is longer than two bytes.
@ U_MULTIPLE_PAD_SPECIFIERS
More than one pad symbol in number pattern.
@ U_MESSAGE_PARSE_ERROR
Unable to parse a message (message format)
@ U_PLUGIN_TOO_HIGH
The plugin's level is too high to be loaded right now.
@ U_MULTIPLE_COMPOUND_FILTERS
More than one compound filter.
@ U_MULTIPLE_EXPONENTIAL_SYMBOLS
More than one exponent symbol in number pattern.
#define U_STABLE
This is used to declare a function as a stable public ICU C API.
@ U_MALFORMED_RULE
Elements of a rule are misplaced.
@ U_UNSUPPORTED_ERROR
Requested operation not supported in current context.
@ U_INVALID_TABLE_FORMAT
Conversion table file found, but corrupted.
@ U_VARIABLE_RANGE_OVERLAP
The variable range overlaps characters used in rules.
@ U_RESOURCE_TYPE_MISMATCH
an operation is requested over a resource that does not support it
@ U_MISPLACED_QUANTIFIER
A quantifier appears after a segment close delimiter.
User-configurable settings.
@ U_ILLEGAL_CHARACTER
A special character is outside its allowed context.
@ U_REGEX_UNIMPLEMENTED
Use of regexp feature that is not yet implemented.
@ U_TRUNCATED_CHAR_FOUND
Character conversion: Incomplete input sequence.
@ U_UNSUPPORTED_PROPERTY
UNUSED as of ICU 2.4.
@ U_UNSUPPORTED_ATTRIBUTE
UNUSED as of ICU 2.4.
@ U_BRK_RULE_SYNTAX
Syntax error in RBBI rule.
@ U_INVALID_STATE_ERROR
Requested operation can not be completed with ICU in its current state.
@ U_TRAILING_BACKSLASH
A dangling backslash.
@ U_REGEX_INVALID_BACK_REF
Back-reference to a non-existent capture group.
@ U_REGEX_INVALID_STATE
RegexMatcher in invalid state for requested operation.
@ U_INVALID_RBT_SYNTAX
A "::id" rule was passed to the RuleBasedTransliterator parser.
@ U_USING_DEFAULT_WARNING
A resource bundle lookup returned a result from the root locale (not an error)
@ U_PLUGIN_ERROR_START
Start of codes indicating plugin failures.
@ U_PARSE_ERROR
Equivalent to Java ParseException.
@ U_REGEX_LOOK_BEHIND_LIMIT
Look-Behind pattern matches must have a bounded maximum length.
@ U_REGEX_NUMBER_TOO_BIG
Decimal number is too large.
@ U_UNDEFINED_SEGMENT_REFERENCE
A segment reference does not correspond to a defined segment.
@ U_MULTIPLE_PERCENT_SYMBOLS
More than one percent symbol in number pattern.
@ U_BRK_UNDEFINED_VARIABLE
Use of an undefined $Variable in an RBBI rule.
@ U_REGEX_INTERNAL_ERROR
An internal error (bug) was detected.
@ U_BRK_UNCLOSED_SET
UnicodeSet writing an RBBI rule missing a closing ']'.
@ U_PATTERN_SYNTAX_ERROR
Syntax error in format pattern.
@ U_REGEX_STOPPED_BY_CALLER
Matching operation aborted by user callback fn.