Package org.wildfly.common.array

Class Arrays2

java.lang.Object
org.wildfly.common.array.Arrays2
public final class Arrays2 extends Object
Useful general array manipulations beyond what Arrays provides.
Author:
David M. Lloyd

  • Method Summary

    Modifier and Type
    Method
    Description
    static <E> E[]
    compactNulls(E[] original)
    Create a new array from the original which contains no null values, possibly destroying the contents of the original array.
    static <E> E[]
    createArray(Class<E> elementType, int size)
    Create an array of the given size, ensuring type safety.
    static boolean
    equals(byte[] a1, int offs1, byte[] a2)
    Compare two sub-regions of the given arrays.
    static boolean
    equals(byte[] a1, int offs1, byte[] a2, int offs2, int len)
    Compare two sub-regions of the given arrays.
    static boolean
    equals(char[] a1, int offs1, char[] a2)
    Compare two sub-regions of the given arrays.
    static boolean
    equals(char[] a1, int offs1, char[] a2, int offs2, int len)
    Compare two sub-regions of the given arrays.
    static boolean
    equals(char[] a1, int offs1, String a2)
    Compare two sub-regions of the given array and string.
    static boolean
    equals(char[] a1, int offs1, String a2, int offs2, int len)
    Compare two sub-regions of the given array and string.
    static boolean
    equals(String a1, char[] a2)
    Compare the given array and string.
    static boolean
    equals(String a1, int offs1, char[] a2)
    Compare two sub-regions of the given array and string.
    static int
    indexOf(byte[] array, int search)
    Find the first occurrence of a byte in a byte array.
    static int
    indexOf(byte[] array, int search, int offs)
    Find the first occurrence of a byte in a byte array.
    static int
    indexOf(byte[] array, int search, int offs, int len)
    Find the first occurrence of a byte in a byte array.
    static String
    objectToString(Object value)
    Deeply convert an object to a string, expanding arrays as they are encountered.
    static <T> T[]
    of(T... items)
    Return the varargs list as its array representation.
    static String
    toString(byte[] bytes)
    Render the given byte array as a hexadecimal string in big-endian order.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Method Details

    • equals

      public static boolean equals(byte[] a1, int offs1, byte[] a2, int offs2, int len)
      Compare two sub-regions of the given arrays.
      Parameters:
      a1 - the first array (must not be null)
      offs1 - the offset into the first array
      a2 - the second array (must not be null)
      offs2 - the offset into the second array
      len - the length to compare
      Returns:
      true if the regions are equal, or false if the regions are not equal or a length or offset is out of bounds for an array

    • equals

      public static boolean equals(byte[] a1, int offs1, byte[] a2)
      Compare two sub-regions of the given arrays.
      Parameters:
      a1 - the first array (must not be null)
      offs1 - the offset into the first array
      a2 - the second array (must not be null)
      Returns:
      true if the regions are equal, or false if the regions are not equal or a length or offset is out of bounds for an array

    • equals

      public static boolean equals(char[] a1, int offs1, char[] a2, int offs2, int len)
      Compare two sub-regions of the given arrays.
      Parameters:
      a1 - the first array (must not be null)
      offs1 - the offset into the first array
      a2 - the second array (must not be null)
      offs2 - the offset into the second array
      len - the length to compare
      Returns:
      true if the regions are equal, or false if the regions are not equal or a length or offset is out of bounds for an array

    • equals

      public static boolean equals(char[] a1, int offs1, char[] a2)
      Compare two sub-regions of the given arrays.
      Parameters:
      a1 - the first array (must not be null)
      offs1 - the offset into the first array
      a2 - the second array (must not be null)
      Returns:
      true if the regions are equal, or false if the regions are not equal or a length or offset is out of bounds for an array

    • equals

      public static boolean equals(char[] a1, int offs1, String a2, int offs2, int len)
      Compare two sub-regions of the given array and string.
      Parameters:
      a1 - the array (must not be null)
      offs1 - the offset into the array
      a2 - the string (must not be null)
      offs2 - the offset into the string
      len - the length to compare
      Returns:
      true if the regions are equal, or false if the regions are not equal or a length or offset is out of bounds for the array or string

    • equals

      public static boolean equals(char[] a1, int offs1, String a2)
      Compare two sub-regions of the given array and string.
      Parameters:
      a1 - the array (must not be null)
      offs1 - the offset into the array
      a2 - the string (must not be null)
      Returns:
      true if the regions are equal, or false if the regions are not equal or a length or offset is out of bounds for the array or string

    • equals

      public static boolean equals(String a1, int offs1, char[] a2)
      Compare two sub-regions of the given array and string.
      Parameters:
      a1 - the string (must not be null)
      offs1 - the offset into the string
      a2 - the array (must not be null)
      Returns:
      true if the regions are equal, or false if the regions are not equal or a length or offset is out of bounds for the array or string

    • equals

      public static boolean equals(String a1, char[] a2)
      Compare the given array and string.
      Parameters:
      a1 - the string (must not be null)
      a2 - the array (must not be null)
      Returns:
      true if the regions are equal, or false if the regions are not equal or a length or offset is out of bounds for the array or string

    • of

      @SafeVarargs public static <T> T[] of(T... items)
      Return the varargs list as its array representation.
      Type Parameters:
      T - the item type
      Parameters:
      items - the items
      Returns:
      the array

    • toString

      public static String toString(byte[] bytes)
      Render the given byte array as a hexadecimal string in big-endian order.
      Parameters:
      bytes - the byte array (must not be null)
      Returns:
      the string

    • indexOf

      public static int indexOf(byte[] array, int search, int offs, int len)
      Find the first occurrence of a byte in a byte array.
      Parameters:
      array - the array to search
      search - the byte to search for
      offs - the offset in the array to start searching
      len - the length of the segment to search
      Returns:
      the index, or -1 if the byte is not found

    • indexOf

      public static int indexOf(byte[] array, int search, int offs)
      Find the first occurrence of a byte in a byte array.
      Parameters:
      array - the array to search
      search - the byte to search for
      offs - the offset in the array to start searching
      Returns:
      the index, or -1 if the byte is not found

    • indexOf

      public static int indexOf(byte[] array, int search)
      Find the first occurrence of a byte in a byte array.
      Parameters:
      array - the array to search
      search - the byte to search for
      Returns:
      the index, or -1 if the byte is not found

    • createArray

      public static <E> E[] createArray(Class<E> elementType, int size)
      Create an array of the given size, ensuring type safety.
      Type Parameters:
      E - the element type
      Parameters:
      elementType - the element type class
      size - the array size
      Returns:
      the array

    • compactNulls

      public static <E> E[] compactNulls(E[] original)
      Create a new array from the original which contains no null values, possibly destroying the contents of the original array. If the original contains no null values, the original array is returned.
      Type Parameters:
      E - the element type
      Parameters:
      original - the original array (not null, will be modified)
      Returns:
      the compacted (possibly empty) array

    • objectToString

      public static String objectToString(Object value)
      Deeply convert an object to a string, expanding arrays as they are encountered.
      Parameters:
      value - the value to convert
      Returns:
      the string