# DisplayOptions.SubstituteHandling

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

# SubstituteHandling

*** ** * ** ***

Kotlin\|[Java](https://developer.android.com/reference/android/icu/text/DisplayOptions.SubstituteHandling "View this page in Java")  

```
class SubstituteHandling
```

|---|---|----------------------------------------------------------------------------------------------------------------------------------------------------------|
| [kotlin.Any](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-any/index.html)                                                                              |||
| ↳ | [kotlin.Enum](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-enum/index.html)\<[android.icu.text.DisplayOptions.SubstituteHandling](https://developer.android.com/reference/kotlin/android/icu/text/DisplayOptions.SubstituteHandling#)\> ||
|   | ↳ | [android.icu.text.DisplayOptions.SubstituteHandling](https://developer.android.com/reference/kotlin/android/icu/text/DisplayOptions.SubstituteHandling#) |

|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Known Direct Subclasses [DisplayOptions.SubstituteHandling.NO_SUBSTITUTE](https://developer.android.com/reference/kotlin/android/icu/text/DisplayOptions.SubstituteHandling#ENUM_VALUE:NO_SUBSTITUTE),[DisplayOptions.SubstituteHandling.SUBSTITUTE](https://developer.android.com/reference/kotlin/android/icu/text/DisplayOptions.SubstituteHandling#ENUM_VALUE:SUBSTITUTE),[DisplayOptions.SubstituteHandling.UNDEFINED](https://developer.android.com/reference/kotlin/android/icu/text/DisplayOptions.SubstituteHandling#ENUM_VALUE:UNDEFINED) |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------------------------------| | [DisplayOptions.SubstituteHandling.NO_SUBSTITUTE](https://developer.android.com/reference/kotlin/android/icu/text/DisplayOptions.SubstituteHandling#ENUM_VALUE:NO_SUBSTITUTE) | Returns a null value when no data is available.                            | | [DisplayOptions.SubstituteHandling.SUBSTITUTE](https://developer.android.com/reference/kotlin/android/icu/text/DisplayOptions.SubstituteHandling#ENUM_VALUE:SUBSTITUTE)       | Returns a fallback value (e.g., the input code) when no data is available. | | [DisplayOptions.SubstituteHandling.UNDEFINED](https://developer.android.com/reference/kotlin/android/icu/text/DisplayOptions.SubstituteHandling#ENUM_VALUE:UNDEFINED)         | A possible setting for SubstituteHandling.                                 | |

Represents all the substitute handlings.

## Summary

|                                                                                                     Enum values                                                                                                     ||
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|
| [NO_SUBSTITUTE](https://developer.android.com/reference/kotlin/android/icu/text/DisplayOptions.SubstituteHandling#ENUM_VALUE:NO_SUBSTITUTE) Returns a null value when no data is available.                      |
| [SUBSTITUTE](https://developer.android.com/reference/kotlin/android/icu/text/DisplayOptions.SubstituteHandling#ENUM_VALUE:SUBSTITUTE) Returns a fallback value (e.g., the input code) when no data is available. |
| [UNDEFINED](https://developer.android.com/reference/kotlin/android/icu/text/DisplayOptions.SubstituteHandling#ENUM_VALUE:UNDEFINED) A possible setting for SubstituteHandling.                                   |

|                                                                                                                                                                                                                               Properties                                                                                                                                                                                                                               ||
|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| static[MutableList](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-mutable-list/index.html)\<[DisplayOptions.SubstituteHandling](https://developer.android.com/reference/kotlin/android/icu/text/DisplayOptions.SubstituteHandling#)!\>! | [VALUES](https://developer.android.com/reference/kotlin/android/icu/text/DisplayOptions.SubstituteHandling#VALUES:kotlin.collections.MutableList) Unmodifiable List of all substitute handlings constants. |

## Enum values

### NO_SUBSTITUTE

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

```
enum val NO_SUBSTITUTE : DisplayOptions.SubstituteHandling
```

Returns a null value when no data is available.  

### SUBSTITUTE

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

```
enum val SUBSTITUTE : DisplayOptions.SubstituteHandling
```

Returns a fallback value (e.g., the input code) when no data is available. This is the default behaviour.  

### UNDEFINED

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

```
enum val UNDEFINED : DisplayOptions.SubstituteHandling
```

A possible setting for SubstituteHandling. The SubstituteHandling context to be used is unknown (this is the default value).

## Properties

### VALUES

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

```
static val VALUES: MutableList<DisplayOptions.SubstituteHandling!>!
```

Unmodifiable List of all substitute handlings constants. List version of[values()](https://developer.android.com/reference/kotlin/android/icu/text/DisplayOptions.SubstituteHandling#).