ForArrayValues class

This page explains the ForArrayValues class.

Before reading on, maybe it is helpful to read the following page (the apysc uses this class for the same reason for each data type):

What class is this?

The ForArrayValues class is the for-loop class.

This interface returns Array’s value in a loop.

Basic usage

This class requires using the with-statement.

The as-keyword value becomes an Array’s value.

Also, this class requires the arr_value_type to specify a type of an Array’s value type.

This type only accepts an apysc type, such as the Int, Number, String, or Rectangle.

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/")

See also

ForArrayValues API

Note: the document build script generates and updates this API document section automatically. Maybe this section is duplicated compared with previous sections.

[Interface signature] __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

[Interface summary]

The loop implementation class for the ap.Array values.

[Parameters]

  • arr: Array[_ArrayValue]

    • An array to iterate.

  • arr_value_type: Type[_ArrayValue]

    • An array value type. This interface accepts apysc types, such as the Int, String, Rectangle.

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

    • Current scope’s local variables. Set locals() value to this argument. If specified, this interface reverts all local scope VariableNameMixIn variables (like Int, Sprite) at the end of a with-statement scope. This setting is useful when you don’t want to update each variable.

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

    • Current scope’s global variables. Set globals() value to this argument. This setting works the same way as the locals_ argument.

  • variable_name_suffix: str, optional

    • A JavaScript variable name suffix string. This setting is sometimes useful for JavaScript debugging.

[Examples]

>>> 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"),
...     )
...