com.oracle.truffle.api

Class ArrayUtils

java.lang.Object

com.oracle.truffle.api.ArrayUtils

public final class ArrayUtils
extends Object

This class provides additional operations for String as well as character and byte arrays, which may be intrinsified by a compiler.

Since:

19.0

Method Summary

Modifier and Type	Method and Description
static int	indexOf(byte[] haystack, int fromIndex, int maxIndex, byte... needle) Returns the index of the first occurrence of any byte contained in needle in haystack, bounded by fromIndex (inclusive) and maxIndex (exclusive).
static int	indexOf(char[] haystack, int fromIndex, int maxIndex, char... needle) Returns the index of the first occurrence of any character contained in needle in haystack, bounded by fromIndex (inclusive) and maxIndex (exclusive).
static int	indexOf(String haystack, int fromIndex, int maxIndex, char... needle) Returns the index of the first occurrence of any character contained in needle in haystack, bounded by fromIndex (inclusive) and maxIndex (exclusive).
static int	indexOfWithOrMask(byte[] haystack, int fromIndex, int length, byte[] needle, byte[] mask) Returns the index of the first region of haystack that equals needle after being OR'ed with mask, bounded by fromIndex (inclusive) and length.
static int	indexOfWithOrMask(char[] haystack, int fromIndex, int length, char[] needle, char[] mask) Returns the index of the first region of haystack that equals needle after being OR'ed with mask, bounded by fromIndex (inclusive) and length.
static int	indexOfWithOrMask(String haystack, int fromIndex, int length, String needle, String mask) Returns the index of the first region of haystack that equals needle after being OR'ed with mask, bounded by fromIndex (inclusive) and length.
static boolean	regionEqualsWithOrMask(byte[] a1, int fromIndex1, byte[] a2, int fromIndex2, int length, byte[] mask) Returns true iff for all indices i from 0 (inclusive) to length (exclusive), (a1[fromIndex1 + i] | mask[i]) == a2[fromIndex2 + i] holds.
static boolean	regionEqualsWithOrMask(char[] a1, int fromIndex1, char[] a2, int fromIndex2, int length, char[] mask) Returns true iff for all indices i from 0 (inclusive) to length (exclusive), (a1[fromIndex1 + i] | mask[i]) == a2[fromIndex2 + i] holds.
static boolean	regionEqualsWithOrMask(String a1, int fromIndex1, String a2, int fromIndex2, int length, String mask) Returns true iff for all indices i from 0 (inclusive) to length (exclusive), (a1.charAt(fromIndex1 + i) | mask.charAt(i)) == a2.charAt(fromIndex2 + i) holds.

Methods inherited from class java.lang.Object

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

Method Detail

indexOf

public static int indexOf(String haystack,
                          int fromIndex,
                          int maxIndex,
                          char... needle)

Returns the index of the first occurrence of any character contained in needle in haystack, bounded by fromIndex (inclusive) and maxIndex (exclusive).

Returns:

the index of the first occurrence of any character contained in needle in haystack that is greater than or equal to fromIndex and less than maxIndex, or -1 if none of the characters occur.

Since:

19.0

indexOf

public static int indexOf(char[] haystack,
                          int fromIndex,
                          int maxIndex,
                          char... needle)

Returns the index of the first occurrence of any character contained in needle in haystack, bounded by fromIndex (inclusive) and maxIndex (exclusive).

Returns:

the index of the first occurrence of any character contained in needle in haystack that is greater than or equal to fromIndex and less than maxIndex, or -1 if none of the characters occur.

Since:

19.0

indexOf

public static int indexOf(byte[] haystack,
                          int fromIndex,
                          int maxIndex,
                          byte... needle)

Returns the index of the first occurrence of any byte contained in needle in haystack, bounded by fromIndex (inclusive) and maxIndex (exclusive).

Returns:

the index of the first occurrence of any byte contained in needle in haystack that is greater than or equal to fromIndex and less than maxIndex, or -1 if none of the needle occur.

Since:

19.0

indexOfWithOrMask

public static int indexOfWithOrMask(byte[] haystack,
                                    int fromIndex,
                                    int length,
                                    byte[] needle,
                                    byte[] mask)

Returns the index of the first region of haystack that equals needle after being OR'ed with mask, bounded by fromIndex (inclusive) and length. Performs best if needle and mask are CompilerDirectives.CompilationFinal with dimensions = 1.

Returns:

the index of the first region of haystack where for all indices i of needle (haystack[index + i] | mask[i]) == needle[i] holds, and fromIndex <= index && index + needle.length <= fromIndex + length holds, or -1 if no such region is found.

Since:

19.3

indexOfWithOrMask

public static int indexOfWithOrMask(char[] haystack,
                                    int fromIndex,
                                    int length,
                                    char[] needle,
                                    char[] mask)

Returns the index of the first region of haystack that equals needle after being OR'ed with mask, bounded by fromIndex (inclusive) and length. Performs best if needle and mask are CompilerDirectives.CompilationFinal with dimensions = 1.

Returns:

the index of the first region of haystack where for all indices i of needle (haystack[index + i] | mask[i]) == needle[i] holds, and fromIndex <= index && index + needle.length <= fromIndex + length holds, or -1 if no such region is found.

Since:

19.3

indexOfWithOrMask

public static int indexOfWithOrMask(String haystack,
                                    int fromIndex,
                                    int length,
                                    String needle,
                                    String mask)

Returns the index of the first region of haystack that equals needle after being OR'ed with mask, bounded by fromIndex (inclusive) and length. Performs best if needle and mask are CompilerDirectives.CompilationFinal.

Returns:

the index of the first region of haystack where for all indices i of needle (haystack.charAt(index + i) | mask.charAt(i)) == needle.charAt(i) holds, and fromIndex <= index && index + needle.length() <= fromIndex + length holds, or -1 if no such region is found.

Since:

19.3

regionEqualsWithOrMask

public static boolean regionEqualsWithOrMask(byte[] a1,
                                             int fromIndex1,
                                             byte[] a2,
                                             int fromIndex2,
                                             int length,
                                             byte[] mask)

Returns true iff for all indices i from 0 (inclusive) to length (exclusive), (a1[fromIndex1 + i] | mask[i]) == a2[fromIndex2 + i] holds. Performs best if length and mask are CompilerDirectives.CompilationFinal with dimensions = 1. If mask is null, it is treated as if it was filled with zeroes.

Since:

19.3

regionEqualsWithOrMask

public static boolean regionEqualsWithOrMask(char[] a1,
                                             int fromIndex1,
                                             char[] a2,
                                             int fromIndex2,
                                             int length,
                                             char[] mask)

Returns true iff for all indices i from 0 (inclusive) to length (exclusive), (a1[fromIndex1 + i] | mask[i]) == a2[fromIndex2 + i] holds. Performs best if length and mask are CompilerDirectives.CompilationFinal with dimensions = 1. If mask is null, it is treated as if it was filled with zeroes.

Since:

19.3

regionEqualsWithOrMask

public static boolean regionEqualsWithOrMask(String a1,
                                             int fromIndex1,
                                             String a2,
                                             int fromIndex2,
                                             int length,
                                             String mask)

Returns true iff for all indices i from 0 (inclusive) to length (exclusive), (a1.charAt(fromIndex1 + i) | mask.charAt(i)) == a2.charAt(fromIndex2 + i) holds. Performs best if length and mask are CompilerDirectives.CompilationFinal with dimensions = 1. If mask is null, it is treated as if it was filled with zeroes.

Since:

19.3