list操作方法解析:
.any
如果至少有一個(gè)元素符合給出的判斷條件,則返回true
val list = listOf(1,2,3,4,5,6)
list.any(it % 2 == 0) // true
list.any(it > 10) //false
.all
如果全部的元素符合給出的判斷條件,則返回true
list.all{it < 10} // true
list.all{it % 2 == 0} //false
.count
返回符合給出判斷條件的元素總數(shù)
list.count{it % 2 == 0}//3
在一個(gè)初始值的基礎(chǔ)上從第一項(xiàng)到最后一項(xiàng)通過一個(gè)函數(shù)累計(jì)所有的元素
list.fold(4){total,next -> total + next} // 25
與fold一樣,但是順序是從最后一項(xiàng)到第一項(xiàng)
list.foldRight(4){total,next->total+next}//25
遍歷所有元素,并執(zhí)行給定的操作
list.forEach{ println(it) }
與forEach,但是同時(shí)可以得到元素的index
list.forEachIndexed{ index,value -> println("position $index contains a $value")}
.max
返回最大的一項(xiàng),如果沒有則返回null
list.max() // 6
.maxBy
根據(jù)給定的函數(shù)返回最大的一項(xiàng),如果沒有則返回null
// The element whose negative is greater
list.maxBy{-it} // 1
.min .minBy 同max maxBy(反)
.none
如果沒有任何元素與給定的函數(shù)匹配,則返回true
// No elements are divisible by 7
list.none{it % 7 == 0} //true
.reduce
與fold一樣,但是沒有一個(gè)初始值。通過一個(gè)函數(shù)從第一項(xiàng)到最后一項(xiàng)進(jìn)行累計(jì)
list.reduce{total,next -> total+next} //21
.reduceRight 與reduce一樣,但是順序是從最后一項(xiàng)到第一項(xiàng)
.sumBy
返回所有每一項(xiàng)通過函數(shù)轉(zhuǎn)換之后的數(shù)據(jù)的總和
list.sumBy{ it%2 } // 3
.drop
返回包含去掉前n個(gè)元素的所有元素的列表
list.drop(4) // listOf(5,6)
.dropWhile
返回根據(jù)給定函數(shù)從第一項(xiàng)開始去掉指定元素的列表
list.dropWhile{it<3} // listOf(3,4,5,6)
.dropLastWhile
返回根據(jù)給定函數(shù)從最后一項(xiàng)開始去掉指定元素的列表
list.dropLastWhile{it>4} // listOf(1,2,3,4)
.filter
過濾所有符合給定函數(shù)條件的元素
list.filter{it%2 == 0} // listOf(2,4,6)
.filterNot
過濾所有不符合給定函數(shù)條件的元素
list.filterNot{ it % 2 == 0} // listOf(1,3,5)
.filterNotNull
過濾所有元素中不是null的元素
.slice
過濾一個(gè)list中指定index的元素
list.slice(listOf(1,3,4)) // listOf(2,4,5)
.take
返回從第一個(gè)開始的n個(gè)元素
list.take(2) // listOf(1,2)
.takeLast
返回從最后一個(gè)開始的n個(gè)元素
list.takeLast(2) // listOf(5,6)
.takeWhile
返回從第一個(gè)開始符合給定函數(shù)條件的元素
list.takeWhile{ it < 3} // listOf(1,2)
.flatMap
遍歷所有的元素,為每一個(gè)創(chuàng)建一個(gè)集合,最后把所有的集合放在一個(gè)集合中
list.flatMap{listOf(it,it+1)}// listOf(1, 2, 2, 3, 3, 4, 4, 5, 5, 6, 6, 7)
.groupBy
返回一個(gè)根據(jù)給定函數(shù)分組后的map
list.groupBy{ if(it % 2 == 0) "even" else "odd"} // {odd=[1, 3, 5], even=[2, 4, 6]}
.map
返回一個(gè)每一個(gè)元素根據(jù)給定的函數(shù)轉(zhuǎn)換所組成的list
list.map{it*2} //listOf(2,4,6,8,10,12)
.mapIndexed
返回一個(gè)每一個(gè)元素根據(jù)給定的包含元素index的函數(shù)轉(zhuǎn)換所組成的list(索引值與對應(yīng)值的函數(shù)關(guān)系)
list.mapIndexed{index,it->index*it}//listOf (0, 2, 6, 12, 20, 30)
.mapNotNull
返回一個(gè)每一個(gè)非null元素根據(jù)給定的函數(shù)轉(zhuǎn)換所組成的list
.contains
如果指定元素可以在集合中找到,則返回true
.elementAt
返回給定index對應(yīng)的元素,如果index數(shù)組越界則會(huì)拋出IndexOutOfBoundsException
.elementAtOrElse
返回給定index對應(yīng)的元素,如果index數(shù)組越界則會(huì)根據(jù)給定函數(shù)返回默認(rèn)值
list.elementAtOrElse(10){2*it} //20
.elementAtOrNull
返回給定index對應(yīng)的元素,如果index數(shù)組越界則會(huì)返回null。
.first
返回符合給定函數(shù)條件的第一個(gè)元素
list.first{it%2 == 0} // 2
. firstOrNull
返回符合給定函數(shù)條件的第一個(gè)元素,如果沒有符合則返回null。
. indexOf
返回指定元素的第一個(gè)index,如果不存在,則返回-1。
list.indexOf(4) // 3
. indexOfFirst
返回第一個(gè)符合給定函數(shù)條件的元素的index,如果沒有符合則返回-1。
list.indexOfFirst { it % 2 == 0 } // 1
. indexOfLast
返回最后一個(gè)符合給定函數(shù)條件的元素index,如果沒有符合則返回-1
list.indexOfLast { it % 2 == 0 } // 5
.last
返回符合給定函數(shù)條件的最后一個(gè)元素
list.last { it % 2 == 0 } // 6
. lastIndexOf
返回指定元素的最后一個(gè)index,如果不存在,則返回-1。
. lastOrNull
返回符合給定函數(shù)條件的最后一個(gè)元素,如果沒有符合則返回null。
.single
返回符合給定函數(shù)的單個(gè)元素,如果沒有符合或者超過一個(gè),則拋出異常。
list.single { it % 5 == 0 } // 5
. singleOrNull
返回符合給定函數(shù)的單個(gè)元素,如果沒有符合或者超過一個(gè),則返回null。
. merge
把兩個(gè)集合合并成一個(gè)新的,相同index的元素通過給定的函數(shù)進(jìn)行合并成新的元素作為新的集合的一個(gè)元素,返回這個(gè)新的集合。新的集合的大小由最小的那個(gè)集合大小決定。
val list = listOf(1, 2, 3, 4, 5, 6)
val listRepeated = listOf(2, 2, 3, 4, 5, 5, 6)
list.merge(listRepeated) { it1, it2 -> it1 + it2 }
// 結(jié)果 listOf(3, 4, 6, 8, 10, 11)
.partition
把一個(gè)給定的集合分割成兩個(gè),第一個(gè)集合是由原集合每一項(xiàng)元素匹配給定函數(shù)條件返回true的元素組成,第二個(gè)集合是由原集合每一項(xiàng)元素匹配給定函數(shù)條件返回false的元素組成。
list.partition(it % 2 == 0) // listOf(2,4,6) listOf(1,3,5)
.plus
返回一個(gè)包含原集合和給定集合中所有元素的集合,因?yàn)楹瘮?shù)的名字原因,我們可以使用+操作符
val list = listOf(1,2,3,4,5,6)
Timber.e("demo ${list.plus(listOf(7,8))} and ${list+ listOf(9,10)}")
.zip
返回由pair組成的list,每個(gè)pair由兩個(gè)集合中相同index的元素組成。這個(gè)返回的list的大小由最小的那個(gè)集合決定
val list = listOf(1,2,3,4,5,6,7)
list.zip(listOf(7,8)) //[(1, 7), (2, 8)]
. unzip
從包含pair的List中生成包含List的Pair。
listOf(Pair(5, 7), Pair(6, 8)).unzip()// ([5, 6], [7, 8])
. reverse
返回一個(gè)與指定list相反順序的list
.sort
返回一個(gè)自然排序后的list
.sortBy
返回一個(gè)根據(jù)指定函數(shù)排序后的list。
. sortDescending
返回一個(gè)降序排序后的List。
. sortDescendingBy
返回一個(gè)根據(jù)指定函數(shù)降序排序后的list