Instance Method インスタンスメソッド

insert(_:at:)

Inserts a given object into the array’s contents at a given index. 与えられたオブジェクトを配列の持つ内容へと与えられたインデックスで挿入します。

Declaration 宣言

func insert(_ anObject: Any, 
         at index: Int)

Parameters パラメータ

anObject

The object to add to the array's content. This value must not be nil. 配列の内容に追加することになるオブジェクト。この値は、nilではいけません。

index

The index in the array at which to insert anObject. This value must not be greater than the count of elements in the array. それでanObjectを挿入することになるこの配列の中のインデックス。この値は、配列の中の要素の数より多くてはいけません。

Discussion 議論

If index is already occupied, the objects at index and beyond are shifted by adding 1 to their indices to make room. indexが既に占有されるならば、indexでのそしてその先のオブジェクトは、1をそれらのインデックスに加えることによってずらされて場所を空けます。

Note that NSArray objects are not like C arrays. That is, even though you specify a size when you create an array, the specified size is regarded as a “hint”; the actual size of the array is still 0. This means that you cannot insert an object at an index greater than the current count of an array. For example, if an array contains two objects, its size is 2, so you can add objects at indices 0, 1, or 2. Index 3 is illegal and out of bounds; if you try to add an object at index 3 (when the size of the array is 2), NSMutableArray raises an exception. NSArrayオブジェクトはC配列と似ていないことに注意してください。すなわち、たとえあなたがある配列を作成するときにサイズを指定するとしても、指定されたサイズはひとつの “ヒント” としてとらえられます;その配列の実際のサイズはまだ0です。これは、あなたが配列の現在の総数より大きいインデックスでオブジェクトを挿入できないことを意味します。例えば、ある配列が2つのオブジェクトを含むならば、それのサイズは2です、それであなたはオブジェクトをインデックス0、1、または2で追加できます。インデックス3は非合法でそして境界外です;あなたがオブジェクトをインデックス3で追加しようとするならば(配列のサイズが2の時に)、NSMutableArrayは例外を引き起こします。

See Also 参照

Adding Objects オブジェクトを追加する

Related Documentation 関連文書