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

ForArrayIndices クラス

このページではForArrayIndicesクラスについて説明します。

事前に以下のページを読んでおくと役立つかもしれません（apyscライブラリではこのクラスを各データ型と同じように扱っています）。

クラス概要

ForArrayIndicesクラスはループ制御のためのクラスです。

このインターフェイスではループ中のArrayクラスのインデックス（0からスタートします）を返却します。

基本的な使い方

このクラスはwithステートメントと共に使う必要があります。

asキーワードの値はInt型のインデックスとなります。

import apysc as ap

ap.Stage(
    stage_width=0,
    stage_height=0,
    background_color=ap.Color("#333"),
    stage_elem_id="stage",
)

arr: ap.Array[ap.Number] = ap.Array([ap.Number(50), ap.Number(150), ap.Number(250)])
indices: ap.Array[ap.Int] = ap.Array([])
with ap.ForArrayIndices(arr=arr) as i:
    indices.append(i)

ap.assert_arrays_equal(indices, [0, 1, 2])

ap.save_overall_html(dest_dir_path="for_array_indices_basic_usage_1/")

以下の例ではインデックスを使って円の中心のX座標を設定しています。

import apysc as ap

ap.Stage(
    stage_width=350,
    stage_height=150,
    background_color=ap.Color("#333"),
    stage_elem_id="stage",
)

x_arr: ap.Array[ap.Number] = ap.Array([ap.Number(75), ap.Number(175), ap.Number(275)])
with ap.ForArrayIndices(arr=x_arr) as i:
    x: ap.Number = x_arr[i]
    circle: ap.Circle = ap.Circle(
        x=x,
        y=75,
        radius=25,
        fill_color=ap.Color("#0af"),
    )

ap.save_overall_html(dest_dir_path="for_array_indices_basic_usage_2/")

関連資料

ForArrayIndices API

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

[インターフェイスの構造] __init__(self, arr: apysc._type.array.Array, *, locals_: Union[Dict[str, Any], NoneType] = None, globals_: Union[Dict[str, Any], NoneType] = None, variable_name_suffix: str = '') -> None

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

ap.Arrayのインデックス制御のためのループ制御用のクラスです。

[引数]

  • arr: Array

    • イテレーションのための配列。

  • locals_: Optional[Dict[str, Any]], optional

    • 現在のスコープの各ローカル変数。この引数にはlocals()関数の返却値を設定してください。もしこの引数が指定された場合、このインターフェイスはローカルスコープのVariableNameMixInの各変数（例 : IntやSpriteなど）の値をwithステートメントの最後で復元します。この設定は各変数を更新したくない場合等に役立ちます。

  • globals_: Optional[Dict[str, Any]], optional

    • 現在のスコープの各グローバル変数。設定する場合にはglobal()関数の値をこの引数に指定してください。この設定はlocals_引数と同じように動作します。

  • variable_name_suffix: str, optional

    • JavaScript上の変数のサフィックスの設定です。この設定はJavaScriptのデバッグ時に役立つことがあります。

[コードサンプル]

>>> import apysc as ap
>>> arr: ap.Array[ap.Number] = ap.Array(
...     [ap.Number(50), ap.Number(150), ap.Number(250)]
... )
>>> indices: ap.Array[ap.Int] = ap.Array([])
>>> with ap.ForArrayIndices(arr=arr) as i:
...     indices.append(i)
...
>>> _ = ap.assert_arrays_equal(indices, [0, 1, 2])

[関連資料]