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

ForArrayValues クラス

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

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

クラス概要

ForArrayValuesクラスはループ処理のためのクラスです。

このインターフェイスはループ内でArrayの配列の値を返却します。

基本的な使い方

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

asキーワードによる値はArrayの配列の値となります。

また、このクラスはArrayの配列内の値の型の指定用にarr_value_type引数の指定が必要になります。

この型の指定はIntやNumber、StringやRectangleなどのapyscの型（クラス）のみ受け付けます。

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.ForArrayValues(arr=x_arr, arr_value_type=ap.Number) as value:
    circle: ap.Circle = ap.Circle(
        x=value,
        y=75,
        radius=25,
        fill_color=ap.Color("#0af"),
    )

ap.save_overall_html(dest_dir_path="for_array_values_basic_usage/")

関連資料

ForArrayValues API

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

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

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

ap.Arrayの配列の値のためのループ処理のクラスです。

[引数]

  • arr: Array[_ArrayValue]

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

  • arr_value_type: Type[_ArrayValue]

    • 配列の値の型。このインターフェイスはInt、String、Rectangleなどのapyscの型を受け付けます。

  • 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
>>> _ = ap.Stage()
>>> x_arr: ap.Array[ap.Number] = ap.Array(
...     [ap.Number(75), ap.Number(175), ap.Number(275)]
... )
>>> with ap.ForArrayValues(arr=x_arr, arr_value_type=ap.Number) as value:
...     circle: ap.Circle = ap.Circle(
...         x=value,
...         y=75,
...         radius=25,
...         fill_color=ap.Color("#0af"),
...     )
...