Mida tähendab termin 'single' korutinoteegis ja kuidas seda kasutatakse?

Kontekstis korutinates Androidis (Kotlin) termin single tavaliselt viitab operaatorile või funktsioonile, mis tagastab täpselt ühe elemendi andmevoost (näiteks Flow või RxJava). Kotlin Flow puhul on single() lõppoperatsioon, mis ootab, et voog emiteerib täpselt ühe elemendi ja tagastab selle. Kui voog emiteerib rohkem või vähem kui ühe elementi, visatakse erind.

Näide Flow kasutamisest:

val flow = flowOf(42)
val value = flow.single() // tagastab 42

Kui voog on tühi või sisaldab rohkem kui ühte elementi, tekitab single() vea.

Seetõttu kasutatakse single-i siis, kui oodatakse täpselt ühte tulemust asünkroonsest andmevoost.