Implement try_get on Array

Author: Lemiczek

godot-core/src/builtin/array.rs

@@ -394,6 +394,18 @@ impl<T: GodotType + FromGodot> Array<T> {
         T::from_variant(variant)
     }
 
+    /// Returns the value at the specified index or `None` if the index is out-of-bounds.
+    pub fn try_get(&self, index: usize) -> Option<T> {
+        let ptr = self.ptr_or_null(index);
+        if ptr.is_null() {
+            None
+        } else {
+            // SAFETY: `ptr.is_null()` just verified that the index is not out of bounds.
+            let variant = unsafe { &*ptr };
+            Some(T::from_variant(variant))
+        }
+    }
+
     /// Returns the first element in the array, or `None` if the array is empty. Equivalent of
     /// `front()` in GDScript.
     pub fn first(&self) -> Option<T> {

itest/rust/src/builtin_tests/containers/array_test.rs

@@ -167,6 +167,15 @@ fn array_get() {
     });
 }
 
+#[itest]
+fn array_try_get() {
+    let array = array![1, 2];
+
+    assert_eq!(array.try_get(0), Some(1));
+    assert_eq!(array.try_get(1), Some(2));
+    assert_eq!(array.try_get(2), None);
+}
+
 #[itest]
 fn array_first_last() {
     let array = array![1, 2];