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

Array クラスの slice インターフェイス

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

インターフェイス概要

sliceメソッドのインターフェイスは指定されたインデックスの範囲の配列の値を抽出し新しい配列を返却します。

基本的な使い方

sliceメソッドはstartとendの各引数（PythonビルトインのintもしくはapyscのIntの整数）を必要とし、返却値として新しい配列を返します。

例としてstart引数に1を指定しend引数に3を指定した場合、このメソッドはPythonビルトインの[1:3]という指定によるスライスと同じように動作します。

元々の配列の値は変更されません。

import apysc as ap

ap.Stage()
arr: ap.Array[int] = ap.Array([1, 2, 3, 4])
sliced_arr: ap.Array[int] = arr.slice(start=1, end=3)
assert sliced_arr == [2, 3]
assert arr == [1, 2, 3, 4]

slice API

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

[インターフェイスの構造] slice(self, *, start: Union[int, apysc._type.int.Int, NoneType] = None, end: Union[int, apysc._type.int.Int, NoneType] = None) -> 'Array'

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

指定された開始と終了のインデックス範囲でこの配列をスライスします。

[引数]

  • start: Int or int or None, default None

    • スライス範囲の開始インデックス。

  • end: Int or int or None, default None

    • スライス範囲の終了インデックス（結果の配列のこのインデックスの値を含みません）。

[返却値]

  • sliced_arr: Array

    • スライスされた配列。

[コードサンプル]

>>> import apysc as ap
>>> _ = ap.Stage()
>>> arr: ap.Array = ap.Array([1, 2, 3, 4])
>>> arr.slice(start=1, end=3)
Array([2, 3])

>>> arr.slice(start=1)
Array([2, 3, 4])

>>> arr.slice(end=2)
Array([1, 2])