Термини 'single' дар контексти корутин чӣ маъно дорад ва чӣ гуна истифода мешавад?

Дар контексти корутинҳо дар Android (Kotlin), истилоҳ single одатан ба оператор ё функсия ишора мекунад, ки танҳо як унсурро аз ҷараёни маълумот (масалан, аз Flow ё RxJava) бармегардонад. Дар Kotlin Flow, single() як амалиёти охирин аст, ки интизор аст, ки ҷараён танҳо як унсурро интиқол медиҳад ва онро бармегардонад. Агар бештар ё камтар аз як унсур интиқол дода шавад, истисно бароварда мешавад.

Масалан бо Flow:

val flow = flowOf(42)
val value = flow.single() // бармегардонад 42

Агар ҷараён холӣ бошад ё бештар аз як унсур дошта бошад, single() хато мекунад.

Аз ин рӯ, single вақте истифода мешавад, ки интизор ҳастем, ки танҳо як натиҷа аз ҷараёни асинхронӣ баромад мекунад.