Kotlin 陣列 - reverse() 函式

---

---

Kotlin 陣列 reverse() 函式用於就地反轉指定範圍內的陣列元素。

此函式反轉指定範圍內的元素。如果沒有指定範圍，則反轉陣列的所有元素。

異常

以下是異常：

• IndexOutOfBoundsException - 如果 fromIndex 小於零或 toIndex 大於此陣列的大小。

• IllegalArgumentException - 如果 fromIndex 大於 toIndex。

語法

以下是 Kotlin 陣列 reverse() 函式的語法：

fun <T> Array<T>.reverse()
,or
fun <T> Array<T>.reverse(fromIndex: Int, toIndex: Int)

引數

此函式接受以下引數：

• fromIndex - 表示要反轉的範圍的起始位置（包含）。

• toIndex - 表示要反轉的範圍的結束位置（不包含）。

返回值

該函式返回反序的陣列或集合。

示例 1

以下是一個演示 reverse() 函式用法的基本示例：

fun main(args: Array<String>) {
   val numbers = arrayOf(1, 2, 3, 4, 5)
   numbers.reverse()
   println("Reversed elements: ${numbers.joinToString(", ")}")
}

輸出

以上程式碼生成以下輸出：

Reversed elements: 5, 4, 3, 2, 1

示例 2

此示例建立一個數組，並就地反轉指定範圍內的陣列元素：

fun main(args: Array<String>) {
   val numbers = arrayOf(1, 2, 3, 4, 5)
   
   // specify the start and last index
   numbers.reverse(2, 5)
   println("Reversed elements: ${numbers.joinToString(", ")}")
}

輸出

以下是輸出：

Reversed elements: 1, 2, 5, 4, 3

示例 3

在下面的示例中，使用 reverse() 函式檢查如果 toIndex 大於陣列的大小，輸出將會是什麼：

fun main(args: Array<String>) {
   val numbers = arrayOf<String>("Hii", "This", "is", "tutorialspoint")
   
   // specify the start and last index
   numbers.reverse(2, 5)
   println("Reversed elements: ${numbers.joinToString(", ")}")
}

輸出

如果 toIndex 大於陣列大小，以上程式碼將丟擲異常：

Exception in thread "main" java.lang.IndexOutOfBoundsException: fromIndex: 2, toIndex: 5, size: 4