Mit jelent a 'single' kifejezés a coroutine-ok kontextusában, és hogyan használják?

Android (Kotlin) kontextusában a korutinoknál a single kifejezés általában arra az operátorra vagy függvényre utal, amely pontosan egy elemet ad vissza egy adatfolyamból (például Flow vagy RxJava). Kotlin Flow esetén a single() egy végrehajtási művelet, amely arra vár, hogy a folyamat pontosan egy elemet küldjön ki, és azt visszaadja. Ha több vagy kevesebb elemet küld ki, kivétel keletkezik.

Példa Flow-val:

val flow = flowOf(42)
val value = flow.single() // 42-t ad vissza

Ha a folyamat üres vagy több elemet tartalmaz, a single() hibát fog generálni.

Ezért a single akkor használatos, amikor pontosan egy eredményt várunk egy aszinkron adatfolyamból.