※この翻訳ドキュメントはスクリプトによって出力・同期されています。内容が怪しそうな場合はGitHubにissueを追加したり英語の原文の確認をお願いします。

Array クラスの insert と insert_at のインターフェイス

このページではArrayクラスのinsertinsert_atメソッドの各インターフェイスについて説明します。

各インターフェイスの概要

insertinsert_atメソッドの各インターフェイスは任意の値を配列の指定されたインデックスへと追加します。それぞれの員スターフェイスは同じ挙動をします(insertメソッドはinsert_atメソッドのエイリアスとなっています)。

基本的な使い方

insertinsert_atメソッドはindexvalueの同じ引数を持っています。index引数はPythonビルトインのintとapyscのIntクラスの値を受け付けます。

import apysc as ap

ap.Stage()
arr: ap.Array[int] = ap.Array([1, 4])
arr.insert(index=1, value=2)
assert arr == [1, 2, 4]

index: ap.Int = ap.Int(2)
arr.insert_at(index=index, value=3)
assert arr == [1, 2, 3, 4]

insert API

特記事項: このAPIドキュメントはドキュメントビルド用のスクリプトによって自動で生成・同期されています。そのためもしかしたらこの節の内容は前節までの内容と重複している場合があります。

[インターフェイスの構造] insert(self, index: Union[int, apysc._type.int.Int], value: ~_ArrValue) -> None


[インターフェイス概要]

この配列の指定されたインデックスの位置へ値を挿入します。このインターフェイスはinsert_atメソッドと同じ挙動をします。


[引数]

  • index: Int or int

    • 値を追加するインデックス。

  • value: *

    • 追加対象の任意の値。


[コードサンプル]

>>> import apysc as ap
>>> _ = ap.Stage()
>>> arr: ap.Array = ap.Array([1, 3])
>>> arr.insert(index=1, value=2)
>>> arr
Array([1, 2, 3])

insert_at API

特記事項: このAPIドキュメントはドキュメントビルド用のスクリプトによって自動で生成・同期されています。そのためもしかしたらこの節の内容は前節までの内容と重複している場合があります。

[インターフェイスの構造] insert_at(self, *, index: Union[int, apysc._type.int.Int], value: ~_ArrValue) -> None


[インターフェイス概要]

この配列の指定されたインデックスの位置へ値を挿入します。このインターフェイスはinsertメソッドと同じ挙動をします。


[引数]

  • index: Int or int

    • 値を追加するインデックス。

  • value: *

    • 追加対象の任意の値。


[コードサンプル]

>>> import apysc as ap
>>> _ = ap.Stage()
>>> arr: ap.Array = ap.Array([1, 3])
>>> arr.insert_at(index=1, value=2)
>>> arr
Array([1, 2, 3])