Kotlin List listIterator()
Syntax & Examples

Syntax of List.listIterator()

There are 2 variations for the syntax of List.listIterator() function. They are:

abstract fun listIterator(): ListIterator<E>

This function returns a list iterator over the elements in this list (in proper sequence).

abstract fun listIterator(index: Int): ListIterator<E>

This function returns a list iterator over the elements in this list (in proper sequence), starting at the specified index.

✐ Examples

1 Example

In this example,

We create a list named list1 containing the elements 'a', 'b', 'c'.
We obtain a list iterator over list1 using the List listIterator() function.
We iterate over the elements using a while loop, checking if the iterator has more elements with hasNext() and retrieving each element with next().
Each element is printed to standard output using the println function.

Kotlin Program

fun main(args: Array<String>) {
    val list1 = listOf("a", "b", "c")
    val listIterator1 = list1.listIterator()
    while (listIterator1.hasNext()) {
        val element = listIterator1.next()
        println(element)
    }
}

Output

a
b
c

2 Example

In this example,

We create a list named list2 containing the integers 10, 20, 30.
We obtain a list iterator over list2 starting at index 1 using the List listIterator(index: Int) function.
We iterate over the elements using a while loop, checking if the iterator has more elements with hasNext() and retrieving each element with next().
Each element is printed to standard output using the println function.

Kotlin Program

fun main(args: Array<String>) {
    val list2 = listOf(10, 20, 30)
    val listIterator2 = list2.listIterator(1)
    while (listIterator2.hasNext()) {
        val element = listIterator2.next()
        println(element)
    }
}

Output

20
30

Summary

In this Kotlin tutorial, we learned about listIterator() function of List: the syntax and few working examples with output and detailed explanation for each example.