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 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> 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> 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 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 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 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`	`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 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 long`	`getMediaDurationForPlayoutDuration(long playoutDuration, float speed)` Returns the duration of media that will elapse in `playoutDuration`.
`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`	`isEncodingHighResolutionIntegerPcm(int encoding)` Returns whether `encoding` is high resolution (> 16-bit) integer PCM.
`static boolean`	`isEncodingPcm(int encoding)` Returns whether `encoding` is one of the 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 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(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 java.lang.String`	`toLowerInvariant(java.lang.String text)` Converts text to lower case using `Locale.US`.
`static java.lang.String`	`toUpperInvariant(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.
- 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.
  - 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.
    
    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).
  - 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.
  - 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 java.lang.String toLowerInvariant(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 java.lang.String toUpperInvariant(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> 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> 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(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
```
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.
  - getPcmEncoding
```
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.
  - isEncodingPcm
```
public static boolean isEncodingPcm(int encoding)
```
    Returns whether encoding is one of the 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(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.
  - getPcmFrameSize
```
public static int getPcmFrameSize(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
```
public static int getAudioUsageForStreamType(int streamType)
```
    Returns the C.AudioUsage corresponding to the specified C.StreamType.
  - getAudioContentTypeForStreamType
```
public static int getAudioContentTypeForStreamType(int streamType)
```
    Returns the C.AudioContentType corresponding to the specified C.StreamType.
  - getStreamTypeForAudioUsage
```
public static int getStreamTypeForAudioUsage(int usage)
```
    Returns the C.StreamType corresponding to the specified C.AudioUsage.
  - getDrmUuid
```
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
```
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
```
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
```
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.
  - 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
```
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.
  - 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

Method Detail

toByteArray

startForegroundService

maybeRequestReadExternalStoragePermission

isLocalFileUri

areEqual

contains

removeRange

nullSafeArrayCopy

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

getPcmEncoding

isEncodingPcm

isEncodingHighResolutionIntegerPcm

getPcmFrameSize

getAudioUsageForStreamType

getAudioContentTypeForStreamType

getStreamTypeForAudioUsage

getDrmUuid

inferContentType

inferContentType

inferContentType

getStringForTime

getDefaultBufferSize

escapeFileName

unescapeFileName

sneakyThrow

recursiveDelete

createTempDirectory

createTempFile