Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Enums](https://developer.android.com/reference/android/icu/text/SearchIterator.ElementComparisonType#enumconstants) \| [Methods](https://developer.android.com/reference/android/icu/text/SearchIterator.ElementComparisonType#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/icu/text/SearchIterator.ElementComparisonType#inhmethods)

# SearchIterator.ElementComparisonType

*** ** * ** ***

` public static final enum SearchIterator.ElementComparisonType `   
` ` ` extends https://developer.android.com/reference/java/lang/Enum<https://developer.android.com/reference/android/icu/text/SearchIterator.ElementComparisonType> ` ` `

|---|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) |||
| ↳ | [java.lang.Enum](https://developer.android.com/reference/java/lang/Enum)\<[android.icu.text.SearchIterator.ElementComparisonType](https://developer.android.com/reference/android/icu/text/SearchIterator.ElementComparisonType)\> ||
|   | ↳ | android.icu.text.SearchIterator.ElementComparisonType |

<br />

*** ** * ** ***

Option to control how collation elements are compared. The default value will be `https://developer.android.com/reference/android/icu/text/SearchIterator.ElementComparisonType#STANDARD_ELEMENT_COMPARISON`.

PATTERN_BASE_WEIGHT_IS_WILDCARD supports "asymmetric search" as described in [UTS #10 Unicode Collation Algorithm](http://www.unicode.org/reports/tr10/#Asymmetric_Search), while ANY_BASE_WEIGHT_IS_WILDCARD supports a related option in which "unmarked" characters in either the pattern or the searched text are treated as wildcards that match marked or unmarked versions of the same character.
**See also:**

- `https://developer.android.com/reference/android/icu/text/SearchIterator#setElementComparisonType(android.icu.text.SearchIterator.ElementComparisonType)`
- `https://developer.android.com/reference/android/icu/text/SearchIterator#getElementComparisonType()`

## Summary

| ### Enum values ||
|---|---|
| `https://developer.android.com/reference/android/icu/text/SearchIterator.ElementComparisonType` | `ANY_BASE_WEIGHT_IS_WILDCARD` Collation element comparison is modified to effectively provide behavior between the specified strength and strength - 1. |
| `https://developer.android.com/reference/android/icu/text/SearchIterator.ElementComparisonType` | `PATTERN_BASE_WEIGHT_IS_WILDCARD` Collation element comparison is modified to effectively provide behavior between the specified strength and strength - 1. |
| `https://developer.android.com/reference/android/icu/text/SearchIterator.ElementComparisonType` | `STANDARD_ELEMENT_COMPARISON` Standard collation element comparison at the specified collator strength. |

| ### Public methods ||
|---|---|
| ` static https://developer.android.com/reference/android/icu/text/SearchIterator.ElementComparisonType` | ` https://developer.android.com/reference/android/icu/text/SearchIterator.ElementComparisonType#valueOf(java.lang.String)(https://developer.android.com/reference/java/lang/String name) ` |
| ` static final https://developer.android.com/reference/android/icu/text/SearchIterator.ElementComparisonType` | ` https://developer.android.com/reference/android/icu/text/SearchIterator.ElementComparisonType#values()() ` |

### Inherited methods

From class ` https://developer.android.com/reference/java/lang/Enum ` ` final https://developer.android.com/reference/java/lang/Object` ` https://developer.android.com/reference/java/lang/Enum#clone()() `

Throws CloneNotSupportedException.
` final int` ` https://developer.android.com/reference/java/lang/Enum#compareTo(E)(https://developer.android.com/reference/android/icu/text/SearchIterator.ElementComparisonType o) `

Compares this enum with the specified object for order.
` final boolean` ` https://developer.android.com/reference/java/lang/Enum#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object other) `

Returns true if the specified object is equal to this enum constant.
` final void` ` https://developer.android.com/reference/java/lang/Enum#finalize()() `

enum classes cannot have finalize methods.
` final https://developer.android.com/reference/java/lang/Class<https://developer.android.com/reference/android/icu/text/SearchIterator.ElementComparisonType>` ` https://developer.android.com/reference/java/lang/Enum#getDeclaringClass()() `

Returns the Class object corresponding to this enum constant's enum type.
` final int` ` https://developer.android.com/reference/java/lang/Enum#hashCode()() `

Returns a hash code for this enum constant.
` final https://developer.android.com/reference/java/lang/String` ` https://developer.android.com/reference/java/lang/Enum#name()() `

Returns the name of this enum constant, exactly as declared in its enum declaration.
` final int` ` https://developer.android.com/reference/java/lang/Enum#ordinal()() `

Returns the ordinal of this enumeration constant (its position in its enum declaration, where the initial constant is assigned an ordinal of zero).
` https://developer.android.com/reference/java/lang/String` ` https://developer.android.com/reference/java/lang/Enum#toString()() `

Returns the name of this enum constant, as contained in the declaration.
` static <T extends https://developer.android.com/reference/java/lang/Enum<T>> T` ` https://developer.android.com/reference/java/lang/Enum#valueOf(java.lang.Class<T>,%20java.lang.String)(https://developer.android.com/reference/java/lang/Class<T> enumClass, https://developer.android.com/reference/java/lang/String name) `

Returns the enum constant of the specified enum class with the specified name.
From class ` https://developer.android.com/reference/java/lang/Object ` ` https://developer.android.com/reference/java/lang/Object` ` https://developer.android.com/reference/java/lang/Object#clone()() `

Creates and returns a copy of this object.
` boolean` ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) `

Indicates whether some other object is "equal to" this one.
` void` ` https://developer.android.com/reference/java/lang/Object#finalize()() `

Called by the garbage collector on an object when garbage collection determines that there are no more references to the object.
` final https://developer.android.com/reference/java/lang/Class<?>` ` https://developer.android.com/reference/java/lang/Object#getClass()() `

Returns the runtime class of this `Object`.
` int` ` https://developer.android.com/reference/java/lang/Object#hashCode()() `

Returns a hash code value for the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#notify()() `

Wakes up a single thread that is waiting on this object's monitor.
` final void` ` https://developer.android.com/reference/java/lang/Object#notifyAll()() `

Wakes up all threads that are waiting on this object's monitor.
` https://developer.android.com/reference/java/lang/String` ` https://developer.android.com/reference/java/lang/Object#toString()() `

Returns a string representation of the object.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos) `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis) `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed.
` final void` ` https://developer.android.com/reference/java/lang/Object#wait()() `

Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*.
From interface ` https://developer.android.com/reference/java/lang/Comparable ` ` abstract int` ` https://developer.android.com/reference/java/lang/Comparable#compareTo(T)(https://developer.android.com/reference/android/icu/text/SearchIterator.ElementComparisonType o) `

Compares this object with the specified object for order.

## Enum values

### ANY_BASE_WEIGHT_IS_WILDCARD

Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public static final SearchIterator.ElementComparisonType ANY_BASE_WEIGHT_IS_WILDCARD
```

Collation element comparison is modified to effectively provide behavior between the specified strength and strength - 1.

Collation elements in either the pattern or the searched text that have the base weight for the specified strength are treated as "wildcards" that match an element with any other weight at that collation level. For example, with a secondary-strength English collator, a plain 'e' in the pattern will match a plain e or an e with any diacritic in the searched text, but an e with diacritic in the pattern will only match an e with the same diacritic or a plain e in the searched text.

<br />

### PATTERN_BASE_WEIGHT_IS_WILDCARD

Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public static final SearchIterator.ElementComparisonType PATTERN_BASE_WEIGHT_IS_WILDCARD
```

Collation element comparison is modified to effectively provide behavior between the specified strength and strength - 1.

Collation elements in the pattern that have the base weight for the specified strength are treated as "wildcards" that match an element with any other weight at that collation level in the searched text. For example, with a secondary-strength English collator, a plain 'e' in the pattern will match a plain e or an e with any diacritic in the searched text, but an e with diacritic in the pattern will only match an e with the same diacritic in the searched text.

<br />

### STANDARD_ELEMENT_COMPARISON

Added in [API level 24](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public static final SearchIterator.ElementComparisonType STANDARD_ELEMENT_COMPARISON
```

Standard collation element comparison at the specified collator strength.

<br />

## Public methods

### valueOf

```
public static SearchIterator.ElementComparisonType valueOf (String name)
```

<br />

<br />

| Parameters ||
|---|---|
| `name` | `String` <br /> |

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/icu/text/SearchIterator.ElementComparisonType` | <br /> |

### values

```
public static final ElementComparisonType[] values ()
```

<br />

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/android/icu/text/SearchIterator.ElementComparisonType` | <br /> |