---

---

Description

The Java Arrays spliterator(T[] a) method returns a Spliterator covering all of the specified array.

Declaration

Following is the declaration for java.util.Arrays.spliterator(T[] a) method

public static <T> Spliterator<T> spliterator(T[] array)

Type Parameters

T − This is the type of elements.

Parameters

a − This is the array, assumed to be unmodified during use.

Return Value

This method returns a spliterator for the array elements.

Exception

NA

Java Arrays spliterator(T[] a, int fromIndex, int toIndex) Method

Description

The Java Arrays spliterator(T[] a, int fromIndex, int toIndex) method returns a Spliterator covering the specified range of the specified array.

Declaration

Following is the declaration for java.util.Arrays.spliterator(T[] a, int fromIndex, int toIndex) method

public static <T> Spliterator<T> spliterator(T[] array, int fromIndex, int toIndex)

Parameters

• a − This is the array, assumed to be unmodified during use.

• fromIndex − This is the index of the first element, inclusive, to be covered.

• toIndex − This is the index of the last element, exclusive, to be covered

Return Value

This method returns a spliterator for the array elements.

Exception

• ArrayIndexOutOfBoundsException − if fromIndex < 0 or toIndex > array.length

Getting Spliterator of Array of Objects Example

The following example shows the usage of Java Arrays spliterator(T[]) method. First, we've created an array of student objects. Using spliterator() method, array is printed thereafter.

package com.tutorialspoint;

import java.util.Arrays;
import java.util.Spliterator;

public class ArrayDemo {
   public static void main(String[] args) {
      // initialize array
      Student arr[] = { new Student(1, "Julie"), new Student(2, "Robert"), new Student(3, "Adam"), new Student(4, "Jene") };

      System.out.print("Array: [ ");
      
      // get the spliterator
      Spliterator<Student> spliterator = Arrays.spliterator(arr);

      // use the spliterator to print each item
      spliterator.forEachRemaining(i -> System.out.print(i + " "));
      
      System.out.print("]");
   }
}
class Student {
   int rollNo;
   String name;

   Student(int rollNo, String name){
      this.rollNo = rollNo;
      this.name = name;
   }

   @Override
   public String toString() {
      return "[ " + this.rollNo + ", " + this.name + " ]";
   }
}

Output

Let us compile and run the above program, this will produce the following result −

Array: [ [ 1, Julie ] [ 2, Robert ] [ 3, Adam ] [ 4, Jene ] ]

Getting Spliterator of Array of Objects using Range Example

The following example shows the usage of Java Arrays spliterator(T[], int, int) method. First, we've created an array of student objects. Using spliterator() method, array is printed thereafter.

package com.tutorialspoint;

import java.util.Arrays;
import java.util.Spliterator;

public class ArrayDemo {
   public static void main(String[] args) {
      // initialize array
      Student arr[] = { new Student(1, "Julie"), new Student(2, "Robert"), new Student(3, "Adam"), new Student(4, "Jene") };

      System.out.print("Array: [ ");
      
      // get the spliterator
      Spliterator<Student> spliterator = Arrays.spliterator(arr, 0, arr.length);

      // use the spliterator to print each item
      spliterator.forEachRemaining(i -> System.out.print(i + " "));
      
      System.out.print("]");
   }
}
class Student {
   int rollNo;
   String name;

   Student(int rollNo, String name){
      this.rollNo = rollNo;
      this.name = name;
   }

   @Override
   public String toString() {
      return "[ " + this.rollNo + ", " + this.name + " ]";
   }
}

Output

Let us compile and run the above program, this will produce the following result −

Array: [ [ 1, Julie ] [ 2, Robert ] [ 3, Adam ] [ 4, Jene ] ]

Getting Spliterator of Sub-Array of Objects Example

The following example shows the usage of Java Arrays spliterator(T[], int, int) method. First, we've created an array of student objects. Using spliterator() method, a sub-array is printed thereafter.

package com.tutorialspoint;

import java.util.Arrays;
import java.util.Spliterator;

public class ArrayDemo {
   public static void main(String[] args) {
      // initialize array
      Student arr[] = { new Student(1, "Julie"), new Student(2, "Robert"), new Student(3, "Adam"), new Student(4, "Jene") };

      System.out.print("Array: [ ");
      
      // get the spliterator
      Spliterator<Student> spliterator = Arrays.spliterator(arr, 0, 3);

      // use the spliterator to print each item
      spliterator.forEachRemaining(i -> System.out.print(i + " "));
      
      System.out.print("]");
   }
}
class Student {
   int rollNo;
   String name;

   Student(int rollNo, String name){
      this.rollNo = rollNo;
      this.name = name;
   }

   @Override
   public String toString() {
      return "[ " + this.rollNo + ", " + this.name + " ]";
   }
}

Output

Let us compile and run the above program, this will produce the following result −

Array: [ [ 1, Julie ] [ 2, Robert ] [ 3, Adam ] ]

java_util_arrays.htm