Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://unicode-org.github.io/icu-docs/apidoc/released/icu4c/ucptrie_8h.html below:

ICU 77.1: common/unicode/ucptrie.h File Reference

C API: This file defines an immutable Unicode code point trie. More...

Go to the source code of this file.

C API: This file defines an immutable Unicode code point trie.

See also

UCPTrie

UMutableCPTrie

Definition in file ucptrie.h.

Macro parameter value for a trie with 16-bit data values.

Use the name of this macro as a "dataAccess" parameter in other macros. Do not use this macro in any other way.

See also

UCPTRIE_VALUE_BITS_16

Stable:

ICU 63

Definition at line 326 of file ucptrie.h.

Macro parameter value for a trie with 32-bit data values.

Use the name of this macro as a "dataAccess" parameter in other macros. Do not use this macro in any other way.

See also

UCPTRIE_VALUE_BITS_32

Stable:

ICU 63

Definition at line 336 of file ucptrie.h.

Macro parameter value for a trie with 8-bit data values.

Use the name of this macro as a "dataAccess" parameter in other macros. Do not use this macro in any other way.

See also

UCPTRIE_VALUE_BITS_8

Stable:

ICU 63

Definition at line 346 of file ucptrie.h.

Returns a trie value for an ASCII code point, without range checking.

Parameters

trie (const UCPTrie *, in) the trie (of either fast or small type) dataAccess UCPTRIE_16, UCPTRIE_32, or UCPTRIE_8 according to the trie’s value width c (UChar32, in) the input code point; must be U+0000..U+007F

Returns

The ASCII code point's trie value.

Stable:

ICU 63

Definition at line 517 of file ucptrie.h.

Returns a trie value for a BMP code point (U+0000..U+FFFF), without range checking.

Can be used to look up a value for a UTF-16 code unit if other parts of the string processing check for surrogates.

Parameters

trie (const UCPTrie *, in) the trie; must have type UCPTRIE_TYPE_FAST dataAccess UCPTRIE_16, UCPTRIE_32, or UCPTRIE_8 according to the trie’s value width c (UChar32, in) the input code point, must be U+0000..U+FFFF

Returns

The BMP code point's trie value.

Stable:

ICU 63

Definition at line 530 of file ucptrie.h.

Returns a trie value for a code point, with range checking.

Returns the trie error value if c is not in the range 0..U+10FFFF.

Parameters

trie (const UCPTrie *, in) the trie; must have type UCPTRIE_TYPE_FAST dataAccess UCPTRIE_16, UCPTRIE_32, or UCPTRIE_8 according to the trie’s value width c (UChar32, in) the input code point

Returns

The code point's trie value.

Stable:

ICU 63

Definition at line 358 of file ucptrie.h.

Returns a trie value for a supplementary code point (U+10000..U+10FFFF), without range checking.

Parameters

trie (const UCPTrie *, in) the trie; must have type UCPTRIE_TYPE_FAST dataAccess UCPTRIE_16, UCPTRIE_32, or UCPTRIE_8 according to the trie’s value width c (UChar32, in) the input code point, must be U+10000..U+10FFFF

Returns

The supplementary code point's trie value.

Stable:

ICU 63

Definition at line 542 of file ucptrie.h.

(c) = *(src)++; \

int32_t __index; \

__index = _UCPTRIE_FAST_INDEX(trie, c); \

} else { \

uint16_t __c2; \

++(src); \

__index = _UCPTRIE_SMALL_INDEX(trie, c); \

} else { \

__index = (trie)->dataLength - UCPTRIE_ERROR_VALUE_NEG_DATA_OFFSET; \

} \

} \

(result) = dataAccess(trie, __index); \

#define UPRV_BLOCK_MACRO_END

Defined as "while (false)" by default.

#define UPRV_BLOCK_MACRO_BEGIN

Defined as the "do" keyword by default.

#define U16_IS_SURROGATE_LEAD(c)

Assuming c is a surrogate code point (U16_IS_SURROGATE(c)), is it a lead surrogate?

#define U16_GET_SUPPLEMENTARY(lead, trail)

Get a supplementary code point value (U+10000..U+10ffff) from its lead and trail surrogates.

#define U16_IS_SURROGATE(c)

Is this code unit a surrogate (U+d800..U+dfff)?

#define U16_IS_TRAIL(c)

Is this code unit a trail surrogate (U+dc00..U+dfff)?

UTF-16: Reads the next code point (UChar32 c, out), post-increments src, and gets a value from the trie.

Sets the trie error value if c is an unpaired surrogate.

Parameters

trie (const UCPTrie *, in) the trie; must have type UCPTRIE_TYPE_FAST dataAccess UCPTRIE_16, UCPTRIE_32, or UCPTRIE_8 according to the trie’s value width src (const UChar *, in/out) the source text pointer limit (const UChar *, in) the limit pointer for the text, or NULL if NUL-terminated c (UChar32, out) variable for the code point result (out) variable for the trie lookup result

Stable:

ICU 63

Definition at line 386 of file ucptrie.h.

(c) = *--(src); \

int32_t __index; \

__index = _UCPTRIE_FAST_INDEX(trie, c); \

} else { \

uint16_t __c2; \

--(src); \

__index = _UCPTRIE_SMALL_INDEX(trie, c); \

} else { \

__index = (trie)->dataLength - UCPTRIE_ERROR_VALUE_NEG_DATA_OFFSET; \

} \

} \

(result) = dataAccess(trie, __index); \

#define U16_IS_SURROGATE_TRAIL(c)

Assuming c is a surrogate code point (U16_IS_SURROGATE(c)), is it a trail surrogate?

#define U16_IS_LEAD(c)

Is this code unit a lead surrogate (U+d800..U+dbff)?

UTF-16: Reads the previous code point (UChar32 c, out), pre-decrements src, and gets a value from the trie.

Sets the trie error value if c is an unpaired surrogate.

Parameters

trie (const UCPTrie *, in) the trie; must have type UCPTRIE_TYPE_FAST dataAccess UCPTRIE_16, UCPTRIE_32, or UCPTRIE_8 according to the trie’s value width start (const UChar *, in) the start pointer for the text src (const UChar *, in/out) the source text pointer c (UChar32, out) variable for the code point result (out) variable for the trie lookup result

Stable:

ICU 63

Definition at line 417 of file ucptrie.h.

int32_t __lead = (uint8_t)*(src)++; \

uint8_t __t1, __t2, __t3; \

if ((src) != (limit) && \

(__lead >= 0xe0 ? \

__lead < 0xf0 ? \

++(src) != (limit) && (__t2 = *(src) - 0x80) <= 0x3f && \

(__lead = ((int32_t)(trie)->index[(__lead << 6) + (__t1 & 0x3f)]) + __t2, 1) \

: \

(__lead -= 0xf0) <= 4 && \

(__lead = (__lead << 6) | (__t1 & 0x3f), ++(src) != (limit)) && \

(__t2 = *(src) - 0x80) <= 0x3f && \

++(src) != (limit) && (__t3 = *(src) - 0x80) <= 0x3f && \

(__lead = __lead >= (trie)->shifted12HighStart ? \

(trie)->dataLength - UCPTRIE_HIGH_VALUE_NEG_DATA_OFFSET : \

ucptrie_internalSmallU8Index((trie), __lead, __t2, __t3), 1) \

: \

__lead >= 0xc2 && (__t1 = *(src) - 0x80) <= 0x3f && \

(__lead = (int32_t)(trie)->index[__lead & 0x1f] + __t1, 1))) { \

++(src); \

} else { \

__lead = (trie)->dataLength - UCPTRIE_ERROR_VALUE_NEG_DATA_OFFSET; \

} \

} \

(result) = dataAccess(trie, __lead); \

#define U8_IS_SINGLE(c)

Does this code unit (byte) encode a code point by itself (US-ASCII 0..0x7f)?

#define U8_LEAD3_T1_BITS

Internal bit vector for 3-byte UTF-8 validity check, for use in U8_IS_VALID_LEAD3_AND_T1.

#define U8_LEAD4_T1_BITS

Internal bit vector for 4-byte UTF-8 validity check, for use in U8_IS_VALID_LEAD4_AND_T1.

UTF-8: Post-increments src and gets a value from the trie.

Sets the trie error value for an ill-formed byte sequence.

Unlike UCPTRIE_FAST_U16_NEXT() this UTF-8 macro does not provide the code point because it would be more work to do so and is often not needed. If the trie value differs from the error value, then the byte sequence is well-formed, and the code point can be assembled without revalidation.

Parameters

trie (const UCPTrie *, in) the trie; must have type UCPTRIE_TYPE_FAST dataAccess UCPTRIE_16, UCPTRIE_32, or UCPTRIE_8 according to the trie’s value width src (const char *, in/out) the source text pointer limit (const char *, in) the limit pointer for the text (must not be NULL) result (out) variable for the trie lookup result

Stable:

ICU 63

Definition at line 451 of file ucptrie.h.

int32_t __index = (uint8_t)*--(src); \

__index = ucptrie_internalU8PrevIndex((trie), __index, (const uint8_t *)(start), \

(const uint8_t *)(src)); \

(src) -= __index & 7; \

__index >>= 3; \

} \

(result) = dataAccess(trie, __index); \

UTF-8: Pre-decrements src and gets a value from the trie.

Sets the trie error value for an ill-formed byte sequence.

Unlike UCPTRIE_FAST_U16_PREV() this UTF-8 macro does not provide the code point because it would be more work to do so and is often not needed. If the trie value differs from the error value, then the byte sequence is well-formed, and the code point can be assembled without revalidation.

Parameters

trie (const UCPTrie *, in) the trie; must have type UCPTRIE_TYPE_FAST dataAccess UCPTRIE_16, UCPTRIE_32, or UCPTRIE_8 according to the trie’s value width start (const char *, in) the start pointer for the text src (const char *, in/out) the source text pointer result (out) variable for the trie lookup result

Stable:

ICU 63

Definition at line 497 of file ucptrie.h.

Returns a 16-bit trie value for a code point, with range checking.

Returns the trie error value if c is not in the range U+0000..U+10FFFF.

Parameters

trie (const UCPTrie *, in) the trie; must have type UCPTRIE_TYPE_SMALL dataAccess UCPTRIE_16, UCPTRIE_32, or UCPTRIE_8 according to the trie’s value width c (UChar32, in) the input code point

Returns

The code point's trie value.

Stable:

ICU 63

Definition at line 370 of file ucptrie.h.

Closes a trie and releases associated memory.

Parameters

Stable:

ICU 63

Returns the value for a code point as stored in the trie, with range checking.

Returns the trie error value if c is not in the range 0..U+10FFFF.

Easier to use than UCPTRIE_FAST_GET() and similar macros but slower. Easier to use because, unlike the macros, this function works on all UCPTrie objects, for all types and value widths.

Parameters

trie the trie c the code point

Returns

the trie value, or the trie error value if the code point is not in the range 0..U+10FFFF

Stable:

ICU 63

Returns the last code point such that all those from start to there have the same value.

Can be used to efficiently iterate over all same-value ranges in a trie. (This is normally faster than iterating over code points and get()ting each value, but much slower than a data structure that stores ranges directly.)

If the UCPMapValueFilter function pointer is not NULL, then the value to be delivered is passed through that function, and the return value is the end of the range where all values are modified to the same actual value. The value is unchanged if that function pointer is NULL.

Example:

uint32_t value;

start = end + 1;

}

@ UCPMAP_RANGE_NORMAL

ucpmap_getRange() enumerates all same-value ranges as stored in the map.

U_CAPI UChar32 ucptrie_getRange(const UCPTrie *trie, UChar32 start, UCPMapRangeOption option, uint32_t surrogateValue, UCPMapValueFilter *filter, const void *context, uint32_t *pValue)

Returns the last code point such that all those from start to there have the same value.

int32_t UChar32

Define UChar32 as a type for single Unicode code points.

#define NULL

Define NULL if necessary, to nullptr for C++ and to ((void *)0) for C.

Parameters

trie the trie start range start option defines whether surrogates are treated normally, or as having the surrogateValue; usually UCPMAP_RANGE_NORMAL surrogateValue value for surrogates; ignored if option==UCPMAP_RANGE_NORMAL filter a pointer to a function that may modify the trie data value, or NULL if the values from the trie are to be used unmodified context an opaque pointer that is passed on to the filter function pValue if not NULL, receives the value that every code point start..end has; may have been modified by filter(context, trie value) if that function pointer is not NULL

Returns

the range end code point, or -1 if start is not a valid code point

Stable:

ICU 63

Opens a trie from its binary form, stored in 32-bit-aligned memory.

Inverse of ucptrie_toBinary().

The memory must remain valid and unchanged as long as the trie is used. You must ucptrie_close() the trie once you are done using it.

Parameters

type selects the trie type; results in an U_INVALID_FORMAT_ERROR if it does not match the binary data; use UCPTRIE_TYPE_ANY to accept any type valueWidth selects the number of bits in a data value; results in an U_INVALID_FORMAT_ERROR if it does not match the binary data; use UCPTRIE_VALUE_BITS_ANY to accept any data value width data a pointer to 32-bit-aligned memory containing the binary data of a UCPTrie length the number of bytes available at data; can be more than necessary pActualLength receives the actual number of bytes at data taken up by the trie data; can be NULL pErrorCode an in/out ICU UErrorCode

Returns

the trie

See also

umutablecptrie_open

umutablecptrie_buildImmutable

ucptrie_toBinary

Stable:

ICU 63

Writes a memory-mappable form of the trie into 32-bit aligned memory.

Inverse of ucptrie_openFromBinary().

Parameters

trie the trie data a pointer to 32-bit-aligned memory to be filled with the trie data; can be NULL if capacity==0 capacity the number of bytes available at data, or 0 for pure preflighting pErrorCode an in/out ICU UErrorCode; U_BUFFER_OVERFLOW_ERROR if the capacity is too small

Returns

the number of bytes written or (if buffer overflow) needed for the trie

See also

ucptrie_openFromBinary()

Stable:

ICU 63

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4