Add iterator firstOrNull

1 files changed, 12 insertions, 0 deletions

diff --git a/core/src/main/kotlin/ca/allanwang/kau/kotlin/Streams.kt b/core/src/main/kotlin/ca/allanwang/kau/kotlin/Streams.kt
index 0da6d7a..303153f 100644
--- a/core/src/main/kotlin/ca/allanwang/kau/kotlin/Streams.kt
+++ b/core/src/main/kotlin/ca/allanwang/kau/kotlin/Streams.kt
@@ -15,4 +15,16 @@ inline fun <T, C : MutableIterable<T>> C.kauRemoveIf(filter: (item: T) -> Boolea
     while (iter.hasNext())
         if (filter(iter.next())) iter.remove()
     return this
+}
+
+/**
+ * Returns the first element tha matches the predicate,
+ * or null if no match is found
+ */
+inline fun <T : Any> Iterator<T>.firstOrNull(predicate: (T) -> Boolean): T? {
+    while (hasNext()) {
+        val data = next()
+        if (predicate(data)) return data
+    }
+    return null
 }
\ No newline at end of file