scuffed-code/icu4c/source/common/unicode/uchar.h
2002-07-08 16:40:57 +00:00

2303 lines
76 KiB
C

/*
**********************************************************************
* Copyright (C) 1997-2001, International Business Machines
* Corporation and others. All Rights Reserved.
**********************************************************************
*
* File UCHAR.H
*
* Modification History:
*
* Date Name Description
* 04/02/97 aliu Creation.
* 03/29/99 helena Updated for C APIs.
* 4/15/99 Madhu Updated for C Implementation and Javadoc
* 5/20/99 Madhu Added the function u_getVersion()
* 8/19/1999 srl Upgraded scripts to Unicode 3.0
* 8/27/1999 schererm UCharDirection constants: U_...
* 11/11/1999 weiv added u_isalnum(), cleaned comments
* 01/11/2000 helena Renamed u_getVersion to u_getUnicodeVersion().
******************************************************************************
*/
#ifndef UCHAR_H
#define UCHAR_H
#include "unicode/utypes.h"
U_CDECL_BEGIN
/*==========================================================================*/
/* Unicode version number */
/*==========================================================================*/
/**
* Unicode version number, default for the current ICU version.
* The actual Unicode Character Database (UCD) data is stored in uprops.dat
* and may be generated from UCD files from a different Unicode version.
* Call u_getUnicodeVersion to get the actual Unicode version of the data.
*
* @see u_getUnicodeVersion
* @stable
*/
#define U_UNICODE_VERSION "3.2"
/**
* \file
* \brief C API: Unicode Char
*
* <h2> Unicode C API </h2>
* The Unicode C API allows you to query the properties associated with individual
* Unicode character values.
* <p>
* The Unicode character information, provided implicitly by the
* Unicode character encoding standard, includes information about the script
* (for example, symbols or control characters) to which the character belongs,
* as well as semantic information such as whether a character is a digit or
* uppercase, lowercase, or uncased.
* <P>
*/
/**
* Constants.
*/
/** The lowest Unicode code point value. Code points are non-negative. @stable */
#define UCHAR_MIN_VALUE 0
/**
* The highest Unicode code point value (scalar value) according to
* The Unicode Standard. This is a 21-bit value (20.1 bits, rounded up).
* For a single character, UChar32 is a simple type that can hold any code point value.
* @stable
*/
#define UCHAR_MAX_VALUE 0x10ffff
/**
* Get a single-bit bit set (a flag) from a bit number 0..31.
* @draft ICU 2.1
*/
#define U_MASK(x) ((uint32_t)1<<(x))
/**
* Selection constants for Unicode properties.
* These constants are used in functions like u_hasBinaryProperty to select
* one of the Unicode properties.
*
* The properties APIs are intended to reflect Unicode properties as defined
* in the Unicode Character Database (UCD) and Unicode Technical Reports (UTR).
* For details about the properties see http://www.unicode.org/ .
* For names of Unicode properties see the UCD file PropertyAliases.txt.
*
* Important: If ICU is built with UCD files from Unicode versions below 3.2,
* then properties marked with "new in Unicode 3.2" are not or not fully available.
* Check u_getUnicodeVersion to be sure.
*
* @see u_hasBinaryProperty
* @see u_getIntPropertyValue
* @see u_getUnicodeVersion
* @draft ICU 2.1
*/
enum UProperty {
/** Binary property Alphabetic. Same as u_isUAlphabetic, different from u_isalpha.
Lu+Ll+Lt+Lm+Lo+Nl+Other_Alphabetic @draft ICU 2.1 */
UCHAR_ALPHABETIC,
/** First constant for binary Unicode properties. @draft ICU 2.1 */
UCHAR_BINARY_START=UCHAR_ALPHABETIC,
/** Binary property ASCII_Hex_Digit. 0-9 A-F a-f @draft ICU 2.1 */
UCHAR_ASCII_HEX_DIGIT,
/** Binary property Bidi_Control.
Format controls which have specific functions
in the Bidi Algorithm. @draft ICU 2.1 */
UCHAR_BIDI_CONTROL,
/** Binary property Bidi_Mirrored.
Characters that may change display in RTL text.
Same as u_isMirrored.
See Bidi Algorithm, UTR 9. @draft ICU 2.1 */
UCHAR_BIDI_MIRRORED,
/** Binary property Dash. Variations of dashes. @draft ICU 2.1 */
UCHAR_DASH,
/** Binary property Default_Ignorable_Code_Point (new in Unicode 3.2).
Ignorable in most processing.
<2060..206F, FFF0..FFFB, E0000..E0FFF>+Other_Default_Ignorable_Code_Point+(Cf+Cc+Cs-White_Space) @draft ICU 2.1 */
UCHAR_DEFAULT_IGNORABLE_CODE_POINT,
/** Binary property Deprecated (new in Unicode 3.2).
The usage of deprecated characters is strongly discouraged. @draft ICU 2.1 */
UCHAR_DEPRECATED,
/** Binary property Diacritic. Characters that linguistically modify
the meaning of another character to which they apply. @draft ICU 2.1 */
UCHAR_DIACRITIC,
/** Binary property Extender.
Extend the value or shape of a preceding alphabetic character,
e.g., length and iteration marks. @draft ICU 2.1 */
UCHAR_EXTENDER,
/** Binary property Full_Composition_Exclusion.
CompositionExclusions.txt+Singleton Decompositions+
Non-Starter Decompositions. @draft ICU 2.1 */
UCHAR_FULL_COMPOSITION_EXCLUSION,
/** Binary property Grapheme_Base (new in Unicode 3.2).
For programmatic determination of grapheme cluster boundaries.
[0..10FFFF]-Cc-Cf-Cs-Co-Cn-Zl-Zp-Grapheme_Link-Grapheme_Extend-CGJ @draft ICU 2.1 */
UCHAR_GRAPHEME_BASE,
/** Binary property Grapheme_Extend (new in Unicode 3.2).
For programmatic determination of grapheme cluster boundaries.
Me+Mn+Mc+Other_Grapheme_Extend-Grapheme_Link-CGJ @draft ICU 2.1 */
UCHAR_GRAPHEME_EXTEND,
/** Binary property Grapheme_Link (new in Unicode 3.2).
For programmatic determination of grapheme cluster boundaries. @draft ICU 2.1 */
UCHAR_GRAPHEME_LINK,
/** Binary property Hex_Digit.
Characters commonly used for hexadecimal numbers. @draft ICU 2.1 */
UCHAR_HEX_DIGIT,
/** Binary property Hyphen. Dashes used to mark connections
between pieces of words, plus the Katakana middle dot. @draft ICU 2.1 */
UCHAR_HYPHEN,
/** Binary property ID_Continue.
Characters that can continue an identifier.
ID_Start+Mn+Mc+Nd+Pc @draft ICU 2.1 */
UCHAR_ID_CONTINUE,
/** Binary property ID_Start.
Characters that can start an identifier.
Lu+Ll+Lt+Lm+Lo+Nl @draft ICU 2.1 */
UCHAR_ID_START,
/** Binary property Ideographic.
CJKV ideographs. @draft ICU 2.1 */
UCHAR_IDEOGRAPHIC,
/** Binary property IDS_Binary_Operator (new in Unicode 3.2).
For programmatic determination of
Ideographic Description Sequences. @draft ICU 2.1 */
UCHAR_IDS_BINARY_OPERATOR,
/** Binary property IDS_Trinary_Operator (new in Unicode 3.2).
For programmatic determination of
Ideographic Description Sequences. @draft ICU 2.1 */
UCHAR_IDS_TRINARY_OPERATOR,
/** Binary property Join_Control.
Format controls for cursive joining and ligation. @draft ICU 2.1 */
UCHAR_JOIN_CONTROL,
/** Binary property Logical_Order_Exception (new in Unicode 3.2).
Characters that do not use logical order and
require special handling in most processing. @draft ICU 2.1 */
UCHAR_LOGICAL_ORDER_EXCEPTION,
/** Binary property Lowercase. Same as u_isULowercase, different from u_islower.
Ll+Other_Lowercase @draft ICU 2.1 */
UCHAR_LOWERCASE,
/** Binary property Math. Sm+Other_Math @draft ICU 2.1 */
UCHAR_MATH,
/** Binary property Noncharacter_Code_Point.
Code points that are explicitly defined as illegal
for the encoding of characters. @draft ICU 2.1 */
UCHAR_NONCHARACTER_CODE_POINT,
/** Binary property Quotation_Mark. @draft ICU 2.1 */
UCHAR_QUOTATION_MARK,
/** Binary property Radical (new in Unicode 3.2).
For programmatic determination of
Ideographic Description Sequences. @draft ICU 2.1 */
UCHAR_RADICAL,
/** Binary property Soft_Dotted (new in Unicode 3.2).
Characters with a "soft dot", like i or j.
An accent placed on these characters causes
the dot to disappear. @draft ICU 2.1 */
UCHAR_SOFT_DOTTED,
/** Binary property Terminal_Punctuation.
Punctuation characters that generally mark
the end of textual units. @draft ICU 2.1 */
UCHAR_TERMINAL_PUNCTUATION,
/** Binary property Unified_Ideograph (new in Unicode 3.2).
For programmatic determination of
Ideographic Description Sequences. @draft ICU 2.1 */
UCHAR_UNIFIED_IDEOGRAPH,
/** Binary property Uppercase. Same as u_isUUppercase, different from u_isupper.
Lu+Other_Uppercase @draft ICU 2.1 */
UCHAR_UPPERCASE,
/** Binary property White_Space.
Same as u_isUWhiteSpace, different from u_isspace and u_isWhitespace.
Space characters+TAB+CR+LF-ZWSP-ZWNBSP @draft ICU 2.1 */
UCHAR_WHITE_SPACE,
/** Binary property XID_Continue.
ID_Continue modified to allow closure under
normalization forms NFKC and NFKD. @draft ICU 2.1 */
UCHAR_XID_CONTINUE,
/** Binary property XID_Start. ID_Start modified to allow
closure under normalization forms NFKC and NFKD. @draft ICU 2.1 */
UCHAR_XID_START,
/** One more than the last constant for binary Unicode properties. @draft ICU 2.1 */
UCHAR_BINARY_LIMIT,
/** Enumerated property Bidi_Class.
Same as u_charDirection, returns UCharDirection values. @draft ICU 2.2 */
UCHAR_BIDI_CLASS=0x1000,
/** First constant for enumerated/integer Unicode properties. @draft ICU 2.2 */
UCHAR_INT_START=UCHAR_BIDI_CLASS,
/** Enumerated property Block.
Same as ublock_getCode, returns UBlockCode values. @draft ICU 2.2 */
UCHAR_BLOCK,
/** Enumerated property Canonical_Combining_Class.
Same as u_getCombiningClass, returns 8-bit numeric values. @draft ICU 2.2 */
UCHAR_CANONICAL_COMBINING_CLASS,
/** Enumerated property Decomposition_Type.
Returns UDecompositionType values. @draft ICU 2.2 */
UCHAR_DECOMPOSITION_TYPE,
/** Enumerated property East_Asian_Width.
See http://www.unicode.org/reports/tr11/
Returns UEastAsianWidth values. @draft ICU 2.2 */
UCHAR_EAST_ASIAN_WIDTH,
/** Enumerated property General_Category.
Same as u_charType, returns UCharCategory values. @draft ICU 2.2 */
UCHAR_GENERAL_CATEGORY,
/** Enumerated property Joining_Group.
Returns UJoiningGroup values. @draft ICU 2.2 */
UCHAR_JOINING_GROUP,
/** Enumerated property Joining_Type.
Returns UJoiningType values. @draft ICU 2.2 */
UCHAR_JOINING_TYPE,
/** Enumerated property Line_Break.
Returns ULineBreak values. @draft ICU 2.2 */
UCHAR_LINE_BREAK,
/** Enumerated property Numeric_Type.
Returns UNumericType values. @draft ICU 2.2 */
UCHAR_NUMERIC_TYPE,
/** Enumerated property Script.
Same as uscript_getScript, returns UScriptCode values. @draft ICU 2.2 */
UCHAR_SCRIPT,
/** One more than the last constant for enumerated/integer Unicode properties. @draft ICU 2.2 */
UCHAR_INT_LIMIT
};
/** @draft ICU 2.1 */
typedef enum UProperty UProperty;
/**
* Data for enumerated Unicode general category types.
* See http://www.unicode.org/Public/UNIDATA/UnicodeData.html .
* @stable
*/
enum UCharCategory
{
/** Non-category for unassigned and non-character code points. @stable */
U_UNASSIGNED = 0,
/** Cn "Other, Not Assigned (no characters in [UnicodeData.txt] have this property)" (same as U_UNASSIGNED!) @draft ICU 2.0 */
U_GENERAL_OTHER_TYPES = 0,
/** Lu @stable */
U_UPPERCASE_LETTER = 1,
/** Ll @stable */
U_LOWERCASE_LETTER = 2,
/** Lt @stable */
U_TITLECASE_LETTER = 3,
/** Lm @stable */
U_MODIFIER_LETTER = 4,
/** Lo @stable */
U_OTHER_LETTER = 5,
/** Mn @stable */
U_NON_SPACING_MARK = 6,
/** Me @stable */
U_ENCLOSING_MARK = 7,
/** Mc @stable */
U_COMBINING_SPACING_MARK = 8,
/** Nd @stable */
U_DECIMAL_DIGIT_NUMBER = 9,
/** Nl @stable */
U_LETTER_NUMBER = 10,
/** No @stable */
U_OTHER_NUMBER = 11,
/** Zs @stable */
U_SPACE_SEPARATOR = 12,
/** Zl @stable */
U_LINE_SEPARATOR = 13,
/** Zp @stable */
U_PARAGRAPH_SEPARATOR = 14,
/** Cc @stable */
U_CONTROL_CHAR = 15,
/** Cf @stable */
U_FORMAT_CHAR = 16,
/** Co @stable */
U_PRIVATE_USE_CHAR = 17,
/** Cs @stable */
U_SURROGATE = 18,
/** Pd @stable */
U_DASH_PUNCTUATION = 19,
/** Ps @stable */
U_START_PUNCTUATION = 20,
/** Pe @stable */
U_END_PUNCTUATION = 21,
/** Pc @stable */
U_CONNECTOR_PUNCTUATION = 22,
/** Po @stable */
U_OTHER_PUNCTUATION = 23,
/** Sm @stable */
U_MATH_SYMBOL = 24,
/** Sc @stable */
U_CURRENCY_SYMBOL = 25,
/** Sk @stable */
U_MODIFIER_SYMBOL = 26,
/** So @stable */
U_OTHER_SYMBOL = 27,
/** Pi @stable */
U_INITIAL_PUNCTUATION = 28,
/** Pf @stable */
U_FINAL_PUNCTUATION = 29,
/** One higher than the last enum UCharCategory constant. @stable */
U_CHAR_CATEGORY_COUNT
};
typedef enum UCharCategory UCharCategory;
/**
* U_GC_XX_MASK constants are bit flags corresponding to Unicode
* general category values.
* For each category, the nth bit is set if the numeric value of the
* corresponding UCharCategory constant is n.
*
* There are also some U_GC_Y_MASK constants for groups of general categories
* like L& for all letter categories.
*
* @see u_charType
* @see U_GET_GC_MASK
* @see UCharCategory
* @draft ICU 2.1
*/
#define U_GC_CN_MASK U_MASK(U_GENERAL_OTHER_TYPES)
#define U_GC_LU_MASK U_MASK(U_UPPERCASE_LETTER)
#define U_GC_LL_MASK U_MASK(U_LOWERCASE_LETTER)
#define U_GC_LT_MASK U_MASK(U_TITLECASE_LETTER)
#define U_GC_LM_MASK U_MASK(U_MODIFIER_LETTER)
#define U_GC_LO_MASK U_MASK(U_OTHER_LETTER)
#define U_GC_MN_MASK U_MASK(U_NON_SPACING_MARK)
#define U_GC_ME_MASK U_MASK(U_ENCLOSING_MARK)
#define U_GC_MC_MASK U_MASK(U_COMBINING_SPACING_MARK)
#define U_GC_ND_MASK U_MASK(U_DECIMAL_DIGIT_NUMBER)
#define U_GC_NL_MASK U_MASK(U_LETTER_NUMBER)
#define U_GC_NO_MASK U_MASK(U_OTHER_NUMBER)
#define U_GC_ZS_MASK U_MASK(U_SPACE_SEPARATOR)
#define U_GC_ZL_MASK U_MASK(U_LINE_SEPARATOR)
#define U_GC_ZP_MASK U_MASK(U_PARAGRAPH_SEPARATOR)
#define U_GC_CC_MASK U_MASK(U_CONTROL_CHAR)
#define U_GC_CF_MASK U_MASK(U_FORMAT_CHAR)
#define U_GC_CO_MASK U_MASK(U_PRIVATE_USE_CHAR)
#define U_GC_CS_MASK U_MASK(U_SURROGATE)
#define U_GC_PD_MASK U_MASK(U_DASH_PUNCTUATION)
#define U_GC_PS_MASK U_MASK(U_START_PUNCTUATION)
#define U_GC_PE_MASK U_MASK(U_END_PUNCTUATION)
#define U_GC_PC_MASK U_MASK(U_CONNECTOR_PUNCTUATION)
#define U_GC_PO_MASK U_MASK(U_OTHER_PUNCTUATION)
#define U_GC_SM_MASK U_MASK(U_MATH_SYMBOL)
#define U_GC_SC_MASK U_MASK(U_CURRENCY_SYMBOL)
#define U_GC_SK_MASK U_MASK(U_MODIFIER_SYMBOL)
#define U_GC_SO_MASK U_MASK(U_OTHER_SYMBOL)
#define U_GC_PI_MASK U_MASK(U_INITIAL_PUNCTUATION)
#define U_GC_PF_MASK U_MASK(U_FINAL_PUNCTUATION)
#define U_GC_L_MASK \
(U_GC_LU_MASK|U_GC_LL_MASK|U_GC_LT_MASK|U_GC_LM_MASK|U_GC_LO_MASK)
#define U_GC_M_MASK (U_GC_MN_MASK|U_GC_ME_MASK|U_GC_MC_MASK)
#define U_GC_N_MASK (U_GC_ND_MASK|U_GC_NL_MASK|U_GC_NO_MASK)
#define U_GC_Z_MASK (U_GC_ZS_MASK|U_GC_ZL_MASK|U_GC_ZP_MASK)
#define U_GC_C_MASK \
(U_GC_CN_MASK|U_GC_CC_MASK|U_GC_CF_MASK|U_GC_CO_MASK|U_GC_CS_MASK)
#define U_GC_P_MASK \
(U_GC_PD_MASK|U_GC_PS_MASK|U_GC_PE_MASK|U_GC_PC_MASK|U_GC_PO_MASK| \
U_GC_PI_MASK|U_GC_PF_MASK)
#define U_GC_S_MASK (U_GC_SM_MASK|U_GC_SC_MASK|U_GC_SK_MASK|U_GC_SO_MASK)
/**
* This specifies the language directional property of a character set.
* @stable
*/
enum UCharDirection {
/** L @stable */
U_LEFT_TO_RIGHT = 0,
/** R @stable */
U_RIGHT_TO_LEFT = 1,
/** EN @stable */
U_EUROPEAN_NUMBER = 2,
/** ES @stable */
U_EUROPEAN_NUMBER_SEPARATOR = 3,
/** ET @stable */
U_EUROPEAN_NUMBER_TERMINATOR = 4,
/** AN @stable */
U_ARABIC_NUMBER = 5,
/** CS @stable */
U_COMMON_NUMBER_SEPARATOR = 6,
/** B @stable */
U_BLOCK_SEPARATOR = 7,
/** S @stable */
U_SEGMENT_SEPARATOR = 8,
/** WS @stable */
U_WHITE_SPACE_NEUTRAL = 9,
/** ON @stable */
U_OTHER_NEUTRAL = 10,
/** LRE @stable */
U_LEFT_TO_RIGHT_EMBEDDING = 11,
/** LRO @stable */
U_LEFT_TO_RIGHT_OVERRIDE = 12,
/** AL @stable */
U_RIGHT_TO_LEFT_ARABIC = 13,
/** RLE @stable */
U_RIGHT_TO_LEFT_EMBEDDING = 14,
/** RLO @stable */
U_RIGHT_TO_LEFT_OVERRIDE = 15,
/** PDF @stable */
U_POP_DIRECTIONAL_FORMAT = 16,
/** NSM @stable */
U_DIR_NON_SPACING_MARK = 17,
/** BN @stable */
U_BOUNDARY_NEUTRAL = 18,
/** @stable */
U_CHAR_DIRECTION_COUNT
};
typedef enum UCharDirection UCharDirection;
/**
* Constants for Unicode blocks, generated from Unicode Data file Blocks.txt
* These are the same values as Unicode::EUnicodeScript
* @draft ICU 2.0
*/
enum UBlockCode {
/** @draft ICU 2.0 */
UBLOCK_BASIC_LATIN = 1,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_BASIC_LATIN = 1,
/** @draft ICU 2.0 */
UBLOCK_LATIN_1_SUPPLEMENT=2,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_LATIN_1_SUPPLEMENT=2,
/** @draft ICU 2.0 */
UBLOCK_LATIN_EXTENDED_A =3,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_LATIN_EXTENDED_A=3,
/** @draft ICU 2.0 */
UBLOCK_LATIN_EXTENDED_B =4,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_LATIN_EXTENDED_B=4,
/** @draft ICU 2.0 */
UBLOCK_IPA_EXTENSIONS =5,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_IPA_EXTENSIONS=5,
/** @draft ICU 2.0 */
UBLOCK_SPACING_MODIFIER_LETTERS =6,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_SPACING_MODIFIER_LETTERS=6,
/** @draft ICU 2.0 */
UBLOCK_COMBINING_DIACRITICAL_MARKS =7,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_COMBINING_DIACRITICAL_MARKS=7,
/**
* Unicode 3.2 renames this block to "Greek and Coptic".
* @draft ICU 2.0
*/
UBLOCK_GREEK =8,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_GREEK=8,
/** @draft ICU 2.0 */
UBLOCK_CYRILLIC =9,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_CYRILLIC=9,
/** @draft ICU 2.0 */
UBLOCK_ARMENIAN =10,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_ARMENIAN=10,
/** @draft ICU 2.0 */
UBLOCK_HEBREW =11,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_HEBREW=11,
/** @draft ICU 2.0 */
UBLOCK_ARABIC =12,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_ARABIC=12,
/** @draft ICU 2.0 */
UBLOCK_SYRIAC =13,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_SYRIAC=13,
/** @draft ICU 2.0 */
UBLOCK_THAANA =14,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_THAANA=14,
/** @draft ICU 2.0 */
UBLOCK_DEVANAGARI =15,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_DEVANAGARI=15,
/** @draft ICU 2.0 */
UBLOCK_BENGALI =16,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_BENGALI=16,
/** @draft ICU 2.0 */
UBLOCK_GURMUKHI =17,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_GURMUKHI=17,
/** @draft ICU 2.0 */
UBLOCK_GUJARATI =18,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_GUJARATI=18,
/** @draft ICU 2.0 */
UBLOCK_ORIYA =19,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_ORIYA=19,
/** @draft ICU 2.0 */
UBLOCK_TAMIL =20,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_TAMIL=20,
/** @draft ICU 2.0 */
UBLOCK_TELUGU =21,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_TELUGU=21,
/** @draft ICU 2.0 */
UBLOCK_KANNADA =22,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_KANNADA=22,
/** @draft ICU 2.0 */
UBLOCK_MALAYALAM =23,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_MALAYALAM=23,
/** @draft ICU 2.0 */
UBLOCK_SINHALA =24,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_SINHALA=24,
/** @draft ICU 2.0 */
UBLOCK_THAI =25,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_THAI=25,
/** @draft ICU 2.0 */
UBLOCK_LAO =26,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_LAO=26,
/** @draft ICU 2.0 */
UBLOCK_TIBETAN =27,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_TIBETAN=27,
/** @draft ICU 2.0 */
UBLOCK_MYANMAR =28,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_MYANMAR=28,
/** @draft ICU 2.0 */
UBLOCK_GEORGIAN =29,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_GEORGIAN=29,
/** @draft ICU 2.0 */
UBLOCK_HANGUL_JAMO =30,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_HANGUL_JAMO=30,
/** @draft ICU 2.0 */
UBLOCK_ETHIOPIC =31,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_ETHIOPIC=31,
/** @draft ICU 2.0 */
UBLOCK_CHEROKEE =32,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_CHEROKEE=32,
/** @draft ICU 2.0 */
UBLOCK_UNIFIED_CANADIAN_ABORIGINAL_SYLLABICS =33,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_UNIFIED_CANADIAN_ABORIGINAL_SYLLABICS=33,
/** @draft ICU 2.0 */
UBLOCK_OGHAM =34,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_OGHAM=34,
/** @draft ICU 2.0 */
UBLOCK_RUNIC =35,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_RUNIC=35,
/** @draft ICU 2.0 */
UBLOCK_KHMER =36,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_KHMER=36,
/** @draft ICU 2.0 */
UBLOCK_MONGOLIAN =37,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_MONGOLIAN=37,
/** @draft ICU 2.0 */
UBLOCK_LATIN_EXTENDED_ADDITIONAL =38,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_LATIN_EXTENDED_ADDITIONAL=38,
/** @draft ICU 2.0 */
UBLOCK_GREEK_EXTENDED =39,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_GREEK_EXTENDED=39,
/** @draft ICU 2.0 */
UBLOCK_GENERAL_PUNCTUATION =40,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_GENERAL_PUNCTUATION=40,
/** @draft ICU 2.0 */
UBLOCK_SUPERSCRIPTS_AND_SUBSCRIPTS =41,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_SUPERSCRIPTS_AND_SUBSCRIPTS=41,
/** @draft ICU 2.0 */
UBLOCK_CURRENCY_SYMBOLS =42,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_CURRENCY_SYMBOLS=42,
/**
* Unicode 3.2 renames this block to "Combining Diacritical Marks for Symbols".
* @draft ICU 2.0
*/
UBLOCK_COMBINING_MARKS_FOR_SYMBOLS =43,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_COMBINING_MARKS_FOR_SYMBOLS=43,
/** @draft ICU 2.0 */
UBLOCK_LETTERLIKE_SYMBOLS =44,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_LETTERLIKE_SYMBOLS=44,
/** @draft ICU 2.0 */
UBLOCK_NUMBER_FORMS =45,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_NUMBER_FORMS=45,
/** @draft ICU 2.0 */
UBLOCK_ARROWS =46,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_ARROWS=46,
/** @draft ICU 2.0 */
UBLOCK_MATHEMATICAL_OPERATORS =47,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_MATHEMATICAL_OPERATORS=47,
/** @draft ICU 2.0 */
UBLOCK_MISCELLANEOUS_TECHNICAL =48,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_MISCELLANEOUS_TECHNICAL=48,
/** @draft ICU 2.0 */
UBLOCK_CONTROL_PICTURES =49,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_CONTROL_PICTURES=49,
/** @draft ICU 2.0 */
UBLOCK_OPTICAL_CHARACTER_RECOGNITION =50,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_OPTICAL_CHARACTER_RECOGNITION=50,
/** @draft ICU 2.0 */
UBLOCK_ENCLOSED_ALPHANUMERICS =51,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_ENCLOSED_ALPHANUMERICS=51,
/** @draft ICU 2.0 */
UBLOCK_BOX_DRAWING =52,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_BOX_DRAWING=52,
/** @draft ICU 2.0 */
UBLOCK_BLOCK_ELEMENTS =53,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_BLOCK_ELEMENTS=53,
/** @draft ICU 2.0 */
UBLOCK_GEOMETRIC_SHAPES =54,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_GEOMETRIC_SHAPES=54,
/** @draft ICU 2.0 */
UBLOCK_MISCELLANEOUS_SYMBOLS =55,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_MISCELLANEOUS_SYMBOLS=55,
/** @draft ICU 2.0 */
UBLOCK_DINGBATS =56,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_DINGBATS=56,
/** @draft ICU 2.0 */
UBLOCK_BRAILLE_PATTERNS =57,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_BRAILLE_PATTERNS=57,
/** @draft ICU 2.0 */
UBLOCK_CJK_RADICALS_SUPPLEMENT =58,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_CJK_RADICALS_SUPPLEMENT=58,
/** @draft ICU 2.0 */
UBLOCK_KANGXI_RADICALS =59,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_KANGXI_RADICALS=59,
/** @draft ICU 2.0 */
UBLOCK_IDEOGRAPHIC_DESCRIPTION_CHARACTERS =60,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_IDEOGRAPHIC_DESCRIPTION_CHARACTERS=60,
/** @draft ICU 2.0 */
UBLOCK_CJK_SYMBOLS_AND_PUNCTUATION =61,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_CJK_SYMBOLS_AND_PUNCTUATION=61,
/** @draft ICU 2.0 */
UBLOCK_HIRAGANA =62,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_HIRAGANA=62,
/** @draft ICU 2.0 */
UBLOCK_KATAKANA =63,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_KATAKANA=63,
/** @draft ICU 2.0 */
UBLOCK_BOPOMOFO =64,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_BOPOMOFO=64,
/** @draft ICU 2.0 */
UBLOCK_HANGUL_COMPATIBILITY_JAMO =65,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_HANGUL_COMPATIBILITY_JAMO=65,
/** @draft ICU 2.0 */
UBLOCK_KANBUN =66,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_KANBUN=66,
/** @draft ICU 2.0 */
UBLOCK_BOPOMOFO_EXTENDED =67,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_BOPOMOFO_EXTENDED=67,
/** @draft ICU 2.0 */
UBLOCK_ENCLOSED_CJK_LETTERS_AND_MONTHS =68,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_ENCLOSED_CJK_LETTERS_AND_MONTHS=68,
/** @draft ICU 2.0 */
UBLOCK_CJK_COMPATIBILITY =69,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_CJK_COMPATIBILITY=69,
/** @draft ICU 2.0 */
UBLOCK_CJK_UNIFIED_IDEOGRAPHS_EXTENSION_A =70,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_CJK_UNIFIED_IDEOGRAPHS_EXTENSION_A=70,
/** @draft ICU 2.0 */
UBLOCK_CJK_UNIFIED_IDEOGRAPHS =71,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_CJK_UNIFIED_IDEOGRAPHS=71,
/** @draft ICU 2.0 */
UBLOCK_YI_SYLLABLES =72,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_YI_SYLLABLES=72,
/** @draft ICU 2.0 */
UBLOCK_YI_RADICALS =73,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_YI_RADICALS=73,
/** @draft ICU 2.0 */
UBLOCK_HANGUL_SYLLABLES =74,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_HANGUL_SYLLABLES=74,
/** @draft ICU 2.0 */
UBLOCK_HIGH_SURROGATES =75,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_HIGH_SURROGATES=75,
/** @draft ICU 2.0 */
UBLOCK_HIGH_PRIVATE_USE_SURROGATES =76,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_HIGH_PRIVATE_USE_SURROGATES=76,
/** @draft ICU 2.0 */
UBLOCK_LOW_SURROGATES =77,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_LOW_SURROGATES=77,
/**
* Unicode 3.2 renames this block to "Private Use Area".
* @draft ICU 2.0
*/
UBLOCK_PRIVATE_USE = 78,
/** @deprecated Use UBLOCK_PRIVATE_USE. Remove after Aug, 2002 */
UBLOCK_PRIVATE_USE_AREA =UBLOCK_PRIVATE_USE,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_PRIVATE_USE_AREA=78,
/** @draft ICU 2.0 */
UBLOCK_CJK_COMPATIBILITY_IDEOGRAPHS =79,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_CJK_COMPATIBILITY_IDEOGRAPHS=79,
/** @draft ICU 2.0 */
UBLOCK_ALPHABETIC_PRESENTATION_FORMS =80,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_ALPHABETIC_PRESENTATION_FORMS=80,
/** @draft ICU 2.0 */
UBLOCK_ARABIC_PRESENTATION_FORMS_A =81,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_ARABIC_PRESENTATION_FORMS_A=81,
/** @draft ICU 2.0 */
UBLOCK_COMBINING_HALF_MARKS =82,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_COMBINING_HALF_MARKS=82,
/** @draft ICU 2.0 */
UBLOCK_CJK_COMPATIBILITY_FORMS =83,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_CJK_COMPATIBILITY_FORMS=83,
/** @draft ICU 2.0 */
UBLOCK_SMALL_FORM_VARIANTS =84,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_SMALL_FORM_VARIANTS=84,
/** @draft ICU 2.0 */
UBLOCK_ARABIC_PRESENTATION_FORMS_B =85,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_ARABIC_PRESENTATION_FORMS_B=85,
/** @draft ICU 2.0 */
UBLOCK_SPECIALS =86,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_SPECIALS=86,
/** @draft ICU 2.0 */
UBLOCK_HALFWIDTH_AND_FULLWIDTH_FORMS =87,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_HALFWIDTH_AND_FULLWIDTH_FORMS=87,
/** @draft ICU 2.0 */
UBLOCK_OLD_ITALIC = 88 ,
/** @draft ICU 2.0 */
UBLOCK_GOTHIC = 89 ,
/** @draft ICU 2.0 */
UBLOCK_DESERET = 90 ,
/** @draft ICU 2.0 */
UBLOCK_BYZANTINE_MUSICAL_SYMBOLS = 91 ,
/** @draft ICU 2.0 */
UBLOCK_MUSICAL_SYMBOLS = 92 ,
/** @draft ICU 2.0 */
UBLOCK_MATHEMATICAL_ALPHANUMERIC_SYMBOLS = 93 ,
/** @draft ICU 2.0 */
UBLOCK_CJK_UNIFIED_IDEOGRAPHS_EXTENSION_B = 94 ,
/** @draft ICU 2.0 */
UBLOCK_CJK_COMPATIBILITY_IDEOGRAPHS_SUPPLEMENT = 95 ,
/** @draft ICU 2.0 */
UBLOCK_TAGS = 96,
/* New blocks in Unicode 3.2 */
/** @draft ICU 2.2 */
UBLOCKS_CYRILLIC_SUPPLEMENTARY = 97,
/** @draft ICU 2.2 */
UBLOCKS_TAGALOG = 98,
/** @draft ICU 2.2 */
UBLOCKS_HANUNOO = 99,
/** @draft ICU 2.2 */
UBLOCKS_BUHID = 100,
/** @draft ICU 2.2 */
UBLOCKS_TAGBANWA = 101,
/** @draft ICU 2.2 */
UBLOCKS_MISCELLANEOUS_MATHEMATICAL_SYMBOLS_A = 102,
/** @draft ICU 2.2 */
UBLOCKS_SUPPLEMENTAL_ARROWS_A = 103,
/** @draft ICU 2.2 */
UBLOCKS_SUPPLEMENTAL_ARROWS_B = 104,
/** @draft ICU 2.2 */
UBLOCKS_MISCELLANEOUS_MATHEMATICAL_SYMBOLS_B = 105,
/** @draft ICU 2.2 */
UBLOCKS_SUPPLEMENTAL_MATHEMATICAL_OPERATORS = 106,
/** @draft ICU 2.2 */
UBLOCKS_KATAKANA_PHONETIC_EXTENSIONS = 107,
/** @draft ICU 2.2 */
UBLOCKS_VARIATION_SELECTORS = 108,
/** @draft ICU 2.2 */
UBLOCKS_SUPPLEMENTARY_PRIVATE_USE_AREA_A = 109,
/** @draft ICU 2.2 */
UBLOCKS_SUPPLEMENTARY_PRIVATE_USE_AREA_B = 110,
/** @draft ICU 2.0 */
UBLOCK_COUNT,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_SCRIPT_COUNT=UBLOCK_COUNT,
/** @draft ICU 2.0 */
UBLOCK_INVALID_CODE=-1,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_CHAR_SCRIPT_COUNT =UBLOCK_COUNT,
/** @deprecated Use the enum that begins with UBLOCK. Remove after Aug, 2002*/
U_NO_SCRIPT = UBLOCK_COUNT
};
/** @draft ICU 2.0 */
typedef enum UBlockCode UBlockCode;
/**
* Values returned by the u_getCellWidth() function.
* @deprecated To be removed after 2003-jun-30; use UCHAR_EAST_ASIAN_WIDTH.
*/
enum UCellWidth
{
/** @stable */
U_ZERO_WIDTH = 0,
/** @stable */
U_HALF_WIDTH = 1,
/** @stable */
U_FULL_WIDTH = 2,
/** @stable */
U_NEUTRAL_WIDTH = 3,
/** @stable */
U_CELL_WIDTH_COUNT
};
/** @deprecated To be removed after 2003-jun-30; use UCHAR_EAST_ASIAN_WIDTH. */
typedef enum UCellWidth UCellWidth;
/**
* East Asian Width constants.
*
* @see UCHAR_EAST_ASIAN_WIDTH
* @draft ICU 2.2
*/
enum UEastAsianWidth {
U_EA_NEUTRAL,
U_EA_AMBIGUOUS,
U_EA_HALFWIDTH,
U_EA_FULLWIDTH,
U_EA_NARROW,
U_EA_WIDE,
U_EA_COUNT
};
typedef enum UEastAsianWidth UEastAsianWidth;
/*
* Implementation note:
* Keep UEastAsianWidth constant values in sync with names list in genprops/props2.c.
*/
/**
* Selector constants for u_charName().
* <code>u_charName() returns the "modern" name of a
* Unicode character; or the name that was defined in
* Unicode version 1.0, before the Unicode standard merged
* with ISO-10646; or an "extended" name that gives each
* Unicode code point a unique name.
*
* @see u_charName
* @stable
*/
enum UCharNameChoice {
U_UNICODE_CHAR_NAME,
U_UNICODE_10_CHAR_NAME,
U_EXTENDED_CHAR_NAME,
U_CHAR_NAME_CHOICE_COUNT
};
/** @stable */
typedef enum UCharNameChoice UCharNameChoice;
/**
* Decomposition Type constants.
*
* @see UCHAR_DECOMPOSITION_TYPE
* @draft ICU 2.2
*/
enum UDecompositionType {
U_DT_NONE,
U_DT_CANONICAL,
U_DT_COMPAT,
U_DT_CIRCLE,
U_DT_FINAL,
U_DT_FONT,
U_DT_FRACTION,
U_DT_INITIAL,
U_DT_ISOLATED,
U_DT_MEDIAL,
U_DT_NARROW,
U_DT_NOBREAK,
U_DT_SMALL,
U_DT_SQUARE,
U_DT_SUB,
U_DT_SUPER,
U_DT_VERTICAL,
U_DT_WIDE,
U_DT_COUNT /* 18 */
};
typedef enum UDecompositionType UDecompositionType;
/**
* Joining Type constants.
*
* @see UCHAR_JOINING_TYPE
* @draft ICU 2.2
*/
enum UJoiningType {
U_JT_NON_JOINING,
U_JT_JOIN_CAUSING,
U_JT_DUAL_JOINING,
U_JT_LEFT_JOINING,
U_JT_RIGHT_JOINING,
U_JT_TRANSPARENT,
U_JT_COUNT /* 6 */
};
typedef enum UJoiningType UJoiningType;
/**
* Joining Group constants.
*
* @see UCHAR_JOINING_GROUP
* @draft ICU 2.2
*/
enum UJoiningGroup {
U_JG_NO_JOINING_GROUP,
U_JG_AIN,
U_JG_ALAPH,
U_JG_ALEF,
U_JG_BEH,
U_JG_BETH,
U_JG_DAL,
U_JG_DALATH_RISH,
U_JG_E,
U_JG_FEH,
U_JG_FINAL_SEMKATH,
U_JG_GAF,
U_JG_GAMAL,
U_JG_HAH,
U_JG_HAMZA_ON_HEH_GOAL,
U_JG_HE,
U_JG_HEH,
U_JG_HEH_GOAL,
U_JG_HETH,
U_JG_KAF,
U_JG_KAPH,
U_JG_KNOTTED_HEH,
U_JG_LAM,
U_JG_LAMADH,
U_JG_MEEM,
U_JG_MIM,
U_JG_NOON,
U_JG_NUN,
U_JG_PE,
U_JG_QAF,
U_JG_QAPH,
U_JG_REH,
U_JG_REVERSED_PE,
U_JG_SAD,
U_JG_SADHE,
U_JG_SEEN,
U_JG_SEMKATH,
U_JG_SHIN,
U_JG_SWASH_KAF,
U_JG_SYRIAC_WAW,
U_JG_TAH,
U_JG_TAW,
U_JG_TEH_MARBUTA,
U_JG_TETH,
U_JG_WAW,
U_JG_YEH,
U_JG_YEH_BARREE,
U_JG_YEH_WITH_TAIL,
U_JG_YUDH,
U_JG_YUDH_HE,
U_JG_ZAIN,
U_JG_COUNT /* 51 */
};
typedef enum UJoiningGroup UJoiningGroup;
/**
* Line Break constants.
*
* @see UCHAR_LINE_BREAK
* @draft ICU 2.2
*/
enum ULineBreak {
U_LB_UNKNOWN,
U_LB_AMBIGUOUS,
U_LB_ALPHABETIC,
U_LB_BREAK_BOTH,
U_LB_BREAK_AFTER,
U_LB_BREAK_BEFORE,
U_LB_MANDATORY_BREAK,
U_LB_CONTINGENT_BREAK,
U_LB_CLOSE_PUNCTUATION,
U_LB_COMBINING_MARK,
U_LB_CARRIAGE_RETURN,
U_LB_EXCLAMATION,
U_LB_GLUE,
U_LB_HYPHEN,
U_LB_IDEOGRAPHIC,
U_LB_INSEPERABLE,
U_LB_INFIX_NUMERIC,
U_LB_LINE_FEED,
U_LB_NONSTARTER,
U_LB_NUMERIC,
U_LB_OPEN_PUNCTUATION,
U_LB_POSTFIX_NUMERIC,
U_LB_PREFIX_NUMERIC,
U_LB_QUOTATION,
U_LB_COMPLEX_CONTEXT,
U_LB_SURROGATE,
U_LB_SPACE,
U_LB_BREAK_SYMBOLS,
U_LB_ZWSPACE,
U_LB_COUNT /* 29 */
};
typedef enum ULineBreak ULineBreak;
/**
* Numeric Type constants.
*
* @see UCHAR_NUMERIC_TYPE
* @draft ICU 2.2
*/
enum UNumericType {
U_NT_NONE,
U_NT_DECIMAL,
U_NT_DIGIT,
U_NT_NUMERIC,
U_NT_COUNT
};
typedef enum UNumericType UNumericType;
/**
* Check a binary Unicode property for a code point.
*
* Unicode, especially in version 3.2, defines many more properties than the
* original set in UnicodeData.txt.
*
* The properties APIs are intended to reflect Unicode properties as defined
* in the Unicode Character Database (UCD) and Unicode Technical Reports (UTR).
* For details about the properties see http://www.unicode.org/ .
* For names of Unicode properties see the UCD file PropertyAliases.txt.
*
* Important: If ICU is built with UCD files from Unicode versions below 3.2,
* then properties marked with "new in Unicode 3.2" are not or not fully available.
*
* @param c Code point to test.
* @param which UProperty selector constant, identifies which binary property to check.
* Must be UCHAR_BINARY_START<=which<UCHAR_BINARY_LIMIT.
* @return TRUE or FALSE according to the binary Unicode property value for c.
* Also FALSE if which is out of bounds or if the Unicode version
* does not have data for the property at all, or not for this code point.
*
* @see UProperty
* @see u_getIntPropertyValue
* @see u_getUnicodeVersion
* @draft ICU 2.1
*/
U_CAPI UBool U_EXPORT2
u_hasBinaryProperty(UChar32 c, UProperty which);
/**
* Check if a code point has the Alphabetic Unicode property.
* Same as u_hasBinaryProperty(c, UCHAR_ALPHABETIC).
* This is different from u_isalpha!
* @param c Code point to test
* @return true if the code point has the Alphabetic Unicode property, false otherwise
*
* @see UCHAR_ALPHABETIC
* @see u_isalpha
* @see u_hasBinaryProperty
* @draft ICU 2.1
*/
U_CAPI UBool U_EXPORT2
u_isUAlphabetic(UChar32 c);
/**
* Check if a code point has the Lowercase Unicode property.
* Same as u_hasBinaryProperty(c, UCHAR_LOWERCASE).
* This is different from u_islower!
* @param c Code point to test
* @return true if the code point has the Lowercase Unicode property, false otherwise
*
* @see UCHAR_LOWERCASE
* @see u_islower
* @see u_hasBinaryProperty
* @draft ICU 2.1
*/
U_CAPI UBool U_EXPORT2
u_isULowercase(UChar32 c);
/**
* Check if a code point has the Uppercase Unicode property.
* Same as u_hasBinaryProperty(c, UCHAR_UPPERCASE).
* This is different from u_isupper!
* @param c Code point to test
* @return true if the code point has the Uppercase Unicode property, false otherwise
*
* @see UCHAR_UPPERCASE
* @see u_isupper
* @see u_hasBinaryProperty
* @draft ICU 2.1
*/
U_CAPI UBool U_EXPORT2
u_isUUppercase(UChar32 c);
/**
* Check if a code point has the White_Space Unicode property.
* Same as u_hasBinaryProperty(c, UCHAR_WHITE_SPACE).
* This is different from both u_isspace and u_isWhitespace!
* @param c Code point to test
* @return true if the code point has the White_Space Unicode property, false otherwise.
*
* @see UCHAR_WHITE_SPACE
* @see u_isWhitespace
* @see u_isspace
* @see u_hasBinaryProperty
* @draft ICU 2.1
*/
U_CAPI UBool U_EXPORT2
u_isUWhiteSpace(UChar32 c);
/*
* ### TODO Document all properties more precisely, how they are based (or not) on UCD files.
* Especially u_isdigit, u_isspace, u_isWhitespace.
*/
/**
* Get the property value for an enumerated or integer Unicode property for a code point.
* Also returns binary property values.
*
* Unicode, especially in version 3.2, defines many more properties than the
* original set in UnicodeData.txt.
*
* The properties APIs are intended to reflect Unicode properties as defined
* in the Unicode Character Database (UCD) and Unicode Technical Reports (UTR).
* For details about the properties see http://www.unicode.org/ .
* For names of Unicode properties see the UCD file PropertyAliases.txt.
*
* Sample usage:
* UEastAsianWidth ea=(UEastAsianWidth)u_getIntPropertyValue(c, UCHAR_EAST_ASIAN_WIDTH);
* UBool b=(UBool)u_getIntPropertyValue(c, UCHAR_IDEOGRAPHIC);
*
* @param c Code point to test.
* @param which UProperty selector constant, identifies which binary property to check.
* Must be UCHAR_BINARY_START<=which<UCHAR_BINARY_LIMIT
* or UCHAR_INT_START<=which<UCHAR_INT_LIMIT.
* @return Numeric value that is directly the property value or,
* for enumerated properties, corresponds to the numeric value of the enumerated
* constant of the respective property value enumeration type
* (cast to enum type if necessary).
* Returns 0 or 1 (for FALSE/TRUE) for binary Unicode properties.
* Returns 0 if which is out of bounds or if the Unicode version
* does not have data for the property at all, or not for this code point.
*
* @see UProperty
* @see u_hasBinaryProperty
* @see u_getIntPropertyMinValue
* @see u_getIntPropertyMaxValue
* @see u_getUnicodeVersion
* @draft ICU 2.2
*/
U_CAPI int32_t U_EXPORT2
u_getIntPropertyValue(UChar32 c, UProperty which);
/**
* Get the minimum value for an enumerated/integer/binary Unicode property.
* Can be used together with u_getIntPropertyMaxValue
* to allocate arrays of UnicodeSet or similar.
*
* @param which UProperty selector constant, identifies which binary property to check.
* Must be UCHAR_BINARY_START<=which<UCHAR_BINARY_LIMIT
* or UCHAR_INT_START<=which<UCHAR_INT_LIMIT.
* @return Minimum value returned by u_getIntPropertyValue for a Unicode property.
* Can be negative.
* 0 if the property selector is out of range.
*
* @see UProperty
* @see u_hasBinaryProperty
* @see u_getUnicodeVersion
* @see u_getIntPropertyMaxValue
* @see u_getIntPropertyValue
* @draft ICU 2.2
*/
U_CAPI int32_t U_EXPORT2
u_getIntPropertyMinValue(UProperty which);
/**
* Get the maximum value for an enumerated/integer/binary Unicode property.
* Can be used together with u_getIntPropertyMinValue
* to allocate arrays of UnicodeSet or similar.
*
* Examples for min/max values (for Unicode 3.2):
*
* - UCHAR_BIDI_CLASS: 0/18 (U_LEFT_TO_RIGHT/U_BOUNDARY_NEUTRAL)
* - UCHAR_SCRIPT: -1/45 (USCRIPT_INVALID_CODE/USCRIPT_TAGBANWA)
* - UCHAR_IDEOGRAPHIC: 0/1 (FALSE/TRUE)
*
* For undefined UProperty constant values, both min/max values will be 0.
* @param which UProperty selector constant, identifies which binary property to check.
* Must be UCHAR_BINARY_START<=which<UCHAR_BINARY_LIMIT
* or UCHAR_INT_START<=which<UCHAR_INT_LIMIT.
* @return Maximum value returned by u_getIntPropertyValue for a Unicode property.
* 0 if the property selector is out of range.
*
* @see UProperty
* @see u_hasBinaryProperty
* @see u_getUnicodeVersion
* @see u_getIntPropertyMaxValue
* @see u_getIntPropertyValue
* @draft ICU 2.2
*/
U_CAPI int32_t U_EXPORT2
u_getIntPropertyMaxValue(UProperty which);
/**
* Get the numeric value for a Unicode code point as defined in the
* Unicode Character Database.
*
* A "double" return type is necessary because
* some numeric values are fractions, negative, or too large for int32_t.
*
* For characters without any numeric values in the Unicode Character Database,
* this function will return U_NO_NUMERIC_VALUE.
*
* @param c Code point to get the numeric value for.
* @return Numeric value of c, or U_NO_NUMERIC_VALUE if none is defined.
*
* @see U_NO_NUMERIC_VALUE
* @draft ICU 2.2
*/
U_CAPI double U_EXPORT2
u_getNumericValue(UChar32 c);
/**
* Special value that is returned by u_getNumericValue when
* no numeric value is defined for a code point.
*
* @see u_getNumericValue
* @draft ICU 2.2
*/
#define U_NO_NUMERIC_VALUE ((double)-123456789.)
/**
* Determines whether the specified UChar is a lowercase character
* according to UnicodeData.txt.
*
* @param c the character to be tested
* @return true if the character is lowercase; false otherwise.
* @see UNICODE_VERSION
* @see u_isupper
* @see u_istitle
* @see u_islower
* @stable
*/
U_CAPI UBool U_EXPORT2
u_islower(UChar32 c);
/**
* Determines whether the specified character is an uppercase character
* according to UnicodeData.txt.
*
* @param c the character to be tested
* @return true if the character is uppercase; false otherwise.
* @see u_islower
* @see u_istitle
* @see u_tolower
* @stable
*/
U_CAPI UBool U_EXPORT2
u_isupper(UChar32 c);
/**
* Determines whether the specified character is a titlecase character
* according to UnicodeData.txt.
*
* @param c the character to be tested
* @return true if the character is titlecase; false otherwise.
* @see u_isupper
* @see u_islower
* @see u_totitle
* @stable
*/
U_CAPI UBool U_EXPORT2
u_istitle(UChar32 c);
/**
* Determines whether the specified character is a digit according to UnicodeData.txt.
*
* @param c the character to be tested
* @return true if the character is a digit; false otherwise.
* @stable
*/
U_CAPI UBool U_EXPORT2
u_isdigit(UChar32 c);
/**
* Determines whether the specified character is an alphanumeric character
* (letter or digit)according to UnicodeData.txt.
*
* @param c the character to be tested
* @return true if the character is a letter or a digit; false otherwise.
* @stable
*/
U_CAPI UBool U_EXPORT2
u_isalnum(UChar32 c);
/**
* Determines whether the specified numeric value is actually a defined character
* according to UnicodeData.txt.
*
* @param c the character to be tested
* @return true if the character has a defined Unicode meaning; false otherwise.
*
* @see u_isdigit
* @see u_isalpha
* @see u_isalnum
* @see u_isupper
* @see u_islower
* @see u_istitle
* @stable
*/
U_CAPI UBool U_EXPORT2
u_isdefined(UChar32 c);
/**
* Determines whether the specified character is a letter
* according to UnicodeData.txt.
*
* @param c the character to be tested
* @return true if the character is a letter; false otherwise.
*
* @see u_isdigit
* @see u_isalnum
* @stable
*/
U_CAPI UBool U_EXPORT2
u_isalpha(UChar32 c);
/**
* Determines if the specified character is a space character or not.
*
* @param c the character to be tested
* @return true if the character is a space character; false otherwise.
* @stable
*/
U_CAPI UBool U_EXPORT2
u_isspace(UChar32 c);
/**
* Determines if the specified character is white space according to ICU.
* A character is considered to be an ICU whitespace character if and only
* if it satisfies one of the following criteria:
* <ul>
* <li> It is a Unicode space separator (category "Zs"), but is not
* a no-break space (&#92;u00A0 or &#92;uFEFF).
* <li> It is a Unicode line separator (category "Zl").
* <li> It is a Unicode paragraph separator (category "Zp").
* <li> It is &#92;u0009, HORIZONTAL TABULATION.
* <li> It is &#92;u000A, LINE FEED.
* <li> It is &#92;u000B, VERTICAL TABULATION.
* <li> It is &#92;u000C, FORM FEED.
* <li> It is &#92;u000D, CARRIAGE RETURN.
* <li> It is &#92;u001C, FILE SEPARATOR.
* <li> It is &#92;u001D, GROUP SEPARATOR.
* <li> It is &#92;u001E, RECORD SEPARATOR.
* <li> It is &#92;u001F, UNIT SEPARATOR.
* </ul>
* Note: This method corresponds to the Java method
* <tt>java.lang.Character.isWhitespace()</tt>.
*
* @param ch the character to be tested.
* @return true if the character is an ICU whitespace character;
* false otherwise.
* @see #u_isspace
* @stable
*/
U_CAPI UBool U_EXPORT2
u_isWhitespace(UChar32 c);
/**
* Determines whether the specified character is a control character or not.
* A control character is one of the following:
* - ISO 8-bit control character (U+0000..U+001f and U+007f..U+009f)
* - U_CONTROL_CHAR (Cc)
* - U_FORMAT_CHAR (Cf)
* - U_LINE_SEPARATOR (Zl)
* - U_PARAGRAPH_SEPARATOR (Zp)
*
* @param c the character to be tested
* @return true if the Unicode character is a control character; false otherwise.
*
* @see u_isprint
* @stable
*/
U_CAPI UBool U_EXPORT2
u_iscntrl(UChar32 c);
/**
* Determines whether the specified character is a printable character according
* to UnicodeData.txt.
*
* @param c the character to be tested
* @return true if the Unicode character is a printable character; false otherwise.
*
* @see u_iscntrl
* @stable
*/
U_CAPI UBool U_EXPORT2
u_isprint(UChar32 c);
/**
* Determines whether the specified character is of the base form according
* to UnicodeData.txt.
*
* @param c the character to be tested
* @return true if the Unicode character is of the base form; false otherwise.
*
* @see u_isalpha
* @see u_isdigit
* @stable
*/
U_CAPI UBool U_EXPORT2
u_isbase(UChar32 c);
/**
* Returns the linguistic direction property of a character.
* <P>
* Returns the linguistic direction property of a character.
* For example, 0x0041 (letter A) has the LEFT_TO_RIGHT directional
* property.
* @param c The character to be tested
* @return the linguistic direction property of a character.
* @see UCharDirection
* @see UCharDirection
* @stable
*/
U_CAPI UCharDirection U_EXPORT2
u_charDirection(UChar32 c);
/**
* Determines whether the character has the "mirrored" property.
* This property is set for characters that are commonly used in
* Right-To-Left contexts and need to be displayed with a "mirrored"
* glyph.
*
* @param c the character (code point, Unicode scalar value) to be tested
* @return TRUE if the character has the "mirrored" property
* @stable
*/
U_CAPI UBool U_EXPORT2
u_isMirrored(UChar32 c);
/**
* Maps the specified character to a "mirror-image" character.
* For characters with the "mirrored" property, implementations
* sometimes need a "poor man's" mapping to another Unicode
* character (code point) such that the default glyph may serve
* as the mirror-image of the default glyph of the specified
* character. This is useful for text conversion to and from
* codepages with visual order, and for displays without glyph
* selecetion capabilities.
*
* @param c the character (code point, Unicode scalar value) to be mapped
* @return another Unicode code point that may serve as a mirror-image
* substitute, or c itself if there is no such mapping or c
* does not have the "mirrored" property
* @stable
*/
U_CAPI UChar32 U_EXPORT2
u_charMirror(UChar32 c);
/**
* Deprecated because the "cell width" functions and implementation are
* out of date compared with Unicode Standard Annex #11.
* Use u_getIntPropertyValue with UCHAR_EAST_ASIAN_WIDTH.
* See http://www.unicode.org/reports/tr11/
*
* Returns a value indicating the display-cell width of the character
* when used in Asian text, according to the Unicode standard (see p. 6-130
* of The Unicode Standard, Version 2.0). The results for various characters
* are as follows:
* <P>
* U_ZERO_WIDTH: Characters which are considered to take up no display-cell space:
* control characters
* format characters
* line and paragraph separators
* non-spacing marks
* combining Hangul jungseong
* combining Hangul jongseong
* unassigned Unicode values
* <P>
* U_HALF_WIDTH: Characters which take up half a cell in standard Asian text:
* all characters in the General Scripts Area except combining Hangul choseong
* and the characters called out specifically above as ZERO_WIDTH
* alphabetic and Arabic presentation forms
* halfwidth CJK punctuation
* halfwidth Katakana
* halfwidth Hangul Jamo
* halfwidth forms, arrows, and shapes
* <P>
* U_FULL_WIDTH: Characters which take up a full cell in standard Asian text:
* combining Hangul choseong
* all characters in the CJK Phonetics and Symbols Area
* all characters in the CJK Ideographs Area
* all characters in the Hangul Syllables Area
* CJK compatibility ideographs
* CJK compatibility forms
* small form variants
* fullwidth ASCII
* fullwidth punctuation and currency signs
* <P>
* U_NEUTRAL_WIDTH: Characters whose cell width is context-dependent:
* all characters in the Symbols Area, except those specifically called out above
* all characters in the Surrogates Area
* all charcaters in the Private Use Area
* <P>
* For Korean text, this algorithm should work properly with properly normalized Korean
* text. Precomposed Hangul syllables and non-combining jamo are all considered full-
* width characters. For combining jamo, we treat we treat choseong (initial consonants)
* as double-width characters and junseong (vowels) and jongseong (final consonants)
* as non-spacing marks. This will work right in text that uses the precomposed
* choseong characters instead of teo choseong characters in a row, and which uses the
* choseong filler character at the beginning of syllables that don't have an initial
* consonant. The results may be slightly off with Korean text following different
* conventions.
* @param c The character to be tested
* @return a value indicating the display-cell width of the character when used in Asian text
* @deprecated To be removed after 2003-jun-30; use UCHAR_EAST_ASIAN_WIDTH.
*/
U_CAPI uint16_t U_EXPORT2
u_charCellWidth(UChar32 c);
/**
* Returns a value indicating a character category.
* The categories are taken from the Unicode Character Database (UCD) in
* UnicodeData.txt.
*
* @param c the character to be tested
* @return a value of type int, the character category.
* @see UCharCategory
* @stable
*/
U_CAPI int8_t U_EXPORT2
u_charType(UChar32 c);
/**
* Get a single-bit bit set for the general category of a character.
* This bit set can be compared bitwise with U_GC_SM_MASK, U_GC_L_MASK, etc.
* Same as U_MASK(u_charType(c)).
*
* @see u_charType
* @see UCharCategory
* @see U_GC_CN_MASK
* @draft ICU 2.1
*/
#define U_GET_GC_MASK(c) U_MASK(u_charType(c))
/**
* Callback from u_enumCharTypes(), is called for each contiguous range
* of code points c (where start<=c<limit)
* with the same Unicode general category ("character type").
*
* The callback function can stop the enumeration by returning FALSE.
*
* @param context an opaque pointer, as passed into utrie_enum()
* @param start the first code point in a contiguous range with value
* @param limit one past the last code point in a contiguous range with value
* @param type the general category for all code points in [start..limit[
* @return FALSE to stop the enumeration
*
* @draft ICU 2.1
* @see UCharCategory
* @see u_enumCharTypes
*/
typedef UBool U_CALLCONV
UCharEnumTypeRange(const void *context, UChar32 start, UChar32 limit, UCharCategory type);
/**
* Enumerate efficiently all code points with their Unicode general categories.
*
* This is useful for building data structures (e.g., UnicodeSet's),
* for enumerating all assigned code points (type!=U_UNASSIGNED), etc.
*
* For each contiguous range of code points with a given general category ("character type"),
* the UCharEnumTypeRange function is called.
* Adjacent ranges have different types.
* The Unicode Standard guarantees that the numeric value of the type is 0..31.
*
* @param enumRange a pointer to a function that is called for each contiguous range
* of code points with the same general category
* @param context an opaque pointer that is passed on to the callback function
*
* @draft ICU 2.1
* @see UCharCategory
* @see UCharEnumTypeRange
*/
U_CAPI void U_EXPORT2
u_enumCharTypes(UCharEnumTypeRange *enumRange, const void *context);
/**
* Returns the combining class of the code point as specified in UnicodeData.txt.
*
* @param c the code point of the character
* @return the combining class of the character
* @stable
*/
U_CAPI uint8_t U_EXPORT2
u_getCombiningClass(UChar32 c);
/**
* Returns the decimal numeric value of a digit character.
*
* @param c the decimal digit character for which to get the numeric value
* @return the numeric value of c in decimal radix. This method returns
* -1 if c is not a valid digit character.
* @stable
*/
U_CAPI int32_t U_EXPORT2
u_charDigitValue(UChar32 c);
/**
* Returns the Unicode allocation block that contains the character.
*
* @param ch The character to be tested
* @return the Unicode allocation block that contains the character
* @see #UBlockCode
* @draft ICU 2.0
*/
U_CAPI UBlockCode U_EXPORT2
ublock_getCode(UChar32 ch);
/**
* Retrieve the name of a Unicode character.
* Depending on <code>nameChoice</code>, the character name written
* into the buffer is the "modern" name or the name that was defined
* in Unicode version 1.0.
* The name contains only "invariant" characters
* like A-Z, 0-9, space, and '-'.
* Unicode 1.0 names are only retrieved if they are different from the modern
* names and if the data file contains the data for them. gennames may or may
* not be called with a command line option to include 1.0 names in unames.dat.
*
* @param code The character (code point) for which to get the name.
* It must be <code>0<=code<=0x10ffff</code>.
* @param nameChoice Selector for which name to get.
* @param buffer Destination address for copying the name.
* The name will always be zero-terminated.
* If there is no name, then the buffer will be set to the empty string.
* @param bufferLength <code>==sizeof(buffer)</code>
* @param pErrorCode Pointer to a UErrorCode variable;
* check for <code>U_SUCCESS()</code> after <code>u_charName()</code>
* returns.
* @return The length of the name, or 0 if there is no name for this character.
* If the bufferLength is less than or equal to the length, then the buffer
* contains the truncated name and the returned length indicates the full
* length of the name.
* The length does not include the zero-termination.
*
* @see UCharNameChoice
* @see u_charFromName
* @see u_enumCharNames
* @stable
*/
U_CAPI int32_t U_EXPORT2
u_charName(UChar32 code, UCharNameChoice nameChoice,
char *buffer, int32_t bufferLength,
UErrorCode *pErrorCode);
/**
* Get the ISO 10646 comment for a character.
* The ISO 10646 comment is an informative field in the Unicode Character
* Database (UnicodeData.txt field 11) and is from the ISO 10646 names list.
*
* @param c The character (code point) for which to get the ISO comment.
* It must be <code>0<=c<=0x10ffff</code>.
* @param dest Destination address for copying the comment.
* The comment will be zero-terminated if possible.
* If there is no comment, then the buffer will be set to the empty string.
* @param destCapacity <code>==sizeof(dest)</code>
* @param pErrorCode Pointer to a UErrorCode variable;
* check for <code>U_SUCCESS()</code> after <code>u_getISOComment()</code>
* returns.
* @return The length of the comment, or 0 if there is no comment for this character.
* If the destCapacity is less than or equal to the length, then the buffer
* contains the truncated name and the returned length indicates the full
* length of the name.
* The length does not include the zero-termination.
*
* @draft ICU 2.2
*/
U_CAPI int32_t U_EXPORT2
u_getISOComment(UChar32 c,
char *dest, int32_t destCapacity,
UErrorCode *pErrorCode);
/**
* Find a Unicode character by its name and return its code point value.
* The name is matched exactly and completely.
* If the name does not correspond to a code point, <i>pErrorCode</i>
* is set to <code>U_INVALID_CHAR_FOUND</code>.
* A Unicode 1.0 name is matched only if it differs from the modern name.
* Unicode names are all uppercase. Extended names are lowercase followed
* by an uppercase hexadecimal number, and within angle brackets.
*
* @param nameChoice Selector for which name to match.
* @param name The name to match.
* @param pErrorCode Pointer to a UErrorCode variable
* @return The Unicode value of the code point with the given name,
* or an undefined value if there is no such code point.
*
* @see UCharNameChoice
* @see u_charName
* @see u_enumCharNames
*/
U_CAPI UChar32 U_EXPORT2
u_charFromName(UCharNameChoice nameChoice,
const char *name,
UErrorCode *pErrorCode);
/**
* Type of a callback function for u_enumCharNames() that gets called
* for each Unicode character with the code point value and
* the character name.
* If such a function returns FALSE, then the enumeration is stopped.
*
* @param context The context pointer that was passed to u_enumCharNames().
* @param code The Unicode code point for the character with this name.
* @param nameChoice Selector for which kind of names is enumerated.
* @param name The character's name, zero-terminated.
* @param length The length of the name.
* @return TRUE if the enumeration should continue, FALSE to stop it.
*
* @see UCharNameChoice
* @see u_enumCharNames
*/
typedef UBool UEnumCharNamesFn(void *context,
UChar32 code,
UCharNameChoice nameChoice,
const char *name,
int32_t length);
/**
* Enumerate all assigned Unicode characters between the start and limit
* code points (start inclusive, limit exclusive) and call a function
* for each, passing the code point value and the character name.
* For Unicode 1.0 names, only those are enumerated that differ from the
* modern names.
*
* @param start The first code point in the enumeration range.
* @param limit One more than the last code point in the enumeration range
* (the first one after the range).
* @param fn The function that is to be called for each character name.
* @param context An arbitrary pointer that is passed to the function.
* @param nameChoice Selector for which kind of names to enumerate.
* @param pErrorCode Pointer to a UErrorCode variable
*
* @see UCharNameChoice
* @see UEnumCharNamesFn
* @see u_charName
* @see u_charFromName
*/
U_CAPI void U_EXPORT2
u_enumCharNames(UChar32 start, UChar32 limit,
UEnumCharNamesFn *fn,
void *context,
UCharNameChoice nameChoice,
UErrorCode *pErrorCode);
/**
* The following functions are java specific.
*/
/**
* A convenience method for determining if a Unicode character
* is allowed to start in a Unicode identifier.
* A character may start a Unicode identifier if and only if
* it is a letter.
*
* @param c the Unicode character.
* @return TRUE if the character may start a Unicode identifier;
* FALSE otherwise.
* @see u_isalpha
* @see u_isIDPart
* @stable
*/
U_CAPI UBool U_EXPORT2
u_isIDStart(UChar32 c);
/**
* A convenience method for determining if a Unicode character
* may be part of a Unicode identifier other than the starting
* character.
* <P>
* A character may be part of a Unicode identifier if and only if
* it is one of the following:
* <ul>
* <li> a letter
* <li> a connecting punctuation character (such as "_").
* <li> a digit
* <li> a numeric letter (such as a Roman numeral character)
* <li> a combining mark
* <li> a non-spacing mark
* <li> an ignorable control character
* </ul>
*
* @param c the Unicode character.
* @return TRUE if the character may be part of a Unicode identifier;
* FALSE otherwise.
* @see u_isIDIgnorable
* @see u_isIDStart
* @stable
*/
U_CAPI UBool U_EXPORT2
u_isIDPart(UChar32 c);
/**
* A convenience method for determining if a Unicode character
* should be regarded as an ignorable character
* in a Unicode identifier.
* <P>
* The following Unicode characters are ignorable in a
* Unicode identifier:
* <table>
* <tr><td>0x0000 through 0x0008,</td>
* <td>ISO control characters that</td></tr>
* <tr><td>0x000E through 0x001B,</td> <td>are not whitespace</td></tr>
* <tr><td>and 0x007F through 0x009F</td></tr>
* <tr><td>0x200C through 0x200F</td> <td>join controls</td></tr>
* <tr><td>0x200A through 0x200E</td> <td>bidirectional controls</td></tr>
* <tr><td>0x206A through 0x206F</td> <td>format controls</td></tr>
* <tr><td>0xFEFF</td> <td>zero-width no-break space</td></tr>
* </table>
*
* @param c the Unicode character.
* @return TRUE if the character may be part of a Unicode identifier;
* FALSE otherwise.
* @see u_isIDPart
* @stable
*/
U_CAPI UBool U_EXPORT2
u_isIDIgnorable(UChar32 c);
/**
* A convenience method for determining if a Unicode character
* is allowed as the first character in a Java identifier.
* <P>
* A character may start a Java identifier if and only if
* it is one of the following:
* <ul>
* <li> a letter
* <li> a currency symbol (such as "$")
* <li> a connecting punctuation symbol (such as "_").
* </ul>
*
* @param c the Unicode character.
* @return TRUE if the character may start a Java identifier;
* FALSE otherwise.
* @see u_isJavaIDPart
* @see u_isalpha
* @see u_isIDStart
* @stable
*/
U_CAPI UBool U_EXPORT2
u_isJavaIDStart(UChar32 c);
/**
* A convenience method for determining if a Unicode character
* may be part of a Java identifier other than the starting
* character.
* <P>
* A character may be part of a Java identifier if and only if
* it is one of the following:
* <ul>
* <li> a letter
* <li> a currency symbol (such as "$")
* <li> a connecting punctuation character (such as "_").
* <li> a digit
* <li> a numeric letter (such as a Roman numeral character)
* <li> a combining mark
* <li> a non-spacing mark
* <li> an ignorable control character
* </ul>
*
* @param c the Unicode character.
* @return TRUE if the character may be part of a Unicode identifier;
* FALSE otherwise.
* @see u_isIDIgnorable
* @see u_isJavaIDStart
* @see u_isalpha
* @see u_isdigit
* @see u_isIDPart
* @stable
*/
U_CAPI UBool U_EXPORT2
u_isJavaIDPart(UChar32 c);
/**
* Functions to change character case.
*/
/**
* The given character is mapped to its lowercase equivalent according to
* UnicodeData.txt; if the character has no lowercase equivalent, the character
* itself is returned.
* <P>
* A character has a lowercase equivalent if and only if a lowercase mapping
* is specified for the character in the UnicodeData.txt attribute table.
* <P>
* u_tolower() only deals with the general letter case conversion.
* For language specific case conversion behavior, use ustrToUpper().
* For example, the case conversion for dot-less i and dotted I in Turkish,
* or for final sigma in Greek.
*
* @param c the character to be converted
* @return the lowercase equivalent of the character, if any;
* otherwise the character itself.
* @stable
*/
U_CAPI UChar32 U_EXPORT2
u_tolower(UChar32 c);
/**
* The given character is mapped to its uppercase equivalent according to UnicodeData.txt;
* if the character has no uppercase equivalent, the character itself is
* returned.
* <P>
* u_toupper() only deals with the general letter case conversion.
* For language specific case conversion behavior, use ustrToUpper().
* For example, the case conversion for dot-less i and dotted I in Turkish,
* or ess-zed (i.e., "sharp S") in German.
*
* @param c the character to be converted
* @return the uppercase equivalent of the character, if any;
* otherwise the character itself.
* @stable
*/
U_CAPI UChar32 U_EXPORT2
u_toupper(UChar32 c);
/**
* The given character is mapped to its titlecase equivalent according to UnicodeData.txt.
* There are only four Unicode characters that are truly titlecase forms
* that are distinct from uppercase forms. As a rule, if a character has no
* true titlecase equivalent, its uppercase equivalent is returned.
* <P>
* A character has a titlecase equivalent if and only if a titlecase mapping
* is specified for the character in the UnicodeData.txt data.
*
* @param c the character to be converted
* @return the titlecase equivalent of the character, if any;
* otherwise the character itself.
* @stable
*/
U_CAPI UChar32 U_EXPORT2
u_totitle(UChar32 c);
/** Option value for case folding: use default mappings defined in CaseFolding.txt. @stable */
#define U_FOLD_CASE_DEFAULT 0
/**
* Option value for case folding:
*
* Use the modified set of mappings provided in CaseFolding.txt to handle dotted I
* and dotless i appropriately for Turkic languages (tr, az).
*
* Before Unicode 3.2, CaseFolding.txt contains mappings marked with 'I' that
* are to be included for default mappings and
* excluded for the Turkic-specific mappings.
*
* Unicode 3.2 CaseFolding.txt instead contains mappings marked with 'T' that
* are to be excluded for default mappings and
* included for the Turkic-specific mappings.
*
* @stable
*/
#define U_FOLD_CASE_EXCLUDE_SPECIAL_I 1
/**
* The given character is mapped to its case folding equivalent according to
* UnicodeData.txt and CaseFolding.txt; if the character has no case folding equivalent, the character
* itself is returned.
* Only "simple", single-code point case folding mappings are used.
* "Full" mappings are used by u_strFoldCase().
*
* @param c the character to be converted
* @param options Either U_FOLD_CASE_DEFAULT or U_FOLD_CASE_EXCLUDE_SPECIAL_I
* @return the case folding equivalent of the character, if any;
* otherwise the character itself.
* @draft ICU 1.8
*/
U_CAPI UChar32 U_EXPORT2
u_foldCase(UChar32 c, uint32_t options);
/**
* Returns the numeric value of the character <code>ch</code> in the
* specified radix.
* <p>
* If the radix is not in the range <code>2 <= radix <= 36</code> or if the
* value of <code>ch</code> is not a valid digit in the specified
* radix, <code>-1</code> is returned. A character is a valid digit
* if at least one of the following is true:
* <ul>
* <li>The method <code>u_isdigit</code> is true of the character
* and the Unicode decimal digit value of the character (or its
* single-character decomposition) is less than the specified radix.
* In this case the decimal digit value is returned.
* <li>The character is one of the uppercase Latin letters
* <code>'A'</code> through <code>'Z'</code> and its code is less than
* <code>radix + 'A' - 10</code>.
* In this case, <code>ch - 'A' + 10</code>
* is returned.
* <li>The character is one of the lowercase Latin letters
* <code>'a'</code> through <code>'z'</code> and its code is less than
* <code>radix + 'a' - 10</code>.
* In this case, <code>ch - 'a' + 10</code>
* is returned.
* </ul>
*
* @param ch the character to be converted.
* @param radix the radix.
* @return the numeric value represented by the character in the
* specified radix.
*
* @see u_forDigit
* @see u_charDigitValue
* @see u_isdigit
* @draft ICU 2.0
*/
U_CAPI int32_t U_EXPORT2
u_digit(UChar32 ch, int8_t radix);
/**
* Determines the character representation for a specific digit in
* the specified radix. If the value of <code>radix</code> is not a
* valid radix, or the value of <code>digit</code> is not a valid
* digit in the specified radix, the null character
* (<code>U+0000</code>) is returned.
* <p>
* The <code>radix</code> argument is valid if it is greater than or
* equal to 2 and less than or equal to 36.
* The <code>digit</code> argument is valid if
* <code>0 <= digit < radix</code>.
* <p>
* If the digit is less than 10, then
* <code>'0' + digit</code> is returned. Otherwise, the value
* <code>'a' + digit - 10</code> is returned.
*
* @param digit the number to convert to a character.
* @param radix the radix.
* @return the <code>char</code> representation of the specified digit
* in the specified radix.
*
* @see u_digit
* @see u_charDigitValue
* @see u_isdigit
* @draft ICU 2.0
*/
U_CAPI UChar32 U_EXPORT2
u_forDigit(int32_t digit, int8_t radix);
/**
* Get the "age" of the code point.
* The "age" is the Unicode version when the code point was first
* designated (as a non-character or for Private Use)
* or assigned a character.
* This can be useful to avoid emitting code points to receiving
* processes that do not accept newer characters.
* The data is from the UCD file DerivedAge.txt.
*
* @param c The code point.
* @param versionArray The Unicode version number array, to be filled in.
*
* @draft ICU 2.1
*/
U_CAPI void U_EXPORT2
u_charAge(UChar32 c, UVersionInfo versionArray);
/**
* Gets the Unicode version information. The version array stores the version information
* for the Unicode standard that is currently used by ICU. For example, release "1.3.31.2"
* is then represented as 0x01031F02.
* @param versionArray the version # information, the result will be filled in
* @stable
*/
U_CAPI void U_EXPORT2
u_getUnicodeVersion(UVersionInfo info);
/**
* Get the FC_NFKC_Closure property string for a character.
* See Unicode Standard Annex #15 for details, search for "FC_NFKC_Closure"
* or for "FNC": http://www.unicode.org/reports/tr15/
*
* @param c The character (code point) for which to get the FC_NFKC_Closure string.
* It must be <code>0<=c<=0x10ffff</code>.
* @param dest Destination address for copying the string.
* The string will be zero-terminated if possible.
* If there is no FC_NFKC_Closure string,
* then the buffer will be set to the empty string.
* @param destCapacity <code>==sizeof(dest)</code>
* @param pErrorCode Pointer to a UErrorCode variable.
* @return The length of the string, or 0 if there is no FC_NFKC_Closure string for this character.
* If the destCapacity is less than or equal to the length, then the buffer
* contains the truncated name and the returned length indicates the full
* length of the name.
* The length does not include the zero-termination.
*
* @draft ICU 2.2
*/
U_CAPI int32_t U_EXPORT2
u_getFC_NFKC_Closure(UChar32 c, UChar *dest, int32_t destCapacity, UErrorCode *pErrorCode);
/**
*@deprecated Use u_charBlock instead. Remove after Aug,2002
*/
#define u_charScript ublock_getCode
/** @deprecated Use the enum UCharBlock instead. Remove after Aug,2002*/
typedef UBlockCode UCharScript;
U_CDECL_END
#endif /*_UCHAR*/
/*eof*/