Util (library-core API)

java.lang.Object
- com.google.android.exoplayer2.util.Util

public final class Util
extends java.lang.Object

Miscellaneous utility methods.

Field Summary

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`DEVICE` Like `Build.DEVICE`, but in a place where it can be conveniently overridden for local testing.
`static java.lang.String`	`DEVICE_DEBUG_INFO` A concise description of the device that it can be useful to log for debugging purposes.
`static byte[]`	`EMPTY_BYTE_ARRAY` An empty byte array.
`static java.lang.String`	`MANUFACTURER` Like `Build.MANUFACTURER`, but in a place where it can be conveniently overridden for local testing.
`static java.lang.String`	`MODEL` Like `Build.MODEL`, but in a place where it can be conveniently overridden for local testing.
`static int`	`SDK_INT` Like `Build.VERSION.SDK_INT`, but in a place where it can be conveniently overridden for local testing.

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static long`	`addWithOverflowDefault(long x, long y, long overflowResult)` Returns the sum of two arguments, or a third argument if the result overflows.
`static boolean`	`areEqual(java.lang.Object o1, java.lang.Object o2)` Tests two objects for `Object.equals(Object)` equality, handling the case where one or both may be null.
`static <T extends java.lang.Comparable<? super T>> int`	`binarySearchCeil(java.util.List<? extends java.lang.Comparable<? super T>> list, T value, boolean inclusive, boolean stayInBounds)` Returns the index of the smallest element in `list` that is greater than (or optionally equal to) a specified value.
`static int`	`binarySearchCeil(long[] array, long value, boolean inclusive, boolean stayInBounds)` Returns the index of the smallest element in `array` that is greater than (or optionally equal to) a specified `value`.
`static int`	`binarySearchFloor(int[] array, int value, boolean inclusive, boolean stayInBounds)` Returns the index of the largest element in `array` that is less than (or optionally equal to) a specified `value`.
`static <T extends java.lang.Comparable<? super T>> int`	`binarySearchFloor(java.util.List<? extends java.lang.Comparable<? super T>> list, T value, boolean inclusive, boolean stayInBounds)` Returns the index of the largest element in `list` that is less than (or optionally equal to) a specified `value`.
`static int`	`binarySearchFloor(long[] array, long value, boolean inclusive, boolean stayInBounds)` Returns the index of the largest element in `array` that is less than (or optionally equal to) a specified `value`.
`static <T> T`	`castNonNull(T value)` Casts a nullable variable to a non-null variable without runtime null check.
`static <T> T[]`	`castNonNullTypeArray(T[] value)` Casts a nullable type array to a non-null type array without runtime null check.
`static int`	`ceilDivide(int numerator, int denominator)` Divides a `numerator` by a `denominator`, returning the ceiled result.
`static long`	`ceilDivide(long numerator, long denominator)` Divides a `numerator` by a `denominator`, returning the ceiled result.
`static boolean`	`checkCleartextTrafficPermitted(android.net.Uri... uris)` Returns whether it may be possible to load the given URIs based on the network security policy's cleartext traffic permissions.
`static void`	`closeQuietly(java.io.Closeable closeable)` Closes a `Closeable`, suppressing any `IOException` that may occur.
`static void`	`closeQuietly(DataSource dataSource)` Closes a `DataSource`, suppressing any `IOException` that may occur.
`static int`	`compareLong(long left, long right)` Compares two long values and returns the same value as `Long.compare(long, long)`.
`static float`	`constrainValue(float value, float min, float max)` Constrains a value to the specified bounds.
`static int`	`constrainValue(int value, int min, int max)` Constrains a value to the specified bounds.
`static long`	`constrainValue(long value, long min, long max)` Constrains a value to the specified bounds.
`static boolean`	`contains(java.lang.Object[] items, java.lang.Object item)` Tests whether an `items` array contains an object equal to `item`, according to `Object.equals(Object)`.
`static int`	`crc(byte[] bytes, int start, int end, int initialValue)` Returns the result of updating a CRC with the specified bytes in a "most significant bit first" order.
`static android.os.Handler`	`createHandler(android.os.Handler.Callback callback)` Creates a `Handler` with the specified `Handler.Callback` on the current `Looper` thread.
`static android.os.Handler`	`createHandler(android.os.Looper looper, android.os.Handler.Callback callback)` Creates a `Handler` with the specified `Handler.Callback` on the specified `Looper` thread.
`static java.io.File`	`createTempDirectory(android.content.Context context, java.lang.String prefix)` Creates an empty directory in the directory returned by `Context.getCacheDir()`.
`static java.io.File`	`createTempFile(android.content.Context context, java.lang.String prefix)` Creates a new empty file in the directory returned by `Context.getCacheDir()`.
`static java.lang.String`	`escapeFileName(java.lang.String fileName)` Escapes a string so that it's safe for use as a file or directory name on at least FAT32 filesystems.
`static java.lang.String`	`formatInvariant(java.lang.String format, java.lang.Object... args)` Formats a string using `Locale.US`.
`static java.lang.String`	`fromUtf8Bytes(byte[] bytes)` Returns a new `String` constructed by decoding UTF-8 encoded bytes.
`static java.lang.String`	`fromUtf8Bytes(byte[] bytes, int offset, int length)` Returns a new `String` constructed by decoding UTF-8 encoded bytes in a subarray.
`static int`	`getAudioContentTypeForStreamType(int streamType)` Returns the `C.AudioContentType` corresponding to the specified `C.StreamType`.
`static int`	`getAudioTrackChannelConfig(int channelCount)` Returns the audio track channel configuration for the given channel count, or `AudioFormat.CHANNEL_INVALID` if output is not poossible.
`static int`	`getAudioUsageForStreamType(int streamType)` Returns the `C.AudioUsage` corresponding to the specified `C.StreamType`.
`static byte[]`	`getBytesFromHexString(java.lang.String hexString)` Returns a byte array containing values parsed from the hex string provided.
`static java.lang.String`	`getCodecsOfType(java.lang.String codecs, int trackType)` Returns a copy of `codecs` without the codecs whose track type doesn't match `trackType`.
`static java.lang.String`	`getCommaDelimitedSimpleClassNames(java.lang.Object[] objects)` Returns a string with comma delimited simple names of each object's class.
`static java.lang.String`	`getCountryCode(android.content.Context context)` Returns the upper-case ISO 3166-1 alpha-2 country code of the current registered operator's MCC (Mobile Country Code), or the country code of the default Locale if not available.
`static int`	`getDefaultBufferSize(int trackType)` Maps a `C` `TRACK_TYPE_` constant to the corresponding `C` `DEFAULT__BUFFER_SIZE` constant.
`static java.util.UUID`	`getDrmUuid(java.lang.String drmScheme)` Derives a DRM `UUID` from `drmScheme`.
`static int`	`getIntegerCodeForString(java.lang.String string)` Returns the integer equal to the big-endian concatenation of the characters in `string` as bytes.
`static android.os.Looper`	`getLooper()` Returns the `Looper` associated with the current thread, or the `Looper` of the application's main thread if the current thread doesn't have a `Looper`.
`static long`	`getMediaDurationForPlayoutDuration(long playoutDuration, float speed)` Returns the duration of media that will elapse in `playoutDuration`.
`static int`	`getNetworkType(android.content.Context context)` Returns the `C.NetworkType` of the current network connection.
`static int`	`getPcmEncoding(int bitDepth)` Converts a sample bit depth to a corresponding PCM encoding constant.
`static int`	`getPcmFrameSize(int pcmEncoding, int channelCount)` Returns the frame size for audio with `channelCount` channels in the specified encoding.
`static android.graphics.Point`	`getPhysicalDisplaySize(android.content.Context context)` Gets the physical size of the default display, in pixels.
`static android.graphics.Point`	`getPhysicalDisplaySize(android.content.Context context, android.view.Display display)` Gets the physical size of the specified display, in pixels.
`static long`	`getPlayoutDurationForMediaDuration(long mediaDuration, float speed)` Returns the playout duration of `mediaDuration` of media.
`static int`	`getStreamTypeForAudioUsage(int usage)` Returns the `C.StreamType` corresponding to the specified `C.AudioUsage`.
`static java.lang.String`	`getStringForTime(java.lang.StringBuilder builder, java.util.Formatter formatter, long timeMs)` Returns the specified millisecond time formatted as a string.
`static java.lang.String`	`getUserAgent(android.content.Context context, java.lang.String applicationName)` Returns a user agent string based on the given application name and the library version.
`static byte[]`	`getUtf8Bytes(java.lang.String value)` Returns a new byte array containing the code points of a `String` encoded using UTF-8.
`static int`	`inferContentType(java.lang.String fileName)` Makes a best guess to infer the type from a file name.
`static int`	`inferContentType(android.net.Uri uri)` Makes a best guess to infer the type from a `Uri`.
`static int`	`inferContentType(android.net.Uri uri, java.lang.String overrideExtension)` Makes a best guess to infer the type from a `Uri`.
`static boolean`	`inflate(ParsableByteArray input, ParsableByteArray output, java.util.zip.Inflater inflater)` Uncompresses the data in `input`.
`static boolean`	`isEncodingHighResolutionIntegerPcm(int encoding)` Returns whether `encoding` is high resolution (> 16-bit) integer PCM.
`static boolean`	`isEncodingLinearPcm(int encoding)` Returns whether `encoding` is one of the linear PCM encodings.
`static boolean`	`isLinebreak(int c)` Returns whether the given character is a carriage return ('\r') or a line feed ('\n').
`static boolean`	`isLocalFileUri(android.net.Uri uri)` Returns true if the URI is a path to a local file or a reference to a local file.
`static boolean`	`maybeRequestReadExternalStoragePermission(android.app.Activity activity, android.net.Uri... uris)` Checks whether it's necessary to request the `Manifest.permission.READ_EXTERNAL_STORAGE` permission read the specified `Uri`s, requesting the permission if necessary.
`static java.util.concurrent.ExecutorService`	`newSingleThreadExecutor(java.lang.String threadName)` Instantiates a new single threaded executor whose thread has the specified name.
`static java.lang.String`	`normalizeLanguageCode(java.lang.String language)` Returns a normalized RFC 639-2/T code for `language`.
`static <T> T[]`	`nullSafeArrayCopy(T[] input, int length)` Copies and optionally truncates an array.
`static long`	`parseXsDateTime(java.lang.String value)` Parses an xs:dateTime attribute value, returning the parsed timestamp in milliseconds since the epoch.
`static long`	`parseXsDuration(java.lang.String value)` Parses an xs:duration attribute value, returning the parsed duration in milliseconds.
`static boolean`	`readBoolean(android.os.Parcel parcel)` Reads an integer from a `Parcel` and interprets it as a boolean, with 0 mapping to false and all other values mapping to true.
`static void`	`recursiveDelete(java.io.File fileOrDirectory)` Recursively deletes a directory and its content.
`static <T> void`	`removeRange(java.util.List<T> list, int fromIndex, int toIndex)` Removes an indexed range from a List.
`static long`	`resolveSeekPositionUs(long positionUs, SeekParameters seekParameters, long firstSyncUs, long secondSyncUs)` Resolves a seek given the requested seek position, a `SeekParameters` and two candidate sync points.
`static long`	`scaleLargeTimestamp(long timestamp, long multiplier, long divisor)` Scales a large timestamp.
`static long[]`	`scaleLargeTimestamps(java.util.List<java.lang.Long> timestamps, long multiplier, long divisor)` Applies `scaleLargeTimestamp(long, long, long)` to a list of unscaled timestamps.
`static void`	`scaleLargeTimestampsInPlace(long[] timestamps, long multiplier, long divisor)` Applies `scaleLargeTimestamp(long, long, long)` to an array of unscaled timestamps.
`static void`	`sneakyThrow(java.lang.Throwable t)` A hacky method that always throws `t` even if `t` is a checked exception, and is not declared to be thrown.
`static java.lang.String[]`	`split(java.lang.String value, java.lang.String regex)` Splits a string using `value.split(regex, -1`).
`static java.lang.String[]`	`splitAtFirst(java.lang.String value, java.lang.String regex)` Splits the string at the first occurrence of the delimiter `regex`.
`static java.lang.String[]`	`splitCodecs(java.lang.String codecs)` Splits a codecs sequence string, as defined in RFC 6381, into individual codec strings.
`static android.content.ComponentName`	`startForegroundService(android.content.Context context, android.content.Intent intent)` Calls `Context.startForegroundService(Intent)` if `SDK_INT` is 26 or higher, or `Context.startService(Intent)` otherwise.
`static long`	`subtractWithOverflowDefault(long x, long y, long overflowResult)` Returns the difference between two arguments, or a third argument if the result overflows.
`static int[]`	`toArray(@PolyNull java.util.List<java.lang.Integer> list)` Converts a list of integers to a primitive array.
`static byte[]`	`toByteArray(java.io.InputStream inputStream)` Converts the entirety of an `InputStream` to a byte array.
`static @PolyNull java.lang.String`	`toLowerInvariant(@PolyNull java.lang.String text)` Converts text to lower case using `Locale.US`.
`static @PolyNull java.lang.String`	`toUpperInvariant(@PolyNull java.lang.String text)` Converts text to upper case using `Locale.US`.
`static java.lang.String`	`unescapeFileName(java.lang.String fileName)` Unescapes an escaped file or directory name back to its original value.
`static void`	`writeBoolean(android.os.Parcel parcel, boolean value)` Writes a boolean to a `Parcel`.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - SDK_INT
```
public static final int SDK_INT
```
    Like Build.VERSION.SDK_INT, but in a place where it can be conveniently overridden for local testing.
  - DEVICE
```
public static final java.lang.String DEVICE
```
    Like Build.DEVICE, but in a place where it can be conveniently overridden for local testing.
  - MANUFACTURER
```
public static final java.lang.String MANUFACTURER
```
    Like Build.MANUFACTURER, but in a place where it can be conveniently overridden for local testing.
  - MODEL
```
public static final java.lang.String MODEL
```
    Like Build.MODEL, but in a place where it can be conveniently overridden for local testing.
  - DEVICE_DEBUG_INFO
```
public static final java.lang.String DEVICE_DEBUG_INFO
```
    A concise description of the device that it can be useful to log for debugging purposes.
  - EMPTY_BYTE_ARRAY
```
public static final byte[] EMPTY_BYTE_ARRAY
```
    An empty byte array.
- Method Detail
  - toByteArray
```
public static byte[] toByteArray(java.io.InputStream inputStream)
                          throws java.io.IOException
```
    Converts the entirety of an InputStream to a byte array.
    
    Parameters:
    
    inputStream - the InputStream to be read. The input stream is not closed by this method.
    
    Returns:
    
    a byte array containing all of the inputStream's bytes.
    
    Throws:
    
    java.io.IOException - if an error occurs reading from the stream.
  - startForegroundService
```
public static android.content.ComponentName startForegroundService(android.content.Context context,
                                                                   android.content.Intent intent)
```
    Calls Context.startForegroundService(Intent) if SDK_INT is 26 or higher, or Context.startService(Intent) otherwise.
    
    Parameters:
    
    context - The context to call.
    
    intent - The intent to pass to the called method.
    
    Returns:
    
    The result of the called method.
  - maybeRequestReadExternalStoragePermission
```
public static boolean maybeRequestReadExternalStoragePermission(android.app.Activity activity,
                                                                android.net.Uri... uris)
```
    Checks whether it's necessary to request the Manifest.permission.READ_EXTERNAL_STORAGE permission read the specified Uris, requesting the permission if necessary.
    
    Parameters:
    
    activity - The host activity for checking and requesting the permission.
    
    uris - Uris that may require Manifest.permission.READ_EXTERNAL_STORAGE to read.
    
    Returns:
    
    Whether a permission request was made.
  - checkCleartextTrafficPermitted
```
public static boolean checkCleartextTrafficPermitted(android.net.Uri... uris)
```
    Returns whether it may be possible to load the given URIs based on the network security policy's cleartext traffic permissions.
    
    Parameters:
    
    uris - A list of URIs that will be loaded.
    
    Returns:
    
    Whether it may be possible to load the given URIs.
  - isLocalFileUri
```
public static boolean isLocalFileUri(android.net.Uri uri)
```
    Returns true if the URI is a path to a local file or a reference to a local file.
    
    Parameters:
    
    uri - The uri to test.
  - areEqual
```
public static boolean areEqual(@Nullable
                               java.lang.Object o1,
                               @Nullable
                               java.lang.Object o2)
```
    Tests two objects for Object.equals(Object) equality, handling the case where one or both may be null.
    
    Parameters:
    
    o1 - The first object.
    
    o2 - The second object.
    
    Returns:
    
    o1 == null ? o2 == null : o1.equals(o2).
  - contains
```
public static boolean contains(java.lang.Object[] items,
                               java.lang.Object item)
```
    Tests whether an items array contains an object equal to item, according to Object.equals(Object).
    If item is null then true is returned if and only if items contains null.
    
    Parameters:
    
    items - The array of items to search.
    
    item - The item to search for.
    
    Returns:
    
    True if the array contains an object equal to the item being searched for.
  - removeRange
```
public static <T> void removeRange(java.util.List<T> list,
                                   int fromIndex,
                                   int toIndex)
```
    Removes an indexed range from a List.
    Does nothing if the provided range is valid and fromIndex == toIndex.
    
    Parameters:
    
    list - The List to remove the range from.
    
    fromIndex - The first index to be removed (inclusive).
    
    toIndex - The last index to be removed (exclusive).
    
    Throws:
    
    java.lang.IllegalArgumentException - If fromIndex < 0, toIndex > list.size(), or fromIndex > toIndex.
  - castNonNull
```
@EnsuresNonNull(value="#1")
public static <T> T castNonNull(@Nullable
                                                            T value)
```
    Casts a nullable variable to a non-null variable without runtime null check.
    Use Assertions.checkNotNull(Object) to throw if the value is null.
  - castNonNullTypeArray
```
@EnsuresNonNull(value="#1")
public static <T> T[] castNonNullTypeArray(T[] value)
```
    Casts a nullable type array to a non-null type array without runtime null check.
  - nullSafeArrayCopy
```
public static <T> T[] nullSafeArrayCopy(T[] input,
                                        int length)
```
    Copies and optionally truncates an array. Prevents null array elements created by Arrays.copyOf(Object[], int) by ensuring the new length does not exceed the current length.
    
    Parameters:
    
    input - The input array.
    
    length - The output array length. Must be less or equal to the length of the input array.
    
    Returns:
    
    The copied array.
  - createHandler
```
public static android.os.Handler createHandler(android.os.Handler.Callback callback)
```
    Creates a Handler with the specified Handler.Callback on the current Looper thread. The method accepts partially initialized objects as callback under the assumption that the Handler won't be used to send messages until the callback is fully initialized.
    If the current thread doesn't have a Looper, the application's main thread Looper is used.
    
    Parameters:
    
    callback - A Handler.Callback. May be a partially initialized class.
    
    Returns:
    
    A Handler with the specified callback on the current Looper thread.
  - createHandler
```
public static android.os.Handler createHandler(android.os.Looper looper,
                                               android.os.Handler.Callback callback)
```
    Creates a Handler with the specified Handler.Callback on the specified Looper thread. The method accepts partially initialized objects as callback under the assumption that the Handler won't be used to send messages until the callback is fully initialized.
    
    Parameters:
    
    looper - A Looper to run the callback on.
    
    callback - A Handler.Callback. May be a partially initialized class.
    
    Returns:
    
    A Handler with the specified callback on the current Looper thread.
  - getLooper
```
public static android.os.Looper getLooper()
```
    Returns the Looper associated with the current thread, or the Looper of the application's main thread if the current thread doesn't have a Looper.
  - newSingleThreadExecutor
```
public static java.util.concurrent.ExecutorService newSingleThreadExecutor(java.lang.String threadName)
```
    Instantiates a new single threaded executor whose thread has the specified name.
    
    Parameters:
    
    threadName - The name of the thread.
    
    Returns:
    
    The executor.
  - closeQuietly
```
public static void closeQuietly(DataSource dataSource)
```
    Closes a DataSource, suppressing any IOException that may occur.
    
    Parameters:
    
    dataSource - The DataSource to close.
  - closeQuietly
```
public static void closeQuietly(java.io.Closeable closeable)
```
    Closes a Closeable, suppressing any IOException that may occur. Both OutputStream and InputStream are Closeable.
    
    Parameters:
    
    closeable - The Closeable to close.
  - readBoolean
```
public static boolean readBoolean(android.os.Parcel parcel)
```
    Reads an integer from a Parcel and interprets it as a boolean, with 0 mapping to false and all other values mapping to true.
    
    Parameters:
    
    parcel - The Parcel to read from.
    
    Returns:
    
    The read value.
  - writeBoolean
```
public static void writeBoolean(android.os.Parcel parcel,
                                boolean value)
```
    Writes a boolean to a Parcel. The boolean is written as an integer with value 1 (true) or 0 (false).
    
    Parameters:
    
    parcel - The Parcel to write to.
    
    value - The value to write.
  - normalizeLanguageCode
```
@Nullable
public static java.lang.String normalizeLanguageCode(@Nullable
                                                               java.lang.String language)
```
    Returns a normalized RFC 639-2/T code for language.
    
    Parameters:
    
    language - A case-insensitive ISO 639 alpha-2 or alpha-3 language code.
    
    Returns:
    
    The all-lowercase normalized code, or null if the input was null, or language.toLowerCase() if the language could not be normalized.
  - fromUtf8Bytes
```
public static java.lang.String fromUtf8Bytes(byte[] bytes)
```
    Returns a new String constructed by decoding UTF-8 encoded bytes.
    
    Parameters:
    
    bytes - The UTF-8 encoded bytes to decode.
    
    Returns:
    
    The string.
  - fromUtf8Bytes
```
public static java.lang.String fromUtf8Bytes(byte[] bytes,
                                             int offset,
                                             int length)
```
    Returns a new String constructed by decoding UTF-8 encoded bytes in a subarray.
    
    Parameters:
    
    bytes - The UTF-8 encoded bytes to decode.
    
    offset - The index of the first byte to decode.
    
    length - The number of bytes to decode.
    
    Returns:
    
    The string.
  - getUtf8Bytes
```
public static byte[] getUtf8Bytes(java.lang.String value)
```
    Returns a new byte array containing the code points of a String encoded using UTF-8.
    
    Parameters:
    
    value - The String whose bytes should be obtained.
    
    Returns:
    
    The code points encoding using UTF-8.
  - split
```
public static java.lang.String[] split(java.lang.String value,
                                       java.lang.String regex)
```
    Splits a string using value.split(regex, -1). Note: this is is similar to String.split(String) but empty matches at the end of the string will not be omitted from the returned array.
    
    Parameters:
    
    value - The string to split.
    
    regex - A delimiting regular expression.
    
    Returns:
    
    The array of strings resulting from splitting the string.
  - splitAtFirst
```
public static java.lang.String[] splitAtFirst(java.lang.String value,
                                              java.lang.String regex)
```
    Splits the string at the first occurrence of the delimiter regex. If the delimiter does not match, returns an array with one element which is the input string. If the delimiter does match, returns an array with the portion of the string before the delimiter and the rest of the string.
    
    Parameters:
    
    value - The string.
    
    regex - A delimiting regular expression.
    
    Returns:
    
    The string split by the first occurrence of the delimiter.
  - isLinebreak
```
public static boolean isLinebreak(int c)
```
    Returns whether the given character is a carriage return ('\r') or a line feed ('\n').
    
    Parameters:
    
    c - The character.
    
    Returns:
    
    Whether the given character is a linebreak.
  - toLowerInvariant
```
public static @PolyNull java.lang.String toLowerInvariant(@PolyNull java.lang.String text)
```
    Converts text to lower case using Locale.US.
    
    Parameters:
    
    text - The text to convert.
    
    Returns:
    
    The lower case text, or null if text is null.
  - toUpperInvariant
```
public static @PolyNull java.lang.String toUpperInvariant(@PolyNull java.lang.String text)
```
    Converts text to upper case using Locale.US.
    
    Parameters:
    
    text - The text to convert.
    
    Returns:
    
    The upper case text, or null if text is null.
  - formatInvariant
```
public static java.lang.String formatInvariant(java.lang.String format,
                                               java.lang.Object... args)
```
    Formats a string using Locale.US.
    
    See Also:
    
    String.format(String, Object...)
  - ceilDivide
```
public static int ceilDivide(int numerator,
                             int denominator)
```
    Divides a numerator by a denominator, returning the ceiled result.
    
    Parameters:
    
    numerator - The numerator to divide.
    
    denominator - The denominator to divide by.
    
    Returns:
    
    The ceiled result of the division.
  - ceilDivide
```
public static long ceilDivide(long numerator,
                              long denominator)
```
    Divides a numerator by a denominator, returning the ceiled result.
    
    Parameters:
    
    numerator - The numerator to divide.
    
    denominator - The denominator to divide by.
    
    Returns:
    
    The ceiled result of the division.
  - constrainValue
```
public static int constrainValue(int value,
                                 int min,
                                 int max)
```
    Constrains a value to the specified bounds.
    
    Parameters:
    
    value - The value to constrain.
    
    min - The lower bound.
    
    max - The upper bound.
    
    Returns:
    
    The constrained value Math.max(min, Math.min(value, max)).
  - constrainValue
```
public static long constrainValue(long value,
                                  long min,
                                  long max)
```
    Constrains a value to the specified bounds.
    
    Parameters:
    
    value - The value to constrain.
    
    min - The lower bound.
    
    max - The upper bound.
    
    Returns:
    
    The constrained value Math.max(min, Math.min(value, max)).
  - constrainValue
```
public static float constrainValue(float value,
                                   float min,
                                   float max)
```
    Constrains a value to the specified bounds.
    
    Parameters:
    
    value - The value to constrain.
    
    min - The lower bound.
    
    max - The upper bound.
    
    Returns:
    
    The constrained value Math.max(min, Math.min(value, max)).
  - addWithOverflowDefault
```
public static long addWithOverflowDefault(long x,
                                          long y,
                                          long overflowResult)
```
    Returns the sum of two arguments, or a third argument if the result overflows.
    
    Parameters:
    
    x - The first value.
    
    y - The second value.
    
    overflowResult - The return value if x + y overflows.
    
    Returns:
    
    x + y, or overflowResult if the result overflows.
  - subtractWithOverflowDefault
```
public static long subtractWithOverflowDefault(long x,
                                               long y,
                                               long overflowResult)
```
    Returns the difference between two arguments, or a third argument if the result overflows.
    
    Parameters:
    
    x - The first value.
    
    y - The second value.
    
    overflowResult - The return value if x - y overflows.
    
    Returns:
    
    x - y, or overflowResult if the result overflows.
  - binarySearchFloor
```
public static int binarySearchFloor(int[] array,
                                    int value,
                                    boolean inclusive,
                                    boolean stayInBounds)
```
    Returns the index of the largest element in array that is less than (or optionally equal to) a specified value.
    The search is performed using a binary search algorithm, so the array must be sorted. If the array contains multiple elements equal to value and inclusive is true, the index of the first one will be returned.
    
    Parameters:
    
    array - The array to search.
    
    value - The value being searched for.
    
    inclusive - If the value is present in the array, whether to return the corresponding index. If false then the returned index corresponds to the largest element strictly less than the value.
    
    stayInBounds - If true, then 0 will be returned in the case that the value is smaller than the smallest element in the array. If false then -1 will be returned.
    
    Returns:
    
    The index of the largest element in array that is less than (or optionally equal to) value.
  - binarySearchFloor
```
public static int binarySearchFloor(long[] array,
                                    long value,
                                    boolean inclusive,
                                    boolean stayInBounds)
```
    Returns the index of the largest element in array that is less than (or optionally equal to) a specified value.
    The search is performed using a binary search algorithm, so the array must be sorted. If the array contains multiple elements equal to value and inclusive is true, the index of the first one will be returned.
    
    Parameters:
    
    array - The array to search.
    
    value - The value being searched for.
    
    inclusive - If the value is present in the array, whether to return the corresponding index. If false then the returned index corresponds to the largest element strictly less than the value.
    
    stayInBounds - If true, then 0 will be returned in the case that the value is smaller than the smallest element in the array. If false then -1 will be returned.
    
    Returns:
    
    The index of the largest element in array that is less than (or optionally equal to) value.
  - binarySearchFloor
```
public static <T extends java.lang.Comparable<? super T>> int binarySearchFloor(java.util.List<? extends java.lang.Comparable<? super T>> list,
                                                                                T value,
                                                                                boolean inclusive,
                                                                                boolean stayInBounds)
```
    Returns the index of the largest element in list that is less than (or optionally equal to) a specified value.
    The search is performed using a binary search algorithm, so the list must be sorted. If the list contains multiple elements equal to value and inclusive is true, the index of the first one will be returned.
    
    Type Parameters:
    
    T - The type of values being searched.
    
    Parameters:
    
    list - The list to search.
    
    value - The value being searched for.
    
    inclusive - If the value is present in the list, whether to return the corresponding index. If false then the returned index corresponds to the largest element strictly less than the value.
    
    stayInBounds - If true, then 0 will be returned in the case that the value is smaller than the smallest element in the list. If false then -1 will be returned.
    
    Returns:
    
    The index of the largest element in list that is less than (or optionally equal to) value.
  - binarySearchCeil
```
public static int binarySearchCeil(long[] array,
                                   long value,
                                   boolean inclusive,
                                   boolean stayInBounds)
```
    Returns the index of the smallest element in array that is greater than (or optionally equal to) a specified value.
    The search is performed using a binary search algorithm, so the array must be sorted. If the array contains multiple elements equal to value and inclusive is true, the index of the last one will be returned.
    
    Parameters:
    
    array - The array to search.
    
    value - The value being searched for.
    
    inclusive - If the value is present in the array, whether to return the corresponding index. If false then the returned index corresponds to the smallest element strictly greater than the value.
    
    stayInBounds - If true, then (a.length - 1) will be returned in the case that the value is greater than the largest element in the array. If false then a.length will be returned.
    
    Returns:
    
    The index of the smallest element in array that is greater than (or optionally equal to) value.
  - binarySearchCeil
```
public static <T extends java.lang.Comparable<? super T>> int binarySearchCeil(java.util.List<? extends java.lang.Comparable<? super T>> list,
                                                                               T value,
                                                                               boolean inclusive,
                                                                               boolean stayInBounds)
```
    Returns the index of the smallest element in list that is greater than (or optionally equal to) a specified value.
    The search is performed using a binary search algorithm, so the list must be sorted. If the list contains multiple elements equal to value and inclusive is true, the index of the last one will be returned.
    
    Type Parameters:
    
    T - The type of values being searched.
    
    Parameters:
    
    list - The list to search.
    
    value - The value being searched for.
    
    inclusive - If the value is present in the list, whether to return the corresponding index. If false then the returned index corresponds to the smallest element strictly greater than the value.
    
    stayInBounds - If true, then (list.size() - 1) will be returned in the case that the value is greater than the largest element in the list. If false then list.size() will be returned.
    
    Returns:
    
    The index of the smallest element in list that is greater than (or optionally equal to) value.
  - compareLong
```
public static int compareLong(long left,
                              long right)
```
    Compares two long values and returns the same value as Long.compare(long, long).
    
    Parameters:
    
    left - The left operand.
    
    right - The right operand.
    
    Returns:
    
    0, if left == right, a negative value if left < right, or a positive value if left > right.
  - parseXsDuration
```
public static long parseXsDuration(java.lang.String value)
```
    Parses an xs:duration attribute value, returning the parsed duration in milliseconds.
    
    Parameters:
    
    value - The attribute value to decode.
    
    Returns:
    
    The parsed duration in milliseconds.
  - parseXsDateTime
```
public static long parseXsDateTime(java.lang.String value)
                            throws ParserException
```
    Parses an xs:dateTime attribute value, returning the parsed timestamp in milliseconds since the epoch.
    
    Parameters:
    
    value - The attribute value to decode.
    
    Returns:
    
    The parsed timestamp in milliseconds since the epoch.
    
    Throws:
    
    ParserException - if an error occurs parsing the dateTime attribute value.
  - scaleLargeTimestamp
```
public static long scaleLargeTimestamp(long timestamp,
                                       long multiplier,
                                       long divisor)
```
    Scales a large timestamp.
    Logically, scaling consists of a multiplication followed by a division. The actual operations performed are designed to minimize the probability of overflow.
    
    Parameters:
    
    timestamp - The timestamp to scale.
    
    multiplier - The multiplier.
    
    divisor - The divisor.
    
    Returns:
    
    The scaled timestamp.
  - scaleLargeTimestamps
```
public static long[] scaleLargeTimestamps(java.util.List<java.lang.Long> timestamps,
                                          long multiplier,
                                          long divisor)
```
    Applies scaleLargeTimestamp(long, long, long) to a list of unscaled timestamps.
    
    Parameters:
    
    timestamps - The timestamps to scale.
    
    multiplier - The multiplier.
    
    divisor - The divisor.
    
    Returns:
    
    The scaled timestamps.
  - scaleLargeTimestampsInPlace
```
public static void scaleLargeTimestampsInPlace(long[] timestamps,
                                               long multiplier,
                                               long divisor)
```
    Applies scaleLargeTimestamp(long, long, long) to an array of unscaled timestamps.
    
    Parameters:
    
    timestamps - The timestamps to scale.
    
    multiplier - The multiplier.
    
    divisor - The divisor.
  - getMediaDurationForPlayoutDuration
```
public static long getMediaDurationForPlayoutDuration(long playoutDuration,
                                                      float speed)
```
    Returns the duration of media that will elapse in playoutDuration.
    
    Parameters:
    
    playoutDuration - The duration to scale.
    
    speed - The playback speed.
    
    Returns:
    
    The scaled duration, in the same units as playoutDuration.
  - getPlayoutDurationForMediaDuration
```
public static long getPlayoutDurationForMediaDuration(long mediaDuration,
                                                      float speed)
```
    Returns the playout duration of mediaDuration of media.
    
    Parameters:
    
    mediaDuration - The duration to scale.
    
    Returns:
    
    The scaled duration, in the same units as mediaDuration.
  - resolveSeekPositionUs
```
public static long resolveSeekPositionUs(long positionUs,
                                         SeekParameters seekParameters,
                                         long firstSyncUs,
                                         long secondSyncUs)
```
    Resolves a seek given the requested seek position, a SeekParameters and two candidate sync points.
    
    Parameters:
    
    positionUs - The requested seek position, in microseocnds.
    
    seekParameters - The SeekParameters.
    
    firstSyncUs - The first candidate seek point, in micrseconds.
    
    secondSyncUs - The second candidate seek point, in microseconds. May equal firstSyncUs if there's only one candidate.
    
    Returns:
    
    The resolved seek position, in microseconds.
  - toArray
```
public static int[] toArray(@PolyNull java.util.List<java.lang.Integer> list)
```
    Converts a list of integers to a primitive array.
    
    Parameters:
    
    list - A list of integers.
    
    Returns:
    
    The list in array form, or null if the input list was null.
  - getIntegerCodeForString
```
public static int getIntegerCodeForString(java.lang.String string)
```
    Returns the integer equal to the big-endian concatenation of the characters in string as bytes. The string must be no more than four characters long.
    
    Parameters:
    
    string - A string no more than four characters long.
  - getBytesFromHexString
```
public static byte[] getBytesFromHexString(java.lang.String hexString)
```
    Returns a byte array containing values parsed from the hex string provided.
    
    Parameters:
    
    hexString - The hex string to convert to bytes.
    
    Returns:
    
    A byte array containing values parsed from the hex string provided.
  - getCommaDelimitedSimpleClassNames
```
public static java.lang.String getCommaDelimitedSimpleClassNames(java.lang.Object[] objects)
```
    Returns a string with comma delimited simple names of each object's class.
    
    Parameters:
    
    objects - The objects whose simple class names should be comma delimited and returned.
    
    Returns:
    
    A string with comma delimited simple names of each object's class.
  - getUserAgent
```
public static java.lang.String getUserAgent(android.content.Context context,
                                            java.lang.String applicationName)
```
    Returns a user agent string based on the given application name and the library version.
    
    Parameters:
    
    context - A valid context of the calling application.
    
    applicationName - String that will be prefix'ed to the generated user agent.
    
    Returns:
    
    A user agent string generated using the applicationName and the library version.
  - getCodecsOfType
```
@Nullable
public static java.lang.String getCodecsOfType(java.lang.String codecs,
                                                         int trackType)
```
    Returns a copy of codecs without the codecs whose track type doesn't match trackType.
    
    Parameters:
    
    codecs - A codec sequence string, as defined in RFC 6381.
    
    trackType - One of C.TRACK_TYPE_*.
    
    Returns:
    
    A copy of codecs without the codecs whose track type doesn't match trackType.
  - splitCodecs
```
public static java.lang.String[] splitCodecs(java.lang.String codecs)
```
    Splits a codecs sequence string, as defined in RFC 6381, into individual codec strings.
    
    Parameters:
    
    codecs - A codec sequence string, as defined in RFC 6381.
    
    Returns:
    
    The split codecs, or an array of length zero if the input was empty.
  - getPcmEncoding
```
@C.PcmEncoding
public static int getPcmEncoding(int bitDepth)
```
    Converts a sample bit depth to a corresponding PCM encoding constant.
    
    Parameters:
    
    bitDepth - The bit depth. Supported values are 8, 16, 24 and 32.
    
    Returns:
    
    The corresponding encoding. One of C.ENCODING_PCM_8BIT, C.ENCODING_PCM_16BIT, C.ENCODING_PCM_24BIT and C.ENCODING_PCM_32BIT. If the bit depth is unsupported then C.ENCODING_INVALID is returned.
  - isEncodingLinearPcm
```
public static boolean isEncodingLinearPcm(@C.Encoding
                                          int encoding)
```
    Returns whether encoding is one of the linear PCM encodings.
    
    Parameters:
    
    encoding - The encoding of the audio data.
    
    Returns:
    
    Whether the encoding is one of the PCM encodings.
  - isEncodingHighResolutionIntegerPcm
```
public static boolean isEncodingHighResolutionIntegerPcm(@C.PcmEncoding
                                                         int encoding)
```
    Returns whether encoding is high resolution (> 16-bit) integer PCM.
    
    Parameters:
    
    encoding - The encoding of the audio data.
    
    Returns:
    
    Whether the encoding is high resolution integer PCM.
  - getAudioTrackChannelConfig
```
public static int getAudioTrackChannelConfig(int channelCount)
```
    Returns the audio track channel configuration for the given channel count, or AudioFormat.CHANNEL_INVALID if output is not poossible.
    
    Parameters:
    
    channelCount - The number of channels in the input audio.
    
    Returns:
    
    The channel configuration or AudioFormat.CHANNEL_INVALID if output is not possible.
  - getPcmFrameSize
```
public static int getPcmFrameSize(@C.PcmEncoding
                                  int pcmEncoding,
                                  int channelCount)
```
    Returns the frame size for audio with channelCount channels in the specified encoding.
    
    Parameters:
    
    pcmEncoding - The encoding of the audio data.
    
    channelCount - The channel count.
    
    Returns:
    
    The size of one audio frame in bytes.
  - getAudioUsageForStreamType
```
@C.AudioUsage
public static int getAudioUsageForStreamType(@C.StreamType
                                                           int streamType)
```
    Returns the C.AudioUsage corresponding to the specified C.StreamType.
  - getAudioContentTypeForStreamType
```
@C.AudioContentType
public static int getAudioContentTypeForStreamType(@C.StreamType
                                                                       int streamType)
```
    Returns the C.AudioContentType corresponding to the specified C.StreamType.
  - getStreamTypeForAudioUsage
```
@C.StreamType
public static int getStreamTypeForAudioUsage(@C.AudioUsage
                                                           int usage)
```
    Returns the C.StreamType corresponding to the specified C.AudioUsage.
  - getDrmUuid
```
@Nullable
public static java.util.UUID getDrmUuid(java.lang.String drmScheme)
```
    Derives a DRM UUID from drmScheme.
    
    Parameters:
    
    drmScheme - A UUID string, or "widevine", "playready" or "clearkey".
    
    Returns:
    
    The derived UUID, or null if one could not be derived.
  - inferContentType
```
@C.ContentType
public static int inferContentType(android.net.Uri uri,
                                                  java.lang.String overrideExtension)
```
    Makes a best guess to infer the type from a Uri.
    
    Parameters:
    
    uri - The Uri.
    
    overrideExtension - If not null, used to infer the type.
    
    Returns:
    
    The content type.
  - inferContentType
```
@C.ContentType
public static int inferContentType(android.net.Uri uri)
```
    Makes a best guess to infer the type from a Uri.
    
    Parameters:
    
    uri - The Uri.
    
    Returns:
    
    The content type.
  - inferContentType
```
@C.ContentType
public static int inferContentType(java.lang.String fileName)
```
    Makes a best guess to infer the type from a file name.
    
    Parameters:
    
    fileName - Name of the file. It can include the path of the file.
    
    Returns:
    
    The content type.
  - getStringForTime
```
public static java.lang.String getStringForTime(java.lang.StringBuilder builder,
                                                java.util.Formatter formatter,
                                                long timeMs)
```
    Returns the specified millisecond time formatted as a string.
    
    Parameters:
    
    builder - The builder that formatter will write to.
    
    formatter - The formatter.
    
    timeMs - The time to format as a string, in milliseconds.
    
    Returns:
    
    The time formatted as a string.
  - getDefaultBufferSize
```
public static int getDefaultBufferSize(int trackType)
```
    Maps a C TRACK_TYPE_* constant to the corresponding C DEFAULT_*_BUFFER_SIZE constant.
    
    Parameters:
    
    trackType - The track type.
    
    Returns:
    
    The corresponding default buffer size in bytes.
    
    Throws:
    
    java.lang.IllegalArgumentException - If the track type is an unrecognized or custom track type.
  - escapeFileName
```
public static java.lang.String escapeFileName(java.lang.String fileName)
```
    Escapes a string so that it's safe for use as a file or directory name on at least FAT32 filesystems. FAT32 is the most restrictive of all filesystems still commonly used today.
    For simplicity, this only handles common characters known to be illegal on FAT32: <, >, :, ", /, \, |, ?, and *. % is also escaped since it is used as the escape character. Escaping is performed in a consistent way so that no collisions occur and unescapeFileName(String) can be used to retrieve the original file name.
    
    Parameters:
    
    fileName - File name to be escaped.
    
    Returns:
    
    An escaped file name which will be safe for use on at least FAT32 filesystems.
  - unescapeFileName
```
@Nullable
public static java.lang.String unescapeFileName(java.lang.String fileName)
```
    Unescapes an escaped file or directory name back to its original value.
    See escapeFileName(String) for more information.
    
    Parameters:
    
    fileName - File name to be unescaped.
    
    Returns:
    
    The original value of the file name before it was escaped, or null if the escaped fileName seems invalid.
  - sneakyThrow
```
public static void sneakyThrow(java.lang.Throwable t)
```
    A hacky method that always throws t even if t is a checked exception, and is not declared to be thrown.
  - recursiveDelete
```
public static void recursiveDelete(java.io.File fileOrDirectory)
```
    Recursively deletes a directory and its content.
  - createTempDirectory
```
public static java.io.File createTempDirectory(android.content.Context context,
                                               java.lang.String prefix)
                                        throws java.io.IOException
```
    Creates an empty directory in the directory returned by Context.getCacheDir().
    
    Throws:
    
    java.io.IOException
  - createTempFile
```
public static java.io.File createTempFile(android.content.Context context,
                                          java.lang.String prefix)
                                   throws java.io.IOException
```
    Creates a new empty file in the directory returned by Context.getCacheDir().
    
    Throws:
    
    java.io.IOException
  - crc
```
public static int crc(byte[] bytes,
                      int start,
                      int end,
                      int initialValue)
```
    Returns the result of updating a CRC with the specified bytes in a "most significant bit first" order.
    
    Parameters:
    
    bytes - Array containing the bytes to update the crc value with.
    
    start - The index to the first byte in the byte range to update the crc with.
    
    end - The index after the last byte in the byte range to update the crc with.
    
    initialValue - The initial value for the crc calculation.
    
    Returns:
    
    The result of updating the initial value with the specified bytes.
  - getNetworkType
```
@C.NetworkType
public static int getNetworkType(@Nullable
                                                android.content.Context context)
```
    Returns the C.NetworkType of the current network connection. C.NETWORK_TYPE_UNKNOWN will be returned if the ACCESS_NETWORK_STATE permission is not granted or the network connection type couldn't be determined.
    
    Parameters:
    
    context - A context to access the connectivity manager.
    
    Returns:
    
    The C.NetworkType of the current network connection, or C.NETWORK_TYPE_UNKNOWN if the ACCESS_NETWORK_STATE permission is not granted or context is null.
  - getCountryCode
```
public static java.lang.String getCountryCode(@Nullable
                                              android.content.Context context)
```
    Returns the upper-case ISO 3166-1 alpha-2 country code of the current registered operator's MCC (Mobile Country Code), or the country code of the default Locale if not available.
    
    Parameters:
    
    context - A context to access the telephony service. If null, only the Locale can be used.
    
    Returns:
    
    The upper-case ISO 3166-1 alpha-2 country code, or an empty String if unavailable.
  - inflate
```
public static boolean inflate(ParsableByteArray input,
                              ParsableByteArray output,
                              @Nullable
                              java.util.zip.Inflater inflater)
```
    Uncompresses the data in input.
    
    Parameters:
    
    input - Wraps the compressed input data.
    
    output - Wraps an output buffer to be used to store the uncompressed data. If output.data isn't big enough to hold the uncompressed data, a new array is created. If true is returned then the output's position will be set to 0 and its limit will be set to the length of the uncompressed data.
    
    inflater - If not null, used to uncompressed the input. Otherwise a new Inflater is created.
    
    Returns:
    
    Whether the input is uncompressed successfully.
  - getPhysicalDisplaySize
```
public static android.graphics.Point getPhysicalDisplaySize(android.content.Context context)
```
    Gets the physical size of the default display, in pixels.
    
    Parameters:
    
    context - Any context.
    
    Returns:
    
    The physical display size, in pixels.
  - getPhysicalDisplaySize
```
public static android.graphics.Point getPhysicalDisplaySize(android.content.Context context,
                                                            android.view.Display display)
```
    Gets the physical size of the specified display, in pixels.
    
    Parameters:
    
    context - Any context.
    
    display - The display whose size is to be returned.
    
    Returns:
    
    The physical display size, in pixels.

Class Util

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

SDK_INT

DEVICE

MANUFACTURER

MODEL

DEVICE_DEBUG_INFO

EMPTY_BYTE_ARRAY

Method Detail

toByteArray

startForegroundService

maybeRequestReadExternalStoragePermission

checkCleartextTrafficPermitted

isLocalFileUri

areEqual

contains

removeRange

castNonNull

castNonNullTypeArray

nullSafeArrayCopy

createHandler

createHandler

getLooper

newSingleThreadExecutor

closeQuietly

closeQuietly

readBoolean

writeBoolean

normalizeLanguageCode

fromUtf8Bytes

fromUtf8Bytes

getUtf8Bytes

split

splitAtFirst

isLinebreak

toLowerInvariant

toUpperInvariant

formatInvariant

ceilDivide

ceilDivide

constrainValue

constrainValue

constrainValue

addWithOverflowDefault

subtractWithOverflowDefault

binarySearchFloor

binarySearchFloor

binarySearchFloor

binarySearchCeil

binarySearchCeil

compareLong

parseXsDuration

parseXsDateTime

scaleLargeTimestamp

scaleLargeTimestamps

scaleLargeTimestampsInPlace

getMediaDurationForPlayoutDuration

getPlayoutDurationForMediaDuration

resolveSeekPositionUs

toArray

getIntegerCodeForString

getBytesFromHexString

getCommaDelimitedSimpleClassNames

getUserAgent

getCodecsOfType

splitCodecs

getPcmEncoding

isEncodingLinearPcm

isEncodingHighResolutionIntegerPcm

getAudioTrackChannelConfig

getPcmFrameSize

getAudioUsageForStreamType

getAudioContentTypeForStreamType

getStreamTypeForAudioUsage

getDrmUuid

inferContentType

inferContentType