kotlin.text から5選

# 前書き
この記事を投稿するまでにだいぶ時間が空いてしまいましたが、Kotlin Fest 2019 に参加してきました。
いくつか講演を聞く中で、Kotlin について慣れるまではなかなか Kotlin らしい書き方をするのは難しいかもしれないが、kotlin.text パッケージの機能を使ってみたりすると良いのではないかというのがありました（要約にして意訳）

そこでほぼ[公式](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.text/index.html)からの写経になってしまいますが、いくつか試して理解を進めたものを残しておきます。
コードはAndroid StudioのREPL(Kotlin version 1.3.31)で確認しております。

## all
```kotlin 
inline fun CharSequence.all(
    predicate: (Char) -> Boolean
): Boolean
```
すべての文字が指定されたpredicateと一致するかどうかを返します。

```kotlin:sample
// CharRange型に abc を格納します
val range_a_c = 'a'..'c'
// 引数で渡された文字が range_a_c に含まれていたら true を返す predicate
val isInRange: (Char) -> Boolean = { it in range_a_c }

val alphabet_a_g = "abcdefg"
println("alphabet_a_g.all { isInRange(it) } is ${alphabet_a_g.all { isInRange(it) }}") // false

val alphabet_a_c = "abc"
println("alphabet_a_c.all { isInRange(it) } is ${alphabet_a_c.all { isInRange(it) }}") // true
```
## isLetter
いきなりなんか普通っぽいセレクトになりましたが次で使うため（笑）

```kotlin
fun Char.isLetter(): Boolean
```
文字であるかどうかを返却します。

```kotlin:sample
val chars = listOf('a', 'あ', '&', '9')
// partition を用いて、isLetter() により、文字とそうでないものを分ける
val (letters, notLetters) = chars.partition { it.isLetter() }
println(letters) // [a, あ]
println(notLetters) // [&, 9]
```
##takeなんちゃら4種
```kotlin
fun CharSequence.take(n: Int): CharSequence
```
文字列の先頭からn文字を返却します。
nより文字列が短い場合は文字列全体を返却します。

```kotlin
fun CharSequence.takeLast(n: Int): CharSequence
```
文字列の最後からn文字を返却します。
nより文字列が短い場合は文字列全体を返却します。

```kotlin
inline fun CharSequence.takeWhile(
    predicate: (Char) -> Boolean
): CharSequence
```
文字列から指定された predicate を満たす最初の文字列を返却します。

```kotlin
inline fun CharSequence.takeLastWhile(
    predicate: (Char) -> Boolean
): CharSequence
```
文字列から指定された predicate を満たす最後の文字列を返却します。

```kotlin:sample
val string = "+++ *** TAKE &&& SAMPLE >>>"
println(string.take(12)) //+++ *** TAKE
println(string.takeLast(10)) //SAMPLE >>>
println(string.takeWhile { !it.isLetter() }) //+++ *** 
println(string.takeLastWhile { !it.isLetter() }) // >>>
```
##zip
指定された変換関数 (transform) を文字の各ペアに適用して、このインデックスと同じインデックスを持つ他の文字列 (other) から構築された値のリストを返します。返されるリストは、最短の文字列の長さとなります。

```kotlin
inline fun <V> CharSequence.zip(
    other: CharSequence,
    transform: (a: Char, b: Char) -> V
): List<V>
```
```kotlin:sample
val stringA = "abcd"
val stringB = "zyx"
// {} 内が transform にあたるラムダ式
val result = stringA.zip(stringB) { a, b -> "$a$b" }
// stringBのほうが短いため、stringBの長さの配列が返却される
println(result) // [az, by, cx]
```
##chunked
```kotlin 
fun <R> CharSequence.chunked(
    size: Int,
    transform: (CharSequence) -> R
): List<R>
```
文字列を、指定されたサイズを超えない複数の文字列に分割し、指定された transform をそれぞれに適用した結果の配列を返却します。

```kotlin:sample
val table = mapOf("MLB" to "Baseball", "NFL" to "Football", "NBA" to "Basketball", "NHL" to "Hockey", "QB" to "quarterback")
val concatenated = "MLBNHLNFLMLSNBAQB"

// concatenated を 3文字ずつに分けて、transform を適用する
// 最後は3文字に満たない範囲で分割する
// table に無い場合は、"Unknown" とする
val results = concatenated.chunked(3) { 
abbreviation: CharSequence -> table[abbreviation.toString()] ?: "Unknown" }

println(results) // [Baseball, Hockey, Football, Unknown, Basketball, quarterback]
```
# 後書き
正直な話、Qiita投稿練習用の記事ではありましたが、Kotlinの基礎的なところを見直す機会となりました。
「それでも少しは目新しいものを」とか欲を出したせいで、
普通にアプリを作る上では、使いどころに困るものも選んでしまった感があります。