kotlin-stdlib/kotlin.collections/listOf

listOf

fun <T> listOf(element: T): List<T>(source)

Returns an immutable list containing only the specified object element.

Since Kotlin

1.1
fun <T> listOf(vararg elements: T): List<T>(source)

Returns a new read-only list of given elements. The returned list is serializable (JVM).

Since Kotlin

1.1

Samples

import kotlin.test.*

fun main() { 
   //sampleStart 
   val list = listOf('a', 'b', 'c')
println(list.size) // 3
println("list.contains('a') is ${list.contains('a')}") // true
println(list.indexOf('b')) // 1
println(list[2]) // c 
   //sampleEnd
}
inline fun <T> listOf(): List<T>(source)

Returns an empty read-only list. The returned list is serializable (JVM).

Since Kotlin

1.1

Samples

import kotlin.test.*

fun main() { 
   //sampleStart 
               val list = listOf<String>()
            println("list.isEmpty() is ${list.isEmpty()}") // true

            // another way to create an empty list,
            // type parameter is inferred from the expected type
            val other: List<Int> = emptyList()

            // "Empty lists are equal"
println("list == other is ${list == other}") // true
            println(list) // []
            // list[0] // will fail 
   //sampleEnd
}
fun <T> listOf(element: T): List<T>(source)

Returns an immutable list containing only the specified object element. The returned list is serializable.

Since Kotlin

1.0

Samples

import kotlin.test.*

fun main() { 
   //sampleStart 
   val list = listOf('a')
println(list) // [a]
println(list.size) // 1 
   //sampleEnd
}
fun <T> listOf(vararg elements: T): List<T>(source)

Returns a new read-only list of given elements. The returned list is serializable (JVM).

Since Kotlin

1.0

Samples

import kotlin.test.*

fun main() { 
   //sampleStart 
   val list = listOf('a', 'b', 'c')
println(list.size) // 3
println("list.contains('a') is ${list.contains('a')}") // true
println(list.indexOf('b')) // 1
println(list[2]) // c 
   //sampleEnd
}
inline fun <T> listOf(): List<T>(source)

Returns an empty read-only list. The returned list is serializable (JVM).

Since Kotlin

1.0

Samples

import kotlin.test.*

fun main() { 
   //sampleStart 
               val list = listOf<String>()
            println("list.isEmpty() is ${list.isEmpty()}") // true

            // another way to create an empty list,
            // type parameter is inferred from the expected type
            val other: List<Int> = emptyList()

            // "Empty lists are equal"
println("list == other is ${list == other}") // true
            println(list) // []
            // list[0] // will fail 
   //sampleEnd
}