array.EnsureCapacity

配列の容量を指定した値以上に拡張します

taiseiue | 2025-01-08
  • 共有
  •  記事の編集

定義

名前空間: Alice
アセンブリ: Losetta.Runtime.dll
ソースコード: Alice.Core.Array.cs

EnsureCapacity(number)

配列の容量を指定した値以上に拡張します

AliceScript
class Alice.Array;
public number EnsureCapacity(number capacity);
引数
capacity 配列の最低容量。この値は正の整数で、\(2,147,483,647\)以上である必要があります。
戻り値
number 配列の新しい容量

対応
AliceScript 該当なし
AliceSister 該当なし
Losetta 0.11

この関数はAliceScriptとAliceSisterでは実装されていません。

実装されていない環境では0x034 NOT_IMPLEMENTED例外がスローされます。

説明

このメソッドは、配列の容量が、指定した値以上であることを確認します。容量が指定値に満たない場合は拡張を行い、指定値以上の場合は何もしません。

容量の拡張が必要な場合、このメソッドは現在の容量と新しく指定したcapacityの値の和を格納できるだけのメモリを確保します。このため、このメソッドの操作は負荷の大きな作業です。このメソッドは、配列に項目を繰り返し追加し、その数がわかっているときに使用できます。

例

以下は、配列の容量を5に拡張します。

AliceScript
array ary = ["abc", "def"];

ary.EnsureCapacity(5);