メインコンテンツまでスキップ

CrZ_Array

CrZ_Array<T> は、固定長の配列をその場（in place）で操作する ための静的ヘルパークラスです。Udon には List<T> がないため、これらのメソッドを使うことで、長さが変わらない配列に対して要素の検索・一括設定・挿入・削除を行えます。空きスロットは本物の null ではなく、呼び出し側が指定したセンチネルの null 値（例: -1 や ""）で表します。

一部のメソッド（InsertValue、RemoveValue、RemoveValueByValue、Length）は、配列が 左詰め（実際の値がすべて先頭に並び、その後ろは nullValue のスロットだけになっている）で管理されていることを前提としており、結果が意味を持つのはこのレイアウトが保たれている場合のみです。

配列を実際に拡張・縮小する操作が必要な場合は、代わりに CrZ_ResizableArray を使用してください。

public static class CrZ_Array<T> where T : System.IComparable<T>

型引数 T は System.IComparable<T> を実装している必要があります（SortArrayAscending で必要）。

メソッド​

InitializeArray​

配列のすべてのスロットを同じ値に設定します。array が null の場合は何もしません。

public static void InitializeArray(T[] array, T value)

パラメータ:

パラメータ型説明
arrayT[]埋める対象の配列。
valueTすべてのインデックスに書き込む値。

Exists​

値が配列内に存在するかどうかを返します。

public static bool Exists(T[] array, T value)

パラメータ:

パラメータ型説明
arrayT[]検索対象の配列。
valueT探す値。

戻り値: 値が見つかれば true。見つからない場合や array が null の場合は false。

Index​

値が最初に出現するインデックスを返します。

public static int Index(T[] array, T value)

パラメータ:

パラメータ型説明
arrayT[]検索対象の配列。
valueT探す値。

戻り値: 最初に一致した位置の 0 始まりのインデックス。値がない場合や array が null の場合は -1。

Length​

配列の先頭から、nullValue と等しいスロットが見つかるまで前方向にスキャンし、埋まっているスロット数を数えます。配列が左詰めになっていること（上記のクラスの説明を参照）に依存しており、左詰めの配列であれば、これは配列の固定容量ではなく実際の要素数になります。

public static int Length(T[] array, T nullValue)

パラメータ:

パラメータ型説明
arrayT[]測定対象の配列。
nullValueT空きスロットを表すセンチネル値。

戻り値: 最初に nullValue が現れるスロットのインデックス。すべてのスロットが埋まっている場合は array.Length。array が null の場合は 0。

InsertValue​

現在 nullValue を保持している最初のスロットに value を書き込みます。空きスロットがない場合、配列は変更されません。

public static void InsertValue(T[] array, T value, T nullValue)

パラメータ:

パラメータ型説明
arrayT[]挿入対象の配列。
valueT格納する値。
nullValueT空きスロットを表すセンチネル値（例: "" や -1）。

RemoveValueByValue​

valueToRemove の最初の出現を削除します。それより後ろの要素はすべて 1 つ前へ詰められ、末尾のスロットには nullValue が設定されます。値が見つからない場合は何もしません。

public static void RemoveValueByValue(T[] array, T valueToRemove, T nullValue)

パラメータ:

パラメータ型説明
arrayT[]変更対象の配列。
valueToRemoveT削除する値。
nullValueT末尾の空いたスロットに書き込むセンチネル値。

RemoveValue​

pos の位置の要素を削除します。それより後ろの要素はすべて 1 つ前へ詰められ、末尾のスロットには nullValue が設定されます。pos が範囲外、または array が null の場合は何もしません。

public static void RemoveValue(T[] array, int pos, T nullValue)

パラメータ:

パラメータ型説明
arrayT[]変更対象の配列。
posint削除する要素の 0 始まりのインデックス。
nullValueT末尾の空いたスロットに書き込むセンチネル値。

SortArrayAscending​

選択ソートと T.CompareTo を使い、配列を昇順にその場でソートします。array が null の場合は何もしません。

public static void SortArrayAscending(T[] array)

パラメータ:

パラメータ型説明
arrayT[]ソート対象の配列。