# `array` – arrays of numeric data

This module implements a subset of the corresponding CPython module, as described below. For more information, refer to the original CPython documentation: `array`.

Supported format codes: `b`, `B`, `h`, `H`, `i`, `I`, `l`, `L`, `q`, `Q`, `f`, `d` (the latter 2 depending on the floating-point support).

## Classes

class array.array(typecode[, iterable])

  Create array with elements of given type. Initial contents of the array are given by iterable. If it is not provided, an empty array is created.

  append(val)

    Append new element val to the end of array, growing it.

  extend(iterable)

    Append new elements as contained in iterable to the end of array, growing it.

  __getitem__(index)

    Indexed read of the array, called as `a[index]` (where `a` is an `array`). Returns a value if index is an `int` and an `array` if index is a slice. Negative indices count from the end and `IndexError` is thrown if the index is out of range.

    Note: `__getitem__` cannot be called directly (`a.__getitem__(index)` fails) and is not present in `__dict__`, however `a[index]` does work.

  __setitem__(index, value)

    Indexed write into the array, called as `a[index] = value` (where `a` is an `array`). `value` is a single value if index is an `int` and an `array` if index is a slice. Negative indices count from the end and `IndexError` is thrown if the index is out of range.

    Note: `__setitem__` cannot be called directly (`a.__setitem__(index, value)` fails) and is not present in `__dict__`, however `a[index] = value` does work.

  __len__()

    Returns the number of items in the array, called as `len(a)` (where `a` is an `array`).

    Note: `__len__` cannot be called directly (`a.__len__()` fails) and the method is not present in `__dict__`, however `len(a)` does work.

  __add__(other)

    Return a new `array` that is the concatenation of the array with other, called as `a + other` (where `a` and other are both `arrays`).

    Note: `__add__` cannot be called directly (`a.__add__(other)` fails) and is not present in `__dict__`, however `a + other` does work.

  __iadd__(other)

    Concatenates the array with other in-place, called as `a += other` (where `a` and other are both `arrays`). Equivalent to `extend(other)`.

    Note: `__iadd__` cannot be called directly (`a.__iadd__(other)` fails) and is not present in `__dict__`, however `a += other` does work.

  __repr__()

    Returns the string representation of the array, called as `str(a)` or `repr(a)`` (where `a` is an `array`). Returns the string `"array(<type>, [<elements>])"`, where `<type>` is the type code letter for the array and `<elements>` is a comma seperated list of the elements of the array.

    Note: `__repr__` cannot be called directly (`a.__repr__()` fails) and is not present in `__dict__`, however `str(a)` and `repr(a)` both work.

Language and External Links

Language
  English
  中文

External links
  openmv.io
  forums.openmv.io
  github.com/openmv/openmv
  micropython.org
  forum.micropython.org
  github.com/micropython/micropython