Returns a fixed-size list backed by the specified array, similar to Arrays#asList(Object[]). The list supports List#set(int, Object), but any attempt to set a value to null will result in a NullPointerException.

There are at most two distinct objects in this list, (Boolean) true and (Boolean) false. Java guarantees that those are always represented by the same objects.

The returned list is serializable.

Parameters

backingArray:boolean[]

the array to back the list

Returns:List<Boolean>

a list view of the array

Compares the two specified boolean values in the standard way (false is considered less than true). The sign of the value returned is the same as that of ((Boolean) a).compareTo(b).

Java 7+ users: this method should be treated as deprecated; use the equivalent Boolean#compare method instead.

Parameters

a:boolean

the first boolean to compare

b:boolean

the second boolean to compare

Returns:int

a positive number if only a is true, a negative number if only b is true, or zero if a == b

Returns the values from each provided array combined into a single array. For example, concat(new boolean[] {a, b}, new boolean[] {}, new boolean[] {c} returns the array {a, b, c}.

Parameters

arrays:boolean[][]

zero or more boolean arrays

Returns:boolean[]

a single array containing all the values from the source arrays, in order

Returns true if target is present as an element anywhere in array.

Parameters

array:boolean[]

an array of boolean values, possibly empty

target:boolean

a primitive boolean value

Returns:boolean

true if array[i] == target for some value of i

Returns the number of values that are true.

Since

16.0

Returns an array containing the same values as array, but guaranteed to be of a specified minimum length. If array already has a length of at least minLength, it is returned directly. Otherwise, a new array of size minLength + padding is returned, containing the values of array, and zeroes in the remaining places.

Parameters

array:boolean[]

the source array

minLength:int

the minimum length the returned array must guarantee

padding:int

an extra amount to "grow" the array by if growth is necessary

Returns:boolean[]

an array containing the values of array, with guaranteed minimum length minLength

Exceptions

IllegalArgumentException:

if minLength or padding is negative

Returns a Comparator<Boolean> that sorts false before true.

This is particularly useful in Java 8+ in combination with Comparator.comparing, e.g. Comparator.comparing(Foo::hasBar, falseFirst()).

Since

21.0

Returns a hash code for value; equal to the result of invoking ((Boolean) value).hashCode().

Java 8+ users: use Boolean#hashCode(boolean) instead.

Parameters

value:boolean

a primitive boolean value

Returns:int

a hash code for the value

Returns the index of the first appearance of the value target in array.

Parameters

array:boolean[]

an array of boolean values, possibly empty

target:boolean

a primitive boolean value

Returns:int

the least index i for which array[i] == target, or -1 if no such index exists.

Returns the start position of the first occurrence of the specified target within array, or -1 if there is no such occurrence.

More formally, returns the lowest index i such that Arrays.copyOfRange(array, i, i + target.length) contains exactly the same elements as target.

Parameters

array:boolean[]

the array to search for the sequence target

target:boolean[]

the array to search for as a sub-sequence of array

Returns a string containing the supplied boolean values separated by separator. For example, join("-", false, true, false) returns the string "false-true-false".

Parameters

separator:String

the text that should appear between consecutive values in the resulting string (but not at the start or end)

array:boolean[]

an array of boolean values, possibly empty

Returns the index of the last appearance of the value target in array.

Parameters

array:boolean[]

an array of boolean values, possibly empty

target:boolean

a primitive boolean value

Returns:int

the greatest index i for which array[i] == target, or -1 if no such index exists.

Returns a comparator that compares two boolean arrays lexicographically. That is, it compares, using compare(boolean, boolean)), the first pair of values that follow any common prefix, or when one array is a prefix of the other, treats the shorter array as the lesser. For example, [] < [false] < [false, true] < [true].

The returned comparator is inconsistent with Object#equals(Object) (since arrays support only identity equality), but it is consistent with Arrays#equals(boolean[], boolean[]).

Since

2.0

Reverses the elements of array. This is equivalent to Collections.reverse(Booleans.asList(array)), but is likely to be more efficient.

Since

23.1

Reverses the elements of array between fromIndex inclusive and toIndex exclusive. This is equivalent to Collections.reverse(Booleans.asList(array).subList(fromIndex, toIndex)), but is likely to be more efficient.

Exceptions

IndexOutOfBoundsException:

if fromIndex < 0, toIndex > array.length, or toIndex > fromIndex

Since

23.1

Performs a right rotation of array of "distance" places, so that the first element is moved to index "distance", and the element at index i ends up at index (distance + i) mod array.length. This is equivalent to Collections.rotate(Booleans.asList(array), distance), but is somewhat faster.

The provided "distance" may be negative, which will rotate left.

Since

32.0.0

Performs a right rotation of array between fromIndex inclusive and toIndex exclusive. This is equivalent to Collections.rotate(Booleans.asList(array).subList(fromIndex, toIndex), distance), but is somewhat faster.

The provided "distance" may be negative, which will rotate left.

Exceptions

IndexOutOfBoundsException:

if fromIndex < 0, toIndex > array.length, or toIndex > fromIndex

Since

32.0.0

Copies a collection of Boolean instances into a new array of primitive boolean values.

Elements are copied from the argument collection as if by collection.toArray(). Calling this method is as thread-safe as calling that method.

Parameters

collection:Collection<Boolean>

a collection of Boolean objects

Returns:boolean[]

an array containing the same values as collection, in the same order, converted to primitives

Exceptions

NullPointerException:

if collection or any of its elements is null

Returns a Comparator<Boolean> that sorts true before false.

This is particularly useful in Java 8+ in combination with Comparator.comparing, e.g. Comparator.comparing(Foo::hasBar, trueFirst()).

Since

21.0