# Assertions

Artifact: [androidx.media3:media3-common](https://developer.android.com/jetpack/androidx/releases/media3) [View Source](https://cs.android.com/search?q=file:androidx/media3/common/util/Assertions.java+class:androidx.media3.common.util.Assertions)

*** ** * ** ***


```
@UnstableApi
public final class Assertions
```

<br />

*** ** * ** ***

Provides methods for asserting the truth of expressions and properties.

## Summary

| ### Public methods |
|---|---|
| `static void` | `@https://checkerframework.org/api/org/checkerframework/dataflow/qual/Pure.html @https://checkerframework.org/api/com/google/errorprone/annotations/InlineMe.html(replacement = "Preconditions.checkArgument(expression)", imports = "com.google.common.base.Preconditions") [checkArgument](https://developer.android.com/reference/androidx/media3/common/util/Assertions#checkArgument(boolean))(boolean expression)` **This method is deprecated.** Use `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/base/Preconditions.html#checkArgument(boolean)` instead. <br /> |
| `static void` | `@https://checkerframework.org/api/org/checkerframework/dataflow/qual/Pure.html @https://checkerframework.org/api/com/google/errorprone/annotations/InlineMe.html(replacement = "Preconditions.checkArgument(expression, errorMessage)", imports = "com.google.common.base.Preconditions") [checkArgument](https://developer.android.com/reference/androidx/media3/common/util/Assertions#checkArgument(boolean,java.lang.Object))(boolean expression, https://developer.android.com/reference/java/lang/Object.html errorMessage)` **This method is deprecated.** Use `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/base/Preconditions.html#checkArgument(boolean)` instead. <br /> |
| `static int` | `@https://checkerframework.org/api/org/checkerframework/dataflow/qual/Pure.html [checkIndex](https://developer.android.com/reference/androidx/media3/common/util/Assertions#checkIndex(int,int,int))(int index, int start, int limit)` **This method is deprecated.** Use `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/base/Preconditions.html#checkElementIndex(int, int)`, with an additional assertion to check a non-zero `start` value if needed. <br /> |
| `static void` | `@https://checkerframework.org/api/org/checkerframework/dataflow/qual/Pure.html @https://checkerframework.org/api/com/google/errorprone/annotations/InlineMe.html(replacement = "Preconditions.checkState(Looper.myLooper() == Looper.getMainLooper(), \"Not in" + " application's main thread\")", imports = [""com.google.common.base.Preconditions"", ""android.os.Looper""]) [checkMainThread](https://developer.android.com/reference/androidx/media3/common/util/Assertions#checkMainThread())()` **This method is deprecated.** Use `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/base/Preconditions.html#checkState(boolean)` to assert `Looper.myLooper() == Looper.getMainLooper()` instead. <br /> |
| `static https://developer.android.com/reference/java/lang/String.html` | `@https://checkerframework.org/api/org/checkerframework/checker/nullness/qual/EnsuresNonNull.html(value = [""#1""]) @https://checkerframework.org/api/org/checkerframework/dataflow/qual/Pure.html [checkNotEmpty](https://developer.android.com/reference/androidx/media3/common/util/Assertions#checkNotEmpty(java.lang.String))(@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/java/lang/String.html string)` **This method is deprecated.** Use `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/base/Preconditions.html#checkArgument(boolean)` with `https://developer.android.com/reference/android/text/TextUtils.html#isEmpty(java.lang.CharSequence)` instead. <br /> |
| `static https://developer.android.com/reference/java/lang/String.html` | `@https://checkerframework.org/api/org/checkerframework/checker/nullness/qual/EnsuresNonNull.html(value = [""#1""]) @https://checkerframework.org/api/org/checkerframework/dataflow/qual/Pure.html [checkNotEmpty](https://developer.android.com/reference/androidx/media3/common/util/Assertions#checkNotEmpty(java.lang.String,java.lang.Object))(@https://developer.android.com/reference/androidx/annotation/Nullable https://developer.android.com/reference/java/lang/String.html string, https://developer.android.com/reference/java/lang/Object.html errorMessage)` **This method is deprecated.** Use `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/base/Preconditions.html#checkArgument(boolean)` with `https://developer.android.com/reference/android/text/TextUtils.html#isEmpty(java.lang.CharSequence)` instead. <br /> |
| `static T` | `@https://checkerframework.org/api/org/checkerframework/checker/nullness/qual/EnsuresNonNull.html(value = [""#1""]) @https://checkerframework.org/api/org/checkerframework/dataflow/qual/Pure.html @https://checkerframework.org/api/com/google/errorprone/annotations/InlineMe.html(replacement = "Preconditions.checkNotNull(reference)", imports = "com.google.common.base.Preconditions") <T> [checkNotNull](https://developer.android.com/reference/androidx/media3/common/util/Assertions#checkNotNull(T))(@https://developer.android.com/reference/androidx/annotation/Nullable T reference)` **This method is deprecated.** Use `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/base/Preconditions.html#checkNotNull(T)` instead. <br /> |
| `static T` | `@https://checkerframework.org/api/org/checkerframework/checker/nullness/qual/EnsuresNonNull.html(value = [""#1""]) @https://checkerframework.org/api/org/checkerframework/dataflow/qual/Pure.html @https://checkerframework.org/api/com/google/errorprone/annotations/InlineMe.html(replacement = "Preconditions.checkNotNull(reference, errorMessage)", imports = "com.google.common.base.Preconditions") <T> [checkNotNull](https://developer.android.com/reference/androidx/media3/common/util/Assertions#checkNotNull(T,java.lang.Object))(@https://developer.android.com/reference/androidx/annotation/Nullable T reference, https://developer.android.com/reference/java/lang/Object.html errorMessage)` **This method is deprecated.** Use `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/base/Preconditions.html#checkNotNull(T)` instead. <br /> |
| `static void` | `@https://checkerframework.org/api/org/checkerframework/dataflow/qual/Pure.html @https://checkerframework.org/api/com/google/errorprone/annotations/InlineMe.html(replacement = "Preconditions.checkState(expression)", imports = "com.google.common.base.Preconditions") [checkState](https://developer.android.com/reference/androidx/media3/common/util/Assertions#checkState(boolean))(boolean expression)` **This method is deprecated.** Use `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/base/Preconditions.html#checkState(boolean)` instead. <br /> |
| `static void` | `@https://checkerframework.org/api/org/checkerframework/dataflow/qual/Pure.html @https://checkerframework.org/api/com/google/errorprone/annotations/InlineMe.html(replacement = "Preconditions.checkState(expression, errorMessage)", imports = "com.google.common.base.Preconditions") [checkState](https://developer.android.com/reference/androidx/media3/common/util/Assertions#checkState(boolean,java.lang.Object))(boolean expression, https://developer.android.com/reference/java/lang/Object.html errorMessage)` **This method is deprecated.** Use `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/base/Preconditions.html#checkState(boolean)` instead. <br /> |
| `static T` | `@https://checkerframework.org/api/org/checkerframework/checker/nullness/qual/EnsuresNonNull.html(value = [""#1""]) @https://checkerframework.org/api/org/checkerframework/dataflow/qual/Pure.html @https://checkerframework.org/api/com/google/errorprone/annotations/InlineMe.html(replacement = "Preconditions.checkNotNull(reference)", imports = "com.google.common.base.Preconditions") <T> [checkStateNotNull](https://developer.android.com/reference/androidx/media3/common/util/Assertions#checkStateNotNull(T))(@https://developer.android.com/reference/androidx/annotation/Nullable T reference)` **This method is deprecated.** Use `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/base/Preconditions.html#checkNotNull(T)` instead. <br /> |
| `static T` | `@https://checkerframework.org/api/org/checkerframework/checker/nullness/qual/EnsuresNonNull.html(value = [""#1""]) @https://checkerframework.org/api/org/checkerframework/dataflow/qual/Pure.html @https://checkerframework.org/api/com/google/errorprone/annotations/InlineMe.html(replacement = "Preconditions.checkNotNull(reference, errorMessage)", imports = "com.google.common.base.Preconditions") <T> [checkStateNotNull](https://developer.android.com/reference/androidx/media3/common/util/Assertions#checkStateNotNull(T,java.lang.Object))(@https://developer.android.com/reference/androidx/annotation/Nullable T reference, https://developer.android.com/reference/java/lang/Object.html errorMessage)` **This method is deprecated.** Use `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/base/Preconditions.html#checkNotNull(T)` instead. <br /> |

## Public methods

### checkArgument

```
@Pure
@InlineMe(replacement = "Preconditions.checkArgument(expression)", imports = "com.google.common.base.Preconditions")
public static void [checkArgument](https://developer.android.com/reference/androidx/media3/common/util/Assertions#checkArgument(boolean))(boolean expression)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> Use `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/base/Preconditions.html#checkArgument(boolean)` instead.

### checkArgument

```
@Pure
@InlineMe(replacement = "Preconditions.checkArgument(expression, errorMessage)", imports = "com.google.common.base.Preconditions")
public static void [checkArgument](https://developer.android.com/reference/androidx/media3/common/util/Assertions#checkArgument(boolean,java.lang.Object))(boolean expression, Object errorMessage)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> Use `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/base/Preconditions.html#checkArgument(boolean)` instead.

### checkIndex

```
@Pure
public static int [checkIndex](https://developer.android.com/reference/androidx/media3/common/util/Assertions#checkIndex(int,int,int))(int index, int start, int limit)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> Use `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/base/Preconditions.html#checkElementIndex(int, int)`, with an additional assertion to check a non-zero `start` value if needed.

### checkMainThread

```
@Pure
@InlineMe(replacement = "Preconditions.checkState(Looper.myLooper() == Looper.getMainLooper(), \"Not in"
              + " application's main thread\")", imports = [""com.google.common.base.Preconditions"", ""android.os.Looper""])
public static void [checkMainThread](https://developer.android.com/reference/androidx/media3/common/util/Assertions#checkMainThread())()
```

> [!CAUTION]
> **This method is deprecated.**   
>
> Use `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/base/Preconditions.html#checkState(boolean)` to assert `Looper.myLooper() ==
> Looper.getMainLooper()` instead.

### checkNotEmpty

```
@EnsuresNonNull(value = [""#1""])
@Pure
public static String [checkNotEmpty](https://developer.android.com/reference/androidx/media3/common/util/Assertions#checkNotEmpty(java.lang.String))(@Nullable String string)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> Use `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/base/Preconditions.html#checkArgument(boolean)` with `https://developer.android.com/reference/android/text/TextUtils.html#isEmpty(java.lang.CharSequence)` instead.

### checkNotEmpty

```
@EnsuresNonNull(value = [""#1""])
@Pure
public static String [checkNotEmpty](https://developer.android.com/reference/androidx/media3/common/util/Assertions#checkNotEmpty(java.lang.String,java.lang.Object))(@Nullable String string, Object errorMessage)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> Use `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/base/Preconditions.html#checkArgument(boolean)` with `https://developer.android.com/reference/android/text/TextUtils.html#isEmpty(java.lang.CharSequence)` instead.

### checkNotNull

```
@EnsuresNonNull(value = [""#1""])
@Pure
@InlineMe(replacement = "Preconditions.checkNotNull(reference)", imports = "com.google.common.base.Preconditions")
public static T <T> [checkNotNull](https://developer.android.com/reference/androidx/media3/common/util/Assertions#checkNotNull(T))(@Nullable T reference)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> Use `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/base/Preconditions.html#checkNotNull(T)` instead.

### checkNotNull

```
@EnsuresNonNull(value = [""#1""])
@Pure
@InlineMe(replacement = "Preconditions.checkNotNull(reference, errorMessage)", imports = "com.google.common.base.Preconditions")
public static T <T> [checkNotNull](https://developer.android.com/reference/androidx/media3/common/util/Assertions#checkNotNull(T,java.lang.Object))(@Nullable T reference, Object errorMessage)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> Use `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/base/Preconditions.html#checkNotNull(T)` instead.

### checkState

```
@Pure
@InlineMe(replacement = "Preconditions.checkState(expression)", imports = "com.google.common.base.Preconditions")
public static void [checkState](https://developer.android.com/reference/androidx/media3/common/util/Assertions#checkState(boolean))(boolean expression)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> Use `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/base/Preconditions.html#checkState(boolean)` instead.

### checkState

```
@Pure
@InlineMe(replacement = "Preconditions.checkState(expression, errorMessage)", imports = "com.google.common.base.Preconditions")
public static void [checkState](https://developer.android.com/reference/androidx/media3/common/util/Assertions#checkState(boolean,java.lang.Object))(boolean expression, Object errorMessage)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> Use `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/base/Preconditions.html#checkState(boolean)` instead.

### checkStateNotNull

```
@EnsuresNonNull(value = [""#1""])
@Pure
@InlineMe(replacement = "Preconditions.checkNotNull(reference)", imports = "com.google.common.base.Preconditions")
public static T <T> [checkStateNotNull](https://developer.android.com/reference/androidx/media3/common/util/Assertions#checkStateNotNull(T))(@Nullable T reference)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> Use `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/base/Preconditions.html#checkNotNull(T)` instead.

### checkStateNotNull

```
@EnsuresNonNull(value = [""#1""])
@Pure
@InlineMe(replacement = "Preconditions.checkNotNull(reference, errorMessage)", imports = "com.google.common.base.Preconditions")
public static T <T> [checkStateNotNull](https://developer.android.com/reference/androidx/media3/common/util/Assertions#checkStateNotNull(T,java.lang.Object))(@Nullable T reference, Object errorMessage)
```

> [!CAUTION]
> **This method is deprecated.**   
>
> Use `https://guava.dev/releases/snapshot-android/api/docs/com/google/common/base/Preconditions.html#checkNotNull(T)` instead.