Added samples for map filtering operators (KT-20357)
Fix map transformations sample names.
This commit is contained in:
committed by
Ilya Gorbunov
parent
dca23e339a
commit
9b49e9139c
@@ -104,7 +104,104 @@ class Maps {
|
||||
// prints: meal - 12.4
|
||||
// prints: dessert - 5.8
|
||||
}
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
class Filtering {
|
||||
|
||||
@Sample
|
||||
fun filterKeys() {
|
||||
val originalMap = mapOf("key1" to 1, "key2" to 2, "something_else" to 3)
|
||||
|
||||
val filteredMap = originalMap.filterKeys { it.contains("key") }
|
||||
assertPrints(filteredMap, "{key1=1, key2=2}")
|
||||
// original map has not changed
|
||||
assertPrints(originalMap, "{key1=1, key2=2, something_else=3}")
|
||||
|
||||
val nonMatchingPredicate: (String) -> Boolean = { it == "key3" }
|
||||
val emptyMap = originalMap.filterKeys(nonMatchingPredicate)
|
||||
assertPrints(emptyMap, "{}")
|
||||
}
|
||||
|
||||
@Sample
|
||||
fun filterValues() {
|
||||
val originalMap = mapOf("key1" to 1, "key2" to 2, "key3" to 3)
|
||||
|
||||
val filteredMap = originalMap.filterValues { it >= 2 }
|
||||
assertPrints(filteredMap, "{key2=2, key3=3}")
|
||||
// original map has not changed
|
||||
assertPrints(originalMap, "{key1=1, key2=2, key3=3}")
|
||||
|
||||
val nonMatchingPredicate: (Int) -> Boolean = { it == 0 }
|
||||
val emptyMap = originalMap.filterValues(nonMatchingPredicate)
|
||||
assertPrints(emptyMap, "{}")
|
||||
}
|
||||
|
||||
@Sample
|
||||
fun filterTo() {
|
||||
val originalMap = mapOf("key1" to 1, "key2" to 2, "key3" to 3)
|
||||
val destinationMap = mutableMapOf("key40" to 40, "key50" to 50)
|
||||
|
||||
val filteredMap = originalMap.filterTo(destinationMap) { it.value < 3 }
|
||||
|
||||
//destination map is updated with filtered items from the original map
|
||||
assertTrue(destinationMap === filteredMap)
|
||||
assertPrints(destinationMap, "{key40=40, key50=50, key1=1, key2=2}")
|
||||
// original map has not changed
|
||||
assertPrints(originalMap, "{key1=1, key2=2, key3=3}")
|
||||
|
||||
val nonMatchingPredicate: ((Map.Entry<String, Int>)) -> Boolean = { it.value == 0 }
|
||||
val anotherDestinationMap = mutableMapOf("key40" to 40, "key50" to 50)
|
||||
val filteredMapWithNothingMatched = originalMap.filterTo(anotherDestinationMap, nonMatchingPredicate)
|
||||
assertPrints(filteredMapWithNothingMatched, "{key40=40, key50=50}")
|
||||
}
|
||||
|
||||
@Sample
|
||||
fun filter() {
|
||||
val originalMap = mapOf("key1" to 1, "key2" to 2, "key3" to 3)
|
||||
|
||||
val filteredMap = originalMap.filter { it.value < 2 }
|
||||
|
||||
assertPrints(filteredMap, "{key1=1}")
|
||||
// original map has not changed
|
||||
assertPrints(originalMap, "{key1=1, key2=2, key3=3}")
|
||||
|
||||
val nonMatchingPredicate: ((Map.Entry<String, Int>)) -> Boolean = { it.value == 0 }
|
||||
val emptyMap = originalMap.filter(nonMatchingPredicate)
|
||||
assertPrints(emptyMap, "{}")
|
||||
}
|
||||
|
||||
@Sample
|
||||
fun filterNotTo() {
|
||||
val originalMap = mapOf("key1" to 1, "key2" to 2, "key3" to 3)
|
||||
val destinationMap = mutableMapOf("key40" to 40, "key50" to 50)
|
||||
|
||||
val filteredMap = originalMap.filterNotTo(destinationMap) { it.value < 3 }
|
||||
//destination map instance has been updated
|
||||
assertTrue(destinationMap === filteredMap)
|
||||
assertPrints(destinationMap, "{key40=40, key50=50, key3=3}")
|
||||
// original map has not changed
|
||||
assertPrints(originalMap, "{key1=1, key2=2, key3=3}")
|
||||
|
||||
val anotherDestinationMap = mutableMapOf("key40" to 40, "key50" to 50)
|
||||
val matchAllPredicate: ((Map.Entry<String, Int>)) -> Boolean = { it.value > 0 }
|
||||
val filteredMapWithEverythingMatched = originalMap.filterNotTo(anotherDestinationMap, matchAllPredicate)
|
||||
assertPrints(filteredMapWithEverythingMatched, "{key40=40, key50=50}")
|
||||
}
|
||||
|
||||
@Sample
|
||||
fun filterNot() {
|
||||
val originalMap = mapOf("key1" to 1, "key2" to 2, "key3" to 3)
|
||||
|
||||
val filteredMap = originalMap.filterNot { it.value < 3 }
|
||||
assertPrints(filteredMap, "{key3=3}")
|
||||
// original map has not changed
|
||||
assertPrints(originalMap, "{key1=1, key2=2, key3=3}")
|
||||
|
||||
val matchAllPredicate: ((Map.Entry<String, Int>)) -> Boolean = { it.value > 0 }
|
||||
val emptyMap = originalMap.filterNot(matchAllPredicate)
|
||||
assertPrints(emptyMap, "{}")
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
@@ -354,7 +354,7 @@ public fun <K, V> MutableMap<in K, in V>.putAll(pairs: Sequence<Pair<K,V>>): Uni
|
||||
*
|
||||
* The returned map preserves the entry iteration order of the original map.
|
||||
*
|
||||
* @sample samples.collections.Maps.Transforms.mapValues
|
||||
* @sample samples.collections.Maps.Transformations.mapValues
|
||||
*/
|
||||
public inline fun <K, V, R> Map<out K, V>.mapValues(transform: (Map.Entry<K, V>) -> R): Map<K, R> {
|
||||
return mapValuesTo(LinkedHashMap<K, R>(mapCapacity(size)), transform) // .optimizeReadOnlyMap()
|
||||
@@ -369,7 +369,7 @@ public inline fun <K, V, R> Map<out K, V>.mapValues(transform: (Map.Entry<K, V>)
|
||||
*
|
||||
* The returned map preserves the entry iteration order of the original map.
|
||||
*
|
||||
* @sample samples.collections.Maps.Transforms.mapKeys
|
||||
* @sample samples.collections.Maps.Transformations.mapKeys
|
||||
*/
|
||||
public inline fun <K, V, R> Map<out K, V>.mapKeys(transform: (Map.Entry<K, V>) -> R): Map<R, V> {
|
||||
return mapKeysTo(LinkedHashMap<R, V>(mapCapacity(size)), transform) // .optimizeReadOnlyMap()
|
||||
@@ -379,6 +379,7 @@ public inline fun <K, V, R> Map<out K, V>.mapKeys(transform: (Map.Entry<K, V>) -
|
||||
* Returns a map containing all key-value pairs with keys matching the given [predicate].
|
||||
*
|
||||
* The returned map preserves the entry iteration order of the original map.
|
||||
* @sample samples.collections.Maps.Filtering.filterKeys
|
||||
*/
|
||||
public inline fun <K, V> Map<out K, V>.filterKeys(predicate: (K) -> Boolean): Map<K, V> {
|
||||
val result = LinkedHashMap<K, V>()
|
||||
@@ -394,6 +395,7 @@ public inline fun <K, V> Map<out K, V>.filterKeys(predicate: (K) -> Boolean): Ma
|
||||
* Returns a map containing all key-value pairs with values matching the given [predicate].
|
||||
*
|
||||
* The returned map preserves the entry iteration order of the original map.
|
||||
* @sample samples.collections.Maps.Filtering.filterValues
|
||||
*/
|
||||
public inline fun <K, V> Map<out K, V>.filterValues(predicate: (V) -> Boolean): Map<K, V> {
|
||||
val result = LinkedHashMap<K, V>()
|
||||
@@ -410,6 +412,7 @@ public inline fun <K, V> Map<out K, V>.filterValues(predicate: (V) -> Boolean):
|
||||
* Appends all entries matching the given [predicate] into the mutable map given as [destination] parameter.
|
||||
*
|
||||
* @return the destination map.
|
||||
* @sample samples.collections.Maps.Filtering.filterTo
|
||||
*/
|
||||
public inline fun <K, V, M : MutableMap<in K, in V>> Map<out K, V>.filterTo(destination: M, predicate: (Map.Entry<K, V>) -> Boolean): M {
|
||||
for (element in this) {
|
||||
@@ -424,6 +427,7 @@ public inline fun <K, V, M : MutableMap<in K, in V>> Map<out K, V>.filterTo(dest
|
||||
* Returns a new map containing all key-value pairs matching the given [predicate].
|
||||
*
|
||||
* The returned map preserves the entry iteration order of the original map.
|
||||
* @sample samples.collections.Maps.Filtering.filter
|
||||
*/
|
||||
public inline fun <K, V> Map<out K, V>.filter(predicate: (Map.Entry<K, V>) -> Boolean): Map<K, V> {
|
||||
return filterTo(LinkedHashMap<K, V>(), predicate)
|
||||
@@ -433,6 +437,7 @@ public inline fun <K, V> Map<out K, V>.filter(predicate: (Map.Entry<K, V>) -> Bo
|
||||
* Appends all entries not matching the given [predicate] into the given [destination].
|
||||
*
|
||||
* @return the destination map.
|
||||
* @sample samples.collections.Maps.Filtering.filterNotTo
|
||||
*/
|
||||
public inline fun <K, V, M : MutableMap<in K, in V>> Map<out K, V>.filterNotTo(destination: M, predicate: (Map.Entry<K, V>) -> Boolean): M {
|
||||
for (element in this) {
|
||||
@@ -447,6 +452,7 @@ public inline fun <K, V, M : MutableMap<in K, in V>> Map<out K, V>.filterNotTo(d
|
||||
* Returns a new map containing all key-value pairs not matching the given [predicate].
|
||||
*
|
||||
* The returned map preserves the entry iteration order of the original map.
|
||||
* @sample samples.collections.Maps.Filtering.filterNot
|
||||
*/
|
||||
public inline fun <K, V> Map<out K, V>.filterNot(predicate: (Map.Entry<K, V>) -> Boolean): Map<K, V> {
|
||||
return filterNotTo(LinkedHashMap<K, V>(), predicate)
|
||||
|
||||
Reference in New Issue
Block a user