Ką reiškia terminas 'single' korutinų kontekste ir kaip jis naudojamas?

Kontekste su Kotlin korutinų Android programoje, terminas single dažniausiai reiškia operatorių arba funkciją, kuri grąžina būtent vieną elementą iš duomenų srauto (pvz., iš Flow arba RxJava). Kotlin Flow single() yra terminalinė operacija, kuri tikisi, kad srautas išleis būtent vieną elementą ir jį grąžins. Jei išleidžiama daugiau arba mažiau nei vienas elementas, bus išmesta išimtis.

Pavyzdys su Flow:

val flow = flowOf(42)
val value = flow.single() // grąžins 42

Jei srautas yra tuščias arba jame yra daugiau nei vienas elementas, single() sukels klaidą.

Todėl single naudojamas, kai tikimasi, kad iš asinchroninio duomenų srauto gausime būtent vieną rezultatą.