2018-07-18 23:07:57 +02:00
|
|
|
using System;
|
|
|
|
using System.Collections.Generic;
|
|
|
|
using System.Collections;
|
|
|
|
using System.Runtime.CompilerServices;
|
|
|
|
using System.Runtime.InteropServices;
|
|
|
|
|
2018-08-25 17:16:16 +02:00
|
|
|
namespace Godot.Collections
|
2018-07-18 23:07:57 +02:00
|
|
|
{
|
|
|
|
class ArraySafeHandle : SafeHandle
|
|
|
|
{
|
|
|
|
public ArraySafeHandle(IntPtr handle) : base(IntPtr.Zero, true)
|
|
|
|
{
|
|
|
|
this.handle = handle;
|
|
|
|
}
|
|
|
|
|
|
|
|
public override bool IsInvalid
|
|
|
|
{
|
2020-04-23 02:19:32 +02:00
|
|
|
get { return handle == IntPtr.Zero; }
|
2018-07-18 23:07:57 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
protected override bool ReleaseHandle()
|
|
|
|
{
|
|
|
|
Array.godot_icall_Array_Dtor(handle);
|
|
|
|
return true;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Wrapper around Godot's Array class, an array of Variant
|
|
|
|
/// typed elements allocated in the engine in C++. Useful when
|
|
|
|
/// interfacing with the engine. Otherwise prefer .NET collections
|
|
|
|
/// such as <see cref="System.Array"/> or <see cref="List{T}"/>.
|
|
|
|
/// </summary>
|
2019-03-04 21:31:04 +01:00
|
|
|
public class Array : IList, IDisposable
|
2018-07-18 23:07:57 +02:00
|
|
|
{
|
|
|
|
ArraySafeHandle safeHandle;
|
|
|
|
bool disposed = false;
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Constructs a new empty <see cref="Array"/>.
|
|
|
|
/// </summary>
|
2018-07-18 23:07:57 +02:00
|
|
|
public Array()
|
|
|
|
{
|
|
|
|
safeHandle = new ArraySafeHandle(godot_icall_Array_Ctor());
|
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Constructs a new <see cref="Array"/> from the given collection's elements.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="collection">The collection of elements to construct from.</param>
|
|
|
|
/// <returns>A new Godot Array.</returns>
|
2019-03-05 18:52:19 +01:00
|
|
|
public Array(IEnumerable collection) : this()
|
|
|
|
{
|
|
|
|
if (collection == null)
|
|
|
|
throw new NullReferenceException($"Parameter '{nameof(collection)} cannot be null.'");
|
|
|
|
|
2020-04-23 02:19:32 +02:00
|
|
|
foreach (object element in collection)
|
|
|
|
Add(element);
|
2019-03-05 18:52:19 +01:00
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Constructs a new <see cref="Array"/> from the given objects.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="array">The objects to put in the new array.</param>
|
|
|
|
/// <returns>A new Godot Array.</returns>
|
2020-09-12 23:40:08 +02:00
|
|
|
public Array(params object[] array) : this()
|
|
|
|
{
|
|
|
|
if (array == null)
|
|
|
|
{
|
|
|
|
throw new NullReferenceException($"Parameter '{nameof(array)} cannot be null.'");
|
|
|
|
}
|
|
|
|
safeHandle = new ArraySafeHandle(godot_icall_Array_Ctor_MonoArray(array));
|
|
|
|
}
|
|
|
|
|
2018-07-18 23:07:57 +02:00
|
|
|
internal Array(ArraySafeHandle handle)
|
|
|
|
{
|
|
|
|
safeHandle = handle;
|
|
|
|
}
|
|
|
|
|
|
|
|
internal Array(IntPtr handle)
|
|
|
|
{
|
|
|
|
safeHandle = new ArraySafeHandle(handle);
|
|
|
|
}
|
|
|
|
|
|
|
|
internal IntPtr GetPtr()
|
|
|
|
{
|
2019-02-19 00:37:10 +01:00
|
|
|
if (disposed)
|
|
|
|
throw new ObjectDisposedException(GetType().FullName);
|
|
|
|
|
2018-07-18 23:07:57 +02:00
|
|
|
return safeHandle.DangerousGetHandle();
|
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Duplicates this <see cref="Array"/>.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="deep">If true, performs a deep copy.</param>
|
|
|
|
/// <returns>A new Godot Array.</returns>
|
2019-12-04 14:54:33 +01:00
|
|
|
public Array Duplicate(bool deep = false)
|
|
|
|
{
|
|
|
|
return new Array(godot_icall_Array_Duplicate(GetPtr(), deep));
|
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Resizes this <see cref="Array"/> to the given size.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="newSize">The new size of the array.</param>
|
|
|
|
/// <returns><see cref="Error.Ok"/> if successful, or an error code.</returns>
|
2019-03-04 21:31:04 +01:00
|
|
|
public Error Resize(int newSize)
|
|
|
|
{
|
|
|
|
return godot_icall_Array_Resize(GetPtr(), newSize);
|
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Shuffles the contents of this <see cref="Array"/> into a random order.
|
|
|
|
/// </summary>
|
2020-11-07 09:19:23 +01:00
|
|
|
public void Shuffle()
|
|
|
|
{
|
|
|
|
godot_icall_Array_Shuffle(GetPtr());
|
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Concatenates these two <see cref="Array"/>s.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="left">The first array.</param>
|
|
|
|
/// <param name="right">The second array.</param>
|
|
|
|
/// <returns>A new Godot Array with the contents of both arrays.</returns>
|
2020-09-12 23:40:08 +02:00
|
|
|
public static Array operator +(Array left, Array right)
|
|
|
|
{
|
|
|
|
return new Array(godot_icall_Array_Concatenate(left.GetPtr(), right.GetPtr()));
|
|
|
|
}
|
|
|
|
|
2019-03-04 21:31:04 +01:00
|
|
|
// IDisposable
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Disposes of this <see cref="Array"/>.
|
|
|
|
/// </summary>
|
2018-07-18 23:07:57 +02:00
|
|
|
public void Dispose()
|
|
|
|
{
|
|
|
|
if (disposed)
|
|
|
|
return;
|
|
|
|
|
|
|
|
if (safeHandle != null)
|
|
|
|
{
|
|
|
|
safeHandle.Dispose();
|
|
|
|
safeHandle = null;
|
|
|
|
}
|
|
|
|
|
|
|
|
disposed = true;
|
|
|
|
}
|
|
|
|
|
2019-03-04 21:31:04 +01:00
|
|
|
// IList
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
bool IList.IsReadOnly => false;
|
2019-03-04 21:31:04 +01:00
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
bool IList.IsFixedSize => false;
|
2019-03-04 21:31:04 +01:00
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Returns the object at the given index.
|
|
|
|
/// </summary>
|
|
|
|
/// <value>The object at the given index.</value>
|
2018-07-18 23:07:57 +02:00
|
|
|
public object this[int index]
|
|
|
|
{
|
2019-03-04 21:31:04 +01:00
|
|
|
get => godot_icall_Array_At(GetPtr(), index);
|
|
|
|
set => godot_icall_Array_SetAt(GetPtr(), index, value);
|
2018-07-18 23:07:57 +02:00
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Adds an object to the end of this <see cref="Array"/>.
|
|
|
|
/// This is the same as `append` or `push_back` in GDScript.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="value">The object to add.</param>
|
|
|
|
/// <returns>The new size after adding the object.</returns>
|
2019-03-04 21:31:04 +01:00
|
|
|
public int Add(object value) => godot_icall_Array_Add(GetPtr(), value);
|
2018-07-18 23:07:57 +02:00
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Checks if this <see cref="Array"/> contains the given object.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="value">The item to look for.</param>
|
|
|
|
/// <returns>Whether or not this array contains the given object.</returns>
|
2019-03-04 21:31:04 +01:00
|
|
|
public bool Contains(object value) => godot_icall_Array_Contains(GetPtr(), value);
|
2018-07-18 23:07:57 +02:00
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Erases all items from this <see cref="Array"/>.
|
|
|
|
/// </summary>
|
2019-03-04 21:31:04 +01:00
|
|
|
public void Clear() => godot_icall_Array_Clear(GetPtr());
|
2018-07-18 23:07:57 +02:00
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Searches this <see cref="Array"/> for an object
|
|
|
|
/// and returns its index or -1 if not found.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="value">The object to search for.</param>
|
|
|
|
/// <returns>The index of the object, or -1 if not found.</returns>
|
2019-03-04 21:31:04 +01:00
|
|
|
public int IndexOf(object value) => godot_icall_Array_IndexOf(GetPtr(), value);
|
2018-07-18 23:07:57 +02:00
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Inserts a new object at a given position in the array.
|
|
|
|
/// The position must be a valid position of an existing item,
|
|
|
|
/// or the position at the end of the array.
|
|
|
|
/// Existing items will be moved to the right.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="index">The index to insert at.</param>
|
|
|
|
/// <param name="value">The object to insert.</param>
|
2019-03-04 21:31:04 +01:00
|
|
|
public void Insert(int index, object value) => godot_icall_Array_Insert(GetPtr(), index, value);
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Removes the first occurrence of the specified value
|
|
|
|
/// from this <see cref="Array"/>.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="value">The value to remove.</param>
|
2019-03-04 21:31:04 +01:00
|
|
|
public void Remove(object value) => godot_icall_Array_Remove(GetPtr(), value);
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Removes an element from this <see cref="Array"/> by index.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="index">The index of the element to remove.</param>
|
2019-03-04 21:31:04 +01:00
|
|
|
public void RemoveAt(int index) => godot_icall_Array_RemoveAt(GetPtr(), index);
|
|
|
|
|
|
|
|
// ICollection
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Returns the number of elements in this <see cref="Array"/>.
|
|
|
|
/// This is also known as the size or length of the array.
|
|
|
|
/// </summary>
|
|
|
|
/// <returns>The number of elements.</returns>
|
2019-03-04 21:31:04 +01:00
|
|
|
public int Count => godot_icall_Array_Count(GetPtr());
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
object ICollection.SyncRoot => this;
|
2019-03-04 21:31:04 +01:00
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
bool ICollection.IsSynchronized => false;
|
2018-07-18 23:07:57 +02:00
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Copies the elements of this <see cref="Array"/> to the given
|
|
|
|
/// untyped C# array, starting at the given index.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="array">The array to copy to.</param>
|
|
|
|
/// <param name="index">The index to start at.</param>
|
2019-03-04 21:31:04 +01:00
|
|
|
public void CopyTo(System.Array array, int index)
|
2018-07-18 23:07:57 +02:00
|
|
|
{
|
|
|
|
if (array == null)
|
|
|
|
throw new ArgumentNullException(nameof(array), "Value cannot be null.");
|
|
|
|
|
2019-03-04 21:31:04 +01:00
|
|
|
if (index < 0)
|
|
|
|
throw new ArgumentOutOfRangeException(nameof(index), "Number was less than the array's lower bound in the first dimension.");
|
2018-07-18 23:07:57 +02:00
|
|
|
|
|
|
|
// Internal call may throw ArgumentException
|
2019-03-04 21:31:04 +01:00
|
|
|
godot_icall_Array_CopyTo(GetPtr(), array, index);
|
2018-07-18 23:07:57 +02:00
|
|
|
}
|
|
|
|
|
2019-03-04 21:31:04 +01:00
|
|
|
// IEnumerable
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Gets an enumerator for this <see cref="Array"/>.
|
|
|
|
/// </summary>
|
|
|
|
/// <returns>An enumerator.</returns>
|
2019-03-04 21:31:04 +01:00
|
|
|
public IEnumerator GetEnumerator()
|
2018-07-18 23:07:57 +02:00
|
|
|
{
|
|
|
|
int count = Count;
|
|
|
|
|
|
|
|
for (int i = 0; i < count; i++)
|
|
|
|
{
|
2018-09-27 00:11:31 +02:00
|
|
|
yield return this[i];
|
2018-07-18 23:07:57 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Converts this <see cref="Array"/> to a string.
|
|
|
|
/// </summary>
|
|
|
|
/// <returns>A string representation of this array.</returns>
|
2019-04-18 14:48:10 +02:00
|
|
|
public override string ToString()
|
|
|
|
{
|
|
|
|
return godot_icall_Array_ToString(GetPtr());
|
|
|
|
}
|
|
|
|
|
2018-09-04 05:40:41 +02:00
|
|
|
[MethodImpl(MethodImplOptions.InternalCall)]
|
|
|
|
internal extern static IntPtr godot_icall_Array_Ctor();
|
|
|
|
|
2020-09-12 23:40:08 +02:00
|
|
|
[MethodImpl(MethodImplOptions.InternalCall)]
|
|
|
|
internal extern static IntPtr godot_icall_Array_Ctor_MonoArray(System.Array array);
|
|
|
|
|
2018-09-04 05:40:41 +02:00
|
|
|
[MethodImpl(MethodImplOptions.InternalCall)]
|
|
|
|
internal extern static void godot_icall_Array_Dtor(IntPtr ptr);
|
|
|
|
|
|
|
|
[MethodImpl(MethodImplOptions.InternalCall)]
|
|
|
|
internal extern static object godot_icall_Array_At(IntPtr ptr, int index);
|
|
|
|
|
2018-09-27 00:11:31 +02:00
|
|
|
[MethodImpl(MethodImplOptions.InternalCall)]
|
|
|
|
internal extern static object godot_icall_Array_At_Generic(IntPtr ptr, int index, int elemTypeEncoding, IntPtr elemTypeClass);
|
|
|
|
|
2018-09-04 05:40:41 +02:00
|
|
|
[MethodImpl(MethodImplOptions.InternalCall)]
|
|
|
|
internal extern static void godot_icall_Array_SetAt(IntPtr ptr, int index, object value);
|
|
|
|
|
|
|
|
[MethodImpl(MethodImplOptions.InternalCall)]
|
|
|
|
internal extern static int godot_icall_Array_Count(IntPtr ptr);
|
|
|
|
|
|
|
|
[MethodImpl(MethodImplOptions.InternalCall)]
|
2019-03-04 21:31:04 +01:00
|
|
|
internal extern static int godot_icall_Array_Add(IntPtr ptr, object item);
|
2018-09-04 05:40:41 +02:00
|
|
|
|
|
|
|
[MethodImpl(MethodImplOptions.InternalCall)]
|
|
|
|
internal extern static void godot_icall_Array_Clear(IntPtr ptr);
|
|
|
|
|
2020-09-12 23:40:08 +02:00
|
|
|
[MethodImpl(MethodImplOptions.InternalCall)]
|
|
|
|
internal extern static IntPtr godot_icall_Array_Concatenate(IntPtr left, IntPtr right);
|
|
|
|
|
2018-09-04 05:40:41 +02:00
|
|
|
[MethodImpl(MethodImplOptions.InternalCall)]
|
|
|
|
internal extern static bool godot_icall_Array_Contains(IntPtr ptr, object item);
|
|
|
|
|
|
|
|
[MethodImpl(MethodImplOptions.InternalCall)]
|
2019-03-04 21:31:04 +01:00
|
|
|
internal extern static void godot_icall_Array_CopyTo(IntPtr ptr, System.Array array, int arrayIndex);
|
2018-09-04 05:40:41 +02:00
|
|
|
|
2019-12-04 14:54:33 +01:00
|
|
|
[MethodImpl(MethodImplOptions.InternalCall)]
|
|
|
|
internal extern static IntPtr godot_icall_Array_Duplicate(IntPtr ptr, bool deep);
|
|
|
|
|
2018-09-04 05:40:41 +02:00
|
|
|
[MethodImpl(MethodImplOptions.InternalCall)]
|
|
|
|
internal extern static int godot_icall_Array_IndexOf(IntPtr ptr, object item);
|
|
|
|
|
|
|
|
[MethodImpl(MethodImplOptions.InternalCall)]
|
|
|
|
internal extern static void godot_icall_Array_Insert(IntPtr ptr, int index, object item);
|
|
|
|
|
|
|
|
[MethodImpl(MethodImplOptions.InternalCall)]
|
|
|
|
internal extern static bool godot_icall_Array_Remove(IntPtr ptr, object item);
|
|
|
|
|
|
|
|
[MethodImpl(MethodImplOptions.InternalCall)]
|
|
|
|
internal extern static void godot_icall_Array_RemoveAt(IntPtr ptr, int index);
|
2018-09-27 00:11:31 +02:00
|
|
|
|
2019-02-28 18:33:42 +01:00
|
|
|
[MethodImpl(MethodImplOptions.InternalCall)]
|
|
|
|
internal extern static Error godot_icall_Array_Resize(IntPtr ptr, int newSize);
|
|
|
|
|
2020-11-07 09:19:23 +01:00
|
|
|
[MethodImpl(MethodImplOptions.InternalCall)]
|
|
|
|
internal extern static Error godot_icall_Array_Shuffle(IntPtr ptr);
|
|
|
|
|
2018-09-27 00:11:31 +02:00
|
|
|
[MethodImpl(MethodImplOptions.InternalCall)]
|
|
|
|
internal extern static void godot_icall_Array_Generic_GetElementTypeInfo(Type elemType, out int elemTypeEncoding, out IntPtr elemTypeClass);
|
2019-04-18 14:48:10 +02:00
|
|
|
|
|
|
|
[MethodImpl(MethodImplOptions.InternalCall)]
|
|
|
|
internal extern static string godot_icall_Array_ToString(IntPtr ptr);
|
2018-07-18 23:07:57 +02:00
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Typed wrapper around Godot's Array class, an array of Variant
|
|
|
|
/// typed elements allocated in the engine in C++. Useful when
|
|
|
|
/// interfacing with the engine. Otherwise prefer .NET collections
|
|
|
|
/// such as arrays or <see cref="List{T}"/>.
|
|
|
|
/// </summary>
|
|
|
|
/// <typeparam name="T">The type of the array.</typeparam>
|
2018-07-18 23:07:57 +02:00
|
|
|
public class Array<T> : IList<T>, ICollection<T>, IEnumerable<T>
|
|
|
|
{
|
|
|
|
Array objectArray;
|
|
|
|
|
2018-09-27 00:11:31 +02:00
|
|
|
internal static int elemTypeEncoding;
|
|
|
|
internal static IntPtr elemTypeClass;
|
|
|
|
|
|
|
|
static Array()
|
|
|
|
{
|
|
|
|
Array.godot_icall_Array_Generic_GetElementTypeInfo(typeof(T), out elemTypeEncoding, out elemTypeClass);
|
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Constructs a new empty <see cref="Array{T}"/>.
|
|
|
|
/// </summary>
|
2018-07-18 23:07:57 +02:00
|
|
|
public Array()
|
|
|
|
{
|
|
|
|
objectArray = new Array();
|
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Constructs a new <see cref="Array{T}"/> from the given collection's elements.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="collection">The collection of elements to construct from.</param>
|
|
|
|
/// <returns>A new Godot Array.</returns>
|
2019-03-05 18:52:19 +01:00
|
|
|
public Array(IEnumerable<T> collection)
|
|
|
|
{
|
|
|
|
if (collection == null)
|
|
|
|
throw new NullReferenceException($"Parameter '{nameof(collection)} cannot be null.'");
|
|
|
|
|
|
|
|
objectArray = new Array(collection);
|
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Constructs a new <see cref="Array{T}"/> from the given items.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="array">The items to put in the new array.</param>
|
|
|
|
/// <returns>A new Godot Array.</returns>
|
2020-09-12 23:40:08 +02:00
|
|
|
public Array(params T[] array) : this()
|
|
|
|
{
|
|
|
|
if (array == null)
|
|
|
|
{
|
|
|
|
throw new NullReferenceException($"Parameter '{nameof(array)} cannot be null.'");
|
|
|
|
}
|
|
|
|
objectArray = new Array(array);
|
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Constructs a typed <see cref="Array{T}"/> from an untyped <see cref="Array"/>.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="array">The untyped array to construct from.</param>
|
2018-07-18 23:07:57 +02:00
|
|
|
public Array(Array array)
|
|
|
|
{
|
|
|
|
objectArray = array;
|
|
|
|
}
|
|
|
|
|
|
|
|
internal Array(IntPtr handle)
|
|
|
|
{
|
|
|
|
objectArray = new Array(handle);
|
|
|
|
}
|
|
|
|
|
|
|
|
internal Array(ArraySafeHandle handle)
|
|
|
|
{
|
|
|
|
objectArray = new Array(handle);
|
|
|
|
}
|
|
|
|
|
2019-03-04 21:31:04 +01:00
|
|
|
internal IntPtr GetPtr()
|
|
|
|
{
|
|
|
|
return objectArray.GetPtr();
|
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Converts this typed <see cref="Array{T}"/> to an untyped <see cref="Array"/>.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="from">The typed array to convert.</param>
|
2018-07-18 23:07:57 +02:00
|
|
|
public static explicit operator Array(Array<T> from)
|
|
|
|
{
|
|
|
|
return from.objectArray;
|
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Duplicates this <see cref="Array{T}"/>.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="deep">If true, performs a deep copy.</param>
|
|
|
|
/// <returns>A new Godot Array.</returns>
|
2019-12-04 14:54:33 +01:00
|
|
|
public Array<T> Duplicate(bool deep = false)
|
|
|
|
{
|
|
|
|
return new Array<T>(objectArray.Duplicate(deep));
|
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Resizes this <see cref="Array{T}"/> to the given size.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="newSize">The new size of the array.</param>
|
|
|
|
/// <returns><see cref="Error.Ok"/> if successful, or an error code.</returns>
|
2019-03-04 21:31:04 +01:00
|
|
|
public Error Resize(int newSize)
|
|
|
|
{
|
|
|
|
return objectArray.Resize(newSize);
|
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Shuffles the contents of this <see cref="Array{T}"/> into a random order.
|
|
|
|
/// </summary>
|
2020-11-07 09:19:23 +01:00
|
|
|
public void Shuffle()
|
|
|
|
{
|
|
|
|
objectArray.Shuffle();
|
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Concatenates these two <see cref="Array{T}"/>s.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="left">The first array.</param>
|
|
|
|
/// <param name="right">The second array.</param>
|
|
|
|
/// <returns>A new Godot Array with the contents of both arrays.</returns>
|
2020-09-12 23:40:08 +02:00
|
|
|
public static Array<T> operator +(Array<T> left, Array<T> right)
|
|
|
|
{
|
|
|
|
return new Array<T>(left.objectArray + right.objectArray);
|
|
|
|
}
|
|
|
|
|
2019-03-04 21:31:04 +01:00
|
|
|
// IList<T>
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Returns the value at the given index.
|
|
|
|
/// </summary>
|
|
|
|
/// <value>The value at the given index.</value>
|
2018-07-18 23:07:57 +02:00
|
|
|
public T this[int index]
|
|
|
|
{
|
2020-04-23 02:19:32 +02:00
|
|
|
get { return (T)Array.godot_icall_Array_At_Generic(GetPtr(), index, elemTypeEncoding, elemTypeClass); }
|
|
|
|
set { objectArray[index] = value; }
|
2018-07-18 23:07:57 +02:00
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Searches this <see cref="Array{T}"/> for an item
|
|
|
|
/// and returns its index or -1 if not found.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="item">The item to search for.</param>
|
|
|
|
/// <returns>The index of the item, or -1 if not found.</returns>
|
2019-03-04 21:31:04 +01:00
|
|
|
public int IndexOf(T item)
|
|
|
|
{
|
|
|
|
return objectArray.IndexOf(item);
|
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Inserts a new item at a given position in the <see cref="Array{T}"/>.
|
|
|
|
/// The position must be a valid position of an existing item,
|
|
|
|
/// or the position at the end of the array.
|
|
|
|
/// Existing items will be moved to the right.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="index">The index to insert at.</param>
|
|
|
|
/// <param name="item">The item to insert.</param>
|
2019-03-04 21:31:04 +01:00
|
|
|
public void Insert(int index, T item)
|
|
|
|
{
|
|
|
|
objectArray.Insert(index, item);
|
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Removes an element from this <see cref="Array{T}"/> by index.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="index">The index of the element to remove.</param>
|
2019-03-04 21:31:04 +01:00
|
|
|
public void RemoveAt(int index)
|
|
|
|
{
|
|
|
|
objectArray.RemoveAt(index);
|
|
|
|
}
|
|
|
|
|
|
|
|
// ICollection<T>
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Returns the number of elements in this <see cref="Array{T}"/>.
|
|
|
|
/// This is also known as the size or length of the array.
|
|
|
|
/// </summary>
|
|
|
|
/// <returns>The number of elements.</returns>
|
2018-07-18 23:07:57 +02:00
|
|
|
public int Count
|
|
|
|
{
|
2020-04-23 02:19:32 +02:00
|
|
|
get { return objectArray.Count; }
|
2018-07-18 23:07:57 +02:00
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
bool ICollection<T>.IsReadOnly => false;
|
2018-07-18 23:07:57 +02:00
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Adds an item to the end of this <see cref="Array{T}"/>.
|
|
|
|
/// This is the same as `append` or `push_back` in GDScript.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="item">The item to add.</param>
|
|
|
|
/// <returns>The new size after adding the item.</returns>
|
2018-07-18 23:07:57 +02:00
|
|
|
public void Add(T item)
|
|
|
|
{
|
|
|
|
objectArray.Add(item);
|
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Erases all items from this <see cref="Array{T}"/>.
|
|
|
|
/// </summary>
|
2018-07-18 23:07:57 +02:00
|
|
|
public void Clear()
|
|
|
|
{
|
|
|
|
objectArray.Clear();
|
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Checks if this <see cref="Array{T}"/> contains the given item.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="item">The item to look for.</param>
|
|
|
|
/// <returns>Whether or not this array contains the given item.</returns>
|
2018-07-18 23:07:57 +02:00
|
|
|
public bool Contains(T item)
|
|
|
|
{
|
|
|
|
return objectArray.Contains(item);
|
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Copies the elements of this <see cref="Array{T}"/> to the given
|
|
|
|
/// C# array, starting at the given index.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="array">The C# array to copy to.</param>
|
|
|
|
/// <param name="arrayIndex">The index to start at.</param>
|
2018-07-18 23:07:57 +02:00
|
|
|
public void CopyTo(T[] array, int arrayIndex)
|
|
|
|
{
|
|
|
|
if (array == null)
|
|
|
|
throw new ArgumentNullException(nameof(array), "Value cannot be null.");
|
|
|
|
|
|
|
|
if (arrayIndex < 0)
|
|
|
|
throw new ArgumentOutOfRangeException(nameof(arrayIndex), "Number was less than the array's lower bound in the first dimension.");
|
|
|
|
|
|
|
|
// TODO This may be quite slow because every element access is an internal call.
|
|
|
|
// It could be moved entirely to an internal call if we find out how to do the cast there.
|
|
|
|
|
|
|
|
int count = objectArray.Count;
|
|
|
|
|
|
|
|
if (array.Length < (arrayIndex + count))
|
|
|
|
throw new ArgumentException("Destination array was not long enough. Check destIndex and length, and the array's lower bounds.");
|
|
|
|
|
|
|
|
for (int i = 0; i < count; i++)
|
|
|
|
{
|
2018-09-27 00:11:31 +02:00
|
|
|
array[arrayIndex] = (T)this[i];
|
2018-07-18 23:07:57 +02:00
|
|
|
arrayIndex++;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Removes the first occurrence of the specified value
|
|
|
|
/// from this <see cref="Array{T}"/>.
|
|
|
|
/// </summary>
|
|
|
|
/// <param name="item">The value to remove.</param>
|
|
|
|
/// <returns>A bool indicating success or failure.</returns>
|
2019-03-04 21:31:04 +01:00
|
|
|
public bool Remove(T item)
|
|
|
|
{
|
|
|
|
return Array.godot_icall_Array_Remove(GetPtr(), item);
|
|
|
|
}
|
|
|
|
|
|
|
|
// IEnumerable<T>
|
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Gets an enumerator for this <see cref="Array{T}"/>.
|
|
|
|
/// </summary>
|
|
|
|
/// <returns>An enumerator.</returns>
|
2018-07-18 23:07:57 +02:00
|
|
|
public IEnumerator<T> GetEnumerator()
|
|
|
|
{
|
|
|
|
int count = objectArray.Count;
|
|
|
|
|
|
|
|
for (int i = 0; i < count; i++)
|
|
|
|
{
|
2018-09-27 00:11:31 +02:00
|
|
|
yield return (T)this[i];
|
2018-07-18 23:07:57 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
IEnumerator IEnumerable.GetEnumerator()
|
|
|
|
{
|
|
|
|
return GetEnumerator();
|
|
|
|
}
|
2019-04-18 14:48:10 +02:00
|
|
|
|
2021-07-25 20:41:57 +02:00
|
|
|
/// <summary>
|
|
|
|
/// Converts this <see cref="Array{T}"/> to a string.
|
|
|
|
/// </summary>
|
|
|
|
/// <returns>A string representation of this array.</returns>
|
2019-04-18 14:48:10 +02:00
|
|
|
public override string ToString() => objectArray.ToString();
|
2018-07-18 23:07:57 +02:00
|
|
|
}
|
|
|
|
}
|