Movatterモバイル変換

Definition at line358 of fileuniset.h.

Internal:

Do not use.

This API is for internal use only.

Definition at line398 of fileuniset.h.

Constructs an empty set.

Stable:

ICU 2.0

Constructs a set containing the given range.

Ifend < start then an empty set is created.

Parameters

start	first character, inclusive, of range
end	last character, inclusive, of range

Stable:

ICU 2.4

Constructs a set from the output ofserialize().

Parameters

buffer	the 16 bit array
bufferLen	the original length returned fromserialize()
serialization	the value 'kSerialized'
status	error code

Internal:

Do not use. This API is for internal use only.

Constructs a set from the given pattern.

See the class description for the syntax of the pattern language.

Parameters

pattern	a string specifying what characters are in the set
status	returnsU_ILLEGAL_ARGUMENT_ERROR if the pattern contains a syntax error.

Stable:

ICU 2.0

Constructs a set from the given pattern.

See the class description for the syntax of the pattern language.

Parameters

pattern	a string specifying what characters are in the set
options	bitmask for options to apply to the pattern. Valid options are USET_IGNORE_SPACE and at most one of USET_CASE_INSENSITIVE, USET_ADD_CASE_MAPPINGS, USET_SIMPLE_CASE_INSENSITIVE. These case options are mutually exclusive.
symbols	a symbol table mapping variable names to values and stand-in characters to UnicodeSets; may be nullptr
status	returnsU_ILLEGAL_ARGUMENT_ERROR if the pattern contains a syntax error.

Internal:

Do not use. This API is for internal use only.

Constructs a set from the given pattern.

See the class description for the syntax of the pattern language.

Parameters

pattern	a string specifying what characters are in the set
pos	on input, the position in pattern at which to start parsing. On output, the position after the last character parsed.
options	bitmask for options to apply to the pattern. Valid options are USET_IGNORE_SPACE and at most one of USET_CASE_INSENSITIVE, USET_ADD_CASE_MAPPINGS, USET_SIMPLE_CASE_INSENSITIVE. These case options are mutually exclusive.
symbols	a symbol table mapping variable names to values and stand-in characters to UnicodeSets; may be nullptr
status	input-output error code

Stable:

ICU 2.8

Constructs a set that is identical to the givenUnicodeSet.

Stable:

ICU 2.0

Destructs the set.

Stable:

ICU 2.0

Adds the specified multicharacter to this set if it is not already present.

If this set already contains the multicharacter, the call leaves this set unchanged. Thus "ch" => {"ch"} A frozen set will not be modified.

Parameters

s	the source string

Returns

this object, for chaining

Stable:

ICU 2.4

Adds the specified character to this set if it is not already present.

If this set already contains the specified character, the call leaves this set unchanged. A frozen set will not be modified.

Parameters

c	the character (code point)

Returns

this object, for chaining

Stable:

ICU 2.0

Adds the specified range to this set if it is not already present.

If this set already contains the specified range, the call leaves this set unchanged. Ifstart > end then an empty range is added, leaving the set unchanged. This is equivalent to a boolean logic OR, or a set UNION. A frozen set will not be modified.

Parameters

start	first character, inclusive, of range to be added to this set.
end	last character, inclusive, of range to be added to this set.

Stable:

ICU 2.0

Adds all of the elements in the specified set to this set if they're not already present.

This operation effectively modifies this set so that its value is theunion of the two sets. The behavior of this operation is unspecified if the specified collection is modified while the operation is in progress. A frozen set will not be modified.

Parameters

c	set whose elements are to be added to this set.

See also

add(UChar32, UChar32)

Stable:

ICU 2.0

Adds each of the characters in this string to the set.

Note: "ch" => {"c", "h"} If this set already contains any particular character, it has no effect on that character. A frozen set will not be modified.

Parameters

s	the source string

Returns

this object, for chaining

Stable:

ICU 2.4

Implementation ofUnicodeMatcher API.

Union the set of all characters that may be matched by this object into the given set.

Parameters

toUnionTo

the set into which to union the source characters

Stable:

ICU 2.4

Implementsicu::UnicodeMatcher.

Modifies this set to contain those code points which have the given value for the given binary or enumerated property, as returned by u_getIntPropertyValue.

Prior contents of this set are lost. A frozen set will not be modified.

Parameters

prop	a property in the range UCHAR_BIN_START..UCHAR_BIN_LIMIT-1 or UCHAR_INT_START..UCHAR_INT_LIMIT-1 or UCHAR_MASK_START..UCHAR_MASK_LIMIT-1.
value	a value in the range u_getIntPropertyMinValue(prop).. u_getIntPropertyMaxValue(prop), with one exception. If prop is UCHAR_GENERAL_CATEGORY_MASK, then value should not be a UCharCategory, but rather a mask value produced byU_GET_GC_MASK(). This allows grouped categories such as [:L:] to be represented.
ec	error code input/output parameter

Returns

a reference to this set

Stable:

ICU 2.4

Parses the given pattern, starting at the given position.

The character at pattern.charAt(pos.getIndex()) must be '[', or the parse fails. Parsing continues until the corresponding closing ']'. If a syntax error is encountered between the opening and closing brace, the parse fails. Upon return from a successful parse, theParsePosition is updated to point to the character following the closing ']', and a StringBuffer containing a pairs list for the parsed pattern is returned. This method calls itself recursively to parse embedded subpatterns. Empties the set passed before applying the pattern. A frozen set will not be modified.

Parameters

pattern	the string containing the pattern to be parsed. The portion of the string from pos.getIndex(), which must be a '[', to the corresponding closing ']', is parsed.
pos	upon entry, the position at which to being parsing. The character at pattern.charAt(pos.getIndex()) must be a '['. Upon return from a successful parse, pos.getIndex() is either the character after the closing ']' of the parsed pattern, or pattern.length() if the closing ']' is the last character of the pattern string.
options	bitmask for options to apply to the pattern. Valid options are USET_IGNORE_SPACE and at most one of USET_CASE_INSENSITIVE, USET_ADD_CASE_MAPPINGS, USET_SIMPLE_CASE_INSENSITIVE. These case options are mutually exclusive.
symbols	a symbol table mapping variable names to values and stand-ins to UnicodeSets; may be nullptr
status	returnsU_ILLEGAL_ARGUMENT_ERROR if the pattern contains a syntax error.

Returns

a reference to this

Stable:

ICU 2.8

Modifies this set to represent the set specified by the given pattern, ignoring Unicode Pattern_White_Space characters.

See the class description for the syntax of the pattern language. A frozen set will not be modified.

Parameters

pattern	a string specifying what characters are in the set
status	returnsU_ILLEGAL_ARGUMENT_ERROR if the pattern contains a syntax error. Empties the set passed before applying the pattern.

Returns

a reference to this

Stable:

ICU 2.0

Modifies this set to represent the set specified by the given pattern, optionally ignoring Unicode Pattern_White_Space characters.

See the class description for the syntax of the pattern language. A frozen set will not be modified.

Parameters

pattern	a string specifying what characters are in the set
options	bitmask for options to apply to the pattern. Valid options are USET_IGNORE_SPACE and at most one of USET_CASE_INSENSITIVE, USET_ADD_CASE_MAPPINGS, USET_SIMPLE_CASE_INSENSITIVE. These case options are mutually exclusive.
symbols	a symbol table mapping variable names to values and stand-ins to UnicodeSets; may be nullptr
status	returnsU_ILLEGAL_ARGUMENT_ERROR if the pattern contains a syntax error. Empties the set passed before applying the pattern.

Returns

a reference to this

Internal:

Do not use. This API is for internal use only.

Modifies this set to contain those code points which have the given value for the given property.

Prior contents of this set are lost. A frozen set will not be modified.

Parameters

prop

a property alias, either short or long. The name is matched loosely. See PropertyAliases.txt for names and a description of loose matching. If the value string is empty, then this string is interpreted as either a General_Category value alias, a Script value alias, a binary property alias, or a special ID. Special IDs are matched loosely and correspond to the following sets:

"ANY" = [\u0000-\U0010FFFF], "ASCII" = [\u0000-\u007F], "Assigned" = [:^Cn:].

Parameters

value	a value alias, either short or long. The name is matched loosely. See PropertyValueAliases.txt for names and a description of loose matching. In addition to aliases listed, numeric values and canonical combining classes may be expressed numerically, e.g., ("nv", "0.5") or ("ccc", "220"). The value string may also be empty.
ec	error code input/output parameter

Returns

a reference to this set

Stable:

ICU 2.4

Returns a C++ iterator for iterating over all of the elements of this set.

Convenient all-in one iteration, but creates a std::u16string for each code point or string. (Similar to how JavaUnicodeSetis an Iterable<String>.)

Code points are returned first, then empty and multi-character strings.

Returns

an all-elements iterator.

Draft:

This API may be changed in the future versions and was introduced in ICU 77

See also

end

codePoints

ranges

strings

Definition at line1203 of fileuniset.h.

Returns the character at the given index within this set, where the set is ordered by ascending code point.

If the index is out of range for characters, returns (UChar32)-1. The inverse of this method isindexOf().

For iteration, this is slower thanUnicodeSetIterator orgetRangeCount()/getRangeStart()/getRangeEnd(), because for each call it skips linearly overindex characters in the ranges.

Parameters

index

an index from 0..size()-1

Returns

the character at the given index, or (UChar32)-1.

Stable:

ICU 2.4

Removes all of the elements from this set.

This set will be empty after this call returns. A frozen set will not be modified.

Stable:

ICU 2.0

Returns a copy of this object.

AllUnicodeFunctor objects have to support cloning in order to allow classes using UnicodeFunctors, such asTransliterator, to implement cloning. If this set is frozen, then the clone will be frozen as well. UsecloneAsThawed() for a mutable clone of a frozen set.

See also

cloneAsThawed

Stable:

ICU 2.0

Implementsicu::UnicodeFilter.

Clone the set and make the clone mutable.

See the ICU4J Freezable interface for details.

Returns

the mutable clone

See also

freeze

isFrozen

Stable:

ICU 3.8

Close this set over the given attribute.

For the attribute USET_CASE_INSENSITIVE, the result is to modify this set so that:

1. For each character or string 'a' in this set, all strings or characters 'b' such that foldCase(a) == foldCase(b) are added to this set.
2. For each string 'e' in the resulting set, if e != foldCase(e), 'e' will be removed.

Example: [aq\u00DF{Bc}{bC}{Fi}] => [aAqQ\u00DF\uFB01{ss}{bc}{fi}]

(Here foldCase(x) refers to the operation u_strFoldCase, and a == b denotes that the contents are the same, not pointer comparison.)

A frozen set will not be modified.

Parameters

attribute

bitmask for attributes to close over. Valid options: At most one of USET_CASE_INSENSITIVE, USET_ADD_CASE_MAPPINGS, USET_SIMPLE_CASE_INSENSITIVE. These case options are mutually exclusive. Unrelated options bits are ignored.

Returns

a reference to this set.

Stable:

ICU 4.2

Returns a C++ "range" for iterating over the code points of this set.

Returns

a "range" object for iterating over the code points of this set.

Draft:

This API may be changed in the future versions and was introduced in ICU 76

See also

ranges

strings

begin

end

Definition at line1123 of fileuniset.h.

Reallocate this objects internal structures to take up the least possible space, without changing this object's value.

A frozen set will not be modified.

Stable:

ICU 2.4

This is equivalent tocomplement(MIN_VALUE, MAX_VALUE).

Note: This performs a symmetric difference with all code pointsand thus retains all multicharacter strings. In order to achieve a “code point complement” (all code points minus this set), the easiest is to.complement().removeAllStrings().

A frozen set will not be modified.

Stable:

ICU 2.0

Complement the specified string in this set.

The string will be removed if it is in this set, or will be added if it is not in this set. A frozen set will not be modified.

Parameters

s	the string to complement

Returns

this object, for chaining

Stable:

ICU 2.4

Complements the specified character in this set.

The character will be removed if it is in this set, or will be added if it is not in this set. A frozen set will not be modified.

Parameters

c	the character (code point)

Returns

this object, for chaining

Stable:

ICU 2.0

Complements the specified range in this set.

Any character in the range will be removed if it is in this set, or will be added if it is not in this set. Ifstart > end then an empty range is complemented, leaving the set unchanged. This is equivalent to a boolean logic XOR. A frozen set will not be modified.

Parameters

start	first character, inclusive, of range
end	last character, inclusive, of range

Stable:

ICU 2.0

Complements in this set all elements contained in the specified set.

Any character in the other set will be removed if it is in this set, or will be added if it is not in this set. A frozen set will not be modified.

Parameters

c	set that defines which elements will be xor'ed from this set.

Stable:

ICU 2.4

Complement EACH of the characters in this string.

Note: "ch" == {"c", "h"} A frozen set will not be modified.

Parameters

s	the source string

Returns

this object, for chaining

Stable:

ICU 2.4

Returnstrue if this set contains the given multicharacter string.

Parameters

s	string to be checked for containment

Returns

true if this set contains the specified string

Stable:

ICU 2.4

Returns true if this set contains the given character.

This function works faster with a frozen set.

Parameters

c	character to be checked for containment

Returns

true if the test condition is met

Stable:

ICU 2.0

Implementsicu::UnicodeFilter.

Returns true if this set contains every character of the given range.

Parameters

start	first character, inclusive, of the range
end	last character, inclusive, of the range

Returns

true if the test condition is met

Stable:

ICU 2.0

Returns true if this set contains all the characters and strings of the given set.

Parameters

c	set to be checked for containment

Returns

true if the test condition is met

Stable:

ICU 2.4

Returns true if this set contains all the characters of the given string.

Parameters

s	string containing characters to be checked for containment

Returns

true if the test condition is met

Stable:

ICU 2.4

Returns true if this set contains none of the characters and strings of the given set.

Parameters

c	set to be checked for containment

Returns

true if the test condition is met

Stable:

ICU 2.4

Returns true if this set contains none of the characters of the given string.

Parameters

s	string containing characters to be checked for containment

Returns

true if the test condition is met

Stable:

ICU 2.4

Returns true if this set contains none of the characters of the given range.

Parameters

start	first character, inclusive, of the range
end	last character, inclusive, of the range

Returns

true if the test condition is met

Stable:

ICU 2.4

Returns true if this set contains one or more of the characters and strings of the given set.

Parameters

s	The set to be checked for containment

Returns

true if the condition is met

Stable:

ICU 2.4

Definition at line1856 of fileuniset.h.

Returns true if this set contains one or more of the characters of the given string.

Parameters

s	string containing characters to be checked for containment

Returns

true if the condition is met

Stable:

ICU 2.4

Definition at line1860 of fileuniset.h.

Returns true if this set contains one or more of the characters in the given range.

Parameters

start	first character, inclusive, of the range
end	last character, inclusive, of the range

Returns

true if the condition is met

Stable:

ICU 2.4

Definition at line1852 of fileuniset.h.

Makes a set from a multicharacter string.

Thus "ch" => {"ch"}

Parameters

s	the source string

Returns

a newly created set containing the given string. The caller owns the return object and is responsible for deleting it.

Stable:

ICU 2.4

Makes a set from each of the characters in the string.

Thus "ch" => {"c", "h"}

Parameters

s	the source string

Returns

a newly created set containing the given characters The caller owns the return object and is responsible for deleting it.

Stable:

ICU 2.4

Returns

an exclusive-end sentinel for iterating over all of the elements of this set.

Draft:

This API may be changed in the future versions and was introduced in ICU 77

See also

begin

codePoints

ranges

strings

Definition at line1215 of fileuniset.h.

Freeze the set (make it immutable).

Once frozen, it cannot be unfrozen and is therefore thread-safe until it is deleted. See the ICU4J Freezable interface for details. Freezing the set may also make some operations faster, for examplecontains() andspan(). A frozen set will not be modified. (It remains frozen.)

Returns

this set.

See also

isFrozen

cloneAsThawed

Stable:

ICU 3.8

Get aUnicodeSet pointer from a const USet.

Parameters

uset	a const USet (the ICU plain C type forUnicodeSet)

Returns

the correspondingUnicodeSet pointer.

Stable:

ICU 4.2

Definition at line1872 of fileuniset.h.

Get aUnicodeSet pointer from a USet.

Parameters

uset	a USet (the ICU plain C type forUnicodeSet)

Returns

the correspondingUnicodeSet pointer.

Stable:

ICU 4.2

Definition at line1868 of fileuniset.h.

ImplementUnicodeFunctor API.

Returns

The class ID for this object. All objects of a given class have the same class ID. Objects of other classes have different class IDs.

Stable:

ICU 2.4

Implementsicu::UnicodeFunctor.

Iteration method that returns the number of ranges contained in this set.

See also

getRangeStart

getRangeEnd

Stable:

ICU 2.4

Iteration method that returns the last character in the specified range of this set.

See also

getRangeStart

getRangeEnd

Stable:

ICU 2.4

Iteration method that returns the first character in the specified range of this set.

See also

getRangeCount

getRangeEnd

Stable:

ICU 2.4

Return the class ID for this class.

This is useful only for comparing to a return value fromgetDynamicClassID(). For example:

.      Base* polymorphic_pointer = createPolymorphicObject();.      if (polymorphic_pointer->getDynamicClassID() ==.          Derived::getStaticClassID()) ...

Returns

The class ID for all objects of this class.

Stable:

ICU 2.0

Returns the hash code value for this set.

Returns

the hash code value for this set.

See also

Object::hashCode()

Stable:

ICU 2.0

Returns

true if this set contains multi-character strings or the empty string.

Stable:

ICU 70

Returns the index of the given character within this set, where the set is ordered by ascending code point.

If the character is not in this set, return -1. The inverse of this method ischarAt().

Returns

an index from 0..size()-1, or -1

Stable:

ICU 2.4

Determine if this object contains a valid set.

A bogus set has no value. It is different from an empty set. It can be used to indicate that no set value is available.

Returns

true if the set is bogus/invalid, false otherwise

See also

setToBogus()

Stable:

ICU 4.0

Definition at line1864 of fileuniset.h.

Returnstrue if this set contains no elements.

Returns

true if this set contains no elements.

Stable:

ICU 2.0

Determines whether the set has been frozen (made immutable) or not.

See the ICU4J Freezable interface for details.

Returns

true/false for whether the set has been frozen

See also

freeze

cloneAsThawed

Stable:

ICU 3.8

Definition at line1848 of fileuniset.h.

ImplementUnicodeMatcher::matches()

Stable:

ICU 2.4

Reimplemented fromicu::UnicodeFilter.

Compares the specified object with this set for equality.

Returnstrue if the specified set is not equal to this set.

Stable:

ICU 2.0

Definition at line1844 of fileuniset.h.

Referencesicu::operator==().

Assigns this object to be a copy of another.

A frozen set will not be modified.

Stable:

ICU 2.0

Compares the specified object with this set for equality.

Returnstrue if the two sets have the same size, and every member of the specified set is contained in this set (or equivalently, every member of this set is contained in the specified set).

Parameters

o	set to be compared for equality with this set.

Returns

true if the specified set is equal to this set.

Stable:

ICU 2.0

Returns a C++ "range" for iterating over the code point ranges of this set.

Returns

a "range" object for iterating over the code point ranges of this set.

Draft:

This API may be changed in the future versions and was introduced in ICU 76

See also

codePoints

strings

begin

end

Definition at line1149 of fileuniset.h.

Removes the specified string from this set if it is present.

The set will not contain the specified character once the call returns. A frozen set will not be modified.

Parameters

s	the source string

Returns

this object, for chaining

Stable:

ICU 2.4

Removes the specified character from this set if it is present.

The set will not contain the specified range once the call returns. A frozen set will not be modified.

Parameters

c	the character (code point)

Returns

this object, for chaining

Stable:

ICU 2.0

Removes the specified range from this set if it is present.

The set will not contain the specified range once the call returns. Ifstart > end then an empty range is removed, leaving the set unchanged. A frozen set will not be modified.

Parameters

start	first character, inclusive, of range to be removed from this set.
end	last character, inclusive, of range to be removed from this set.

Stable:

ICU 2.0

Removes from this set all of its elements that are contained in the specified set.

This operation effectively modifies this set so that its value is theasymmetric set difference of the two sets. A frozen set will not be modified.

Parameters

c	set that defines which elements will be removed from this set.

Stable:

ICU 2.0

Remove EACH of the characters in this string.

Note: "ch" == {"c", "h"} A frozen set will not be modified.

Parameters

s	the source string

Returns

this object, for chaining

Stable:

ICU 2.4

Remove all strings from this set.

Returns

a reference to this set.

Stable:

ICU 4.2

Return true if the given position, in the given pattern, appears to be the start of aUnicodeSet pattern.

Stable:

ICU 2.4

Retains only the specified string from this set if it is present.

Upon return this set will be empty if it did not contain s, or will only contain s if it did contain s. A frozen set will not be modified.

Parameters

s	the source string

Returns

this object, for chaining

Stable:

ICU 69

Retain the specified character from this set if it is present.

A frozen set will not be modified.

Parameters

c	the character (code point)

Returns

this object, for chaining

Stable:

ICU 2.0

Retain only the elements in this set that are contained in the specified range.

Ifstart > end then an empty range is retained, leaving the set empty. This is equivalent to a boolean logic AND, or a set INTERSECTION. A frozen set will not be modified.

Parameters

start	first character, inclusive, of range
end	last character, inclusive, of range

Stable:

ICU 2.0

Retains only the elements in this set that are contained in the specified set.

In other words, removes from this set all of its elements that are not contained in the specified set. This operation effectively modifies this set so that its value is theintersection of the two sets. A frozen set will not be modified.

Parameters

c	set that defines which elements this set will retain.

Stable:

ICU 2.0

Retains EACH of the characters in this string.

Note: "ch" == {"c", "h"} A frozen set will not be modified.

Parameters

s	the source string

Returns

this object, for chaining

Stable:

ICU 2.4

Serializes this set into an array of 16-bit integers.

Serialization (currently) only records the characters in the set; multicharacter strings are ignored.

The array has following format (each line is one 16-bit integer):

length = (n+2*m) | (m!=0?0x8000:0) bmpLength = n; present if m!=0 bmp[0] bmp[1] ... bmp[n-1] supp-high[0] supp-low[0] supp-high[1] supp-low[1] ... supp-high[m-1] supp-low[m-1]

The array starts with a header. After the header are n bmp code points, then m supplementary code points. Either n or m or both may be zero. n+2*m is always <= 0x7FFF.

If there are no supplementary characters (if m==0) then the header is one 16-bit integer, 'length', with value n.

If there are supplementary characters (if m!=0) then the header is two 16-bit integers. The first, 'length', has value (n+2*m)|0x8000. The second, 'bmpLength', has value n.

After the header the code points are stored in ascending order. Supplementary code points are stored as most significant 16 bits followed by least significant 16 bits.

Parameters

dest	pointer to buffer of destCapacity 16-bit integers. May be nullptr only if destCapacity is zero.
destCapacity	size of dest, or zero. Must not be negative.
ec	error code. Will be set to U_INDEX_OUTOFBOUNDS_ERROR if n+2*m > 0x7FFF. Will be set to U_BUFFER_OVERFLOW_ERROR if n+2*m+(m!=0?2:1) > destCapacity.

Returns

the total length of the serialized format, including the header, that is, n+2*m+(m!=0?2:1), or 0 on error other than U_BUFFER_OVERFLOW_ERROR.

Stable:

ICU 2.4

Make this object represent the rangestart - end.

Ifstart > end then this object is set to an empty range. A frozen set will not be modified.

Parameters

start	first character in the set, inclusive
end	last character in the set, inclusive

Stable:

ICU 2.4

Make thisUnicodeSet object invalid.

The string will test true withisBogus().

A bogus set has no value. It is different from an empty set. It can be used to indicate that no set value is available.

This utility function is used throughout theUnicodeSet implementation to indicate that aUnicodeSet operation failed, and may be used in other functions, especially but not exclusively when such functions do not take a UErrorCode for simplicity.

See also

isBogus()

Stable:

ICU 4.0

Returns the number of elements in this set (its cardinality).

Note than the elements of a set may include both individual codepoints and strings.

This is slower thangetRangeCount() because it counts the code points of all ranges.

Returns

the number of elements in this set (its cardinality).

Stable:

ICU 2.0

See also

getRangeCount

Returns the length of the initial substring of the input string which consists only of characters and strings that are contained in this set (USET_SPAN_CONTAINED, USET_SPAN_SIMPLE), or only of characters and strings that are not contained in this set (USET_SPAN_NOT_CONTAINED).

See USetSpanCondition for details. Similar to the strspn() C library function. Unpaired surrogates are treated according tocontains() of their surrogate code points. This function works faster with a frozen set and with a non-negative string length argument.

Parameters

s	start of the string
length	of the string; can be -1 for NUL-terminated
spanCondition	specifies the containment condition

Returns

the length of the initial substring according to the spanCondition; 0 if the start of the string does not fit the spanCondition

Stable:

ICU 3.8

See also

USetSpanCondition

Returns the end of the substring of the input string according to the USetSpanCondition.

Same asstart+span(s.getBuffer()+start, s.length()-start, spanCondition) after pinning start to 0<=start<=s.length().

Parameters

s	the string
start	the start index in the string for the span operation
spanCondition	specifies the containment condition

Returns

the exclusive end of the substring according to the spanCondition; the substring s.tempSubStringBetween(start, end) fulfills the spanCondition

Stable:

ICU 4.4

See also

USetSpanCondition

Definition at line1884 of fileuniset.h.

Referencesicu::UnicodeString::getBuffer(), andicu::UnicodeString::length().

Returns the start of the trailing substring of the input string which consists only of characters and strings that are contained in this set (USET_SPAN_CONTAINED, USET_SPAN_SIMPLE), or only of characters and strings that are not contained in this set (USET_SPAN_NOT_CONTAINED).

See USetSpanCondition for details. Unpaired surrogates are treated according tocontains() of their surrogate code points. This function works faster with a frozen set and with a non-negative string length argument.

Parameters

s	start of the string
length	of the string; can be -1 for NUL-terminated
spanCondition	specifies the containment condition

Returns

the start of the trailing substring according to the spanCondition; the string length if the end of the string does not fit the spanCondition

Stable:

ICU 3.8

See also

USetSpanCondition

Returns the start of the substring of the input string according to the USetSpanCondition.

Same asspanBack(s.getBuffer(), limit, spanCondition) after pinning limit to 0<=end<=s.length().

Parameters

s	the string
limit	the exclusive-end index in the string for the span operation (use s.length() or INT32_MAX for spanning back from the end of the string)
spanCondition	specifies the containment condition

Returns

the start of the substring according to the spanCondition; the substring s.tempSubStringBetween(start, limit) fulfills the spanCondition

Stable:

ICU 4.4

See also

USetSpanCondition

Definition at line1894 of fileuniset.h.

Referencesicu::UnicodeString::getBuffer(), andicu::UnicodeString::length().

Returns the start of the trailing substring of the input string which consists only of characters and strings that are contained in this set (USET_SPAN_CONTAINED, USET_SPAN_SIMPLE), or only of characters and strings that are not contained in this set (USET_SPAN_NOT_CONTAINED).

See USetSpanCondition for details. Malformed byte sequences are treated according to contains(0xfffd). This function works faster with a frozen set and with a non-negative string length argument.

Parameters

s	start of the string (UTF-8)
length	of the string; can be -1 for NUL-terminated
spanCondition	specifies the containment condition

Returns

the start of the trailing substring according to the spanCondition; the string length if the end of the string does not fit the spanCondition

Stable:

ICU 3.8

See also

USetSpanCondition

Returns the length of the initial substring of the input string which consists only of characters and strings that are contained in this set (USET_SPAN_CONTAINED, USET_SPAN_SIMPLE), or only of characters and strings that are not contained in this set (USET_SPAN_NOT_CONTAINED).

See USetSpanCondition for details. Similar to the strspn() C library function. Malformed byte sequences are treated according to contains(0xfffd). This function works faster with a frozen set and with a non-negative string length argument.

Parameters

s	start of the string (UTF-8)
length	of the string; can be -1 for NUL-terminated
spanCondition	specifies the containment condition

Returns

the length of the initial substring according to the spanCondition; 0 if the start of the string does not fit the spanCondition

Stable:

ICU 3.8

See also

USetSpanCondition

Returns a C++ "range" for iterating over the empty and multi-character strings of this set.

Returns each string as a std::u16string_view without copying its contents.

Returns

a "range" object for iterating over the strings of this set.

Draft:

This API may be changed in the future versions and was introduced in ICU 76

See also

codePoints

ranges

begin

end

Definition at line1173 of fileuniset.h.

Returns a string representation of this set.

If the result of calling this function is passed to aUnicodeSet constructor, it will produce another set that is equal to this one. A frozen set will not be modified.

Parameters

result	the string to receive the rules. Previous contents will be deleted.
escapeUnprintable	if true then convert unprintable character to their hex escape representations, \uxxxx or \Uxxxxxxxx. Unprintable characters are those other than U+000A, U+0020..U+007E.

Stable:

ICU 2.0

Implementsicu::UnicodeMatcher.

Produce a USet * pointer for thisUnicodeSet.

USet is the plain C type forUnicodeSet

Returns

a USet pointer for thisUnicodeSet

Stable:

ICU 4.2

Definition at line1876 of fileuniset.h.

Produce a const USet * pointer for thisUnicodeSet.

USet is the plain C type forUnicodeSet

Returns

a const USet pointer for thisUnicodeSet

Stable:

ICU 4.2

Definition at line1880 of fileuniset.h.