Co oznacza termin 'single' w kontekście korutyn i jak jest używany?

W kontekście korutyn w Android (Kotlin), termin single odnosi się zazwyczaj do operatora lub funkcji, która zwraca dokładnie jeden element z przepływu danych (np. z Flow lub RxJava). W Kotlin Flow, single() jest operacją końcową, która oczekuje, że przepływ wyemituje dokładnie jeden element i go zwraca. Jeśli wyemitowanych zostanie więcej lub mniej niż jeden element, zostanie rzucony wyjątek.

Przykład użycia z Flow:

val flow = flowOf(42)
val value = flow.single() // zwróci 42

Jeśli przepływ jest pusty lub zawiera więcej niż jeden element, single() spowoduje błąd.

Dlatego single jest używany, gdy oczekuje się dokładnie jednego wyniku z asynchronicznego przepływu danych.