Add OrNull for second, third, forth, fifth and penultimate

Author: JavierSegoviaCordoba

CHANGELOG.md

@@ -5,6 +5,7 @@
 ### Added
 - `isNotNullNorBlank()` and `isNotNullNorEmpty()`
 - `second()`, `third()`, `forth()`, `fifth()` and `penultimate()`
+- `OrNull` variants for `second()`, `third()`, `forth()`, `fifth()` and `penultimate()`
 
 ### Changed
 

kotlin-stdlib/api/kotlin-stdlib.api

@@ -143,11 +143,16 @@ public final class com/javiersc/kotlin/stdlib/AnsiColorsKt {
 
 public final class com/javiersc/kotlin/stdlib/CollectionsKt {
 	public static final fun fifth (Ljava/lang/Iterable;)Ljava/lang/Object;
+	public static final fun fifthOrNull (Ljava/lang/Iterable;)Ljava/lang/Object;
 	public static final fun forth (Ljava/lang/Iterable;)Ljava/lang/Object;
+	public static final fun forthOrNull (Ljava/lang/Iterable;)Ljava/lang/Object;
 	public static final fun getIndex (Ljava/lang/Iterable;I)Ljava/lang/Object;
 	public static final fun penultimate (Ljava/lang/Iterable;)Ljava/lang/Object;
+	public static final fun penultimateOrNull (Ljava/lang/Iterable;)Ljava/lang/Object;
 	public static final fun second (Ljava/lang/Iterable;)Ljava/lang/Object;
+	public static final fun secondOrNull (Ljava/lang/Iterable;)Ljava/lang/Object;
 	public static final fun third (Ljava/lang/Iterable;)Ljava/lang/Object;
+	public static final fun thirdOrNull (Ljava/lang/Iterable;)Ljava/lang/Object;
 	public static final fun throwNoSuchElementException (I)V
 }
 

kotlin-stdlib/commonMain/kotlin/Collections.kt

@@ -9,27 +9,35 @@ package com.javiersc.kotlin.stdlib
  */
 public inline fun <T> Iterable<T>.second(): T = getIndex(2)
 
+public inline fun <T> Iterable<T>.secondOrNull(): T? = runCatching { second() }.getOrNull()
+
 /**
  * Returns third element.
  *
  * Throws: `NoSuchElementException` - if the list size is 2.
  */
 public inline fun <T> Iterable<T>.third(): T = getIndex(3)
 
+public inline fun <T> Iterable<T>.thirdOrNull(): T? = runCatching { third() }.getOrNull()
+
 /**
  * Returns forth element.
  *
  * Throws: `NoSuchElementException` - if the list size is 3.
  */
 public inline fun <T> Iterable<T>.forth(): T = getIndex(4)
 
+public inline fun <T> Iterable<T>.forthOrNull(): T? = runCatching { forth() }.getOrNull()
+
 /**
  * Returns fifth element.
  *
  * Throws: `NoSuchElementException` - if the list size is 4.
  */
 public inline fun <T> Iterable<T>.fifth(): T = getIndex(5)
 
+public inline fun <T> Iterable<T>.fifthOrNull(): T? = runCatching { fifth() }.getOrNull()
+
 /**
  * Returns penultimate element.
  *
@@ -55,6 +63,9 @@ public inline fun <T> Iterable<T>.penultimate(): T {
     }
 }
 
+public inline fun <T> Iterable<T>.penultimateOrNull(): T? =
+    runCatching { penultimate() }.getOrNull()
+
 @PublishedApi
 internal inline fun <T> Iterable<T>.getIndex(index: Int): T {
     return when (this) {