# bpy_prop_collection

class `bpy.types.``bpy_prop_collection`

  built-in class used for all collections.

  Note

  Note that bpy.types.bpy_prop_collection is not actually available from within blender, it only exists for the purpose of documentation.

  `find`(key)

    Returns the index of a key in a collection or -1 when not found (matches pythons string find function of the same name).

    Parameters: | key (string) – The identifier for the collection member.
    Returns: | index of the key.
    Return type: | int

  `foreach_get`(attr, seq)

    This is a function to give fast access to attributes within a collection.

    Only works for ‘basic type’ properties (bool, int and float)! Multi-dimensional arrays (like array of vectors) will be flattened into seq.

        collection.foreach_get(attr, some_seq)

        # Python equivalent
        for i in range(len(seq)):
            some_seq[i] = getattr(collection[i], attr)

  `foreach_set`(attr, seq)

    This is a function to give fast access to attributes within a collection.

    Only works for ‘basic type’ properties (bool, int and float)! seq must be uni-dimensional, multi-dimensional arrays (like array of vectors) will be re-created from it.

        collection.foreach_set(attr, some_seq)

        # Python equivalent
        for i in range(len(some_seq)):
            setattr(collection[i], attr, some_seq[i])

  `get`(key, default=None)

    Returns the value of the item assigned to key or default when not found (matches pythons dictionary function of the same name).

    Parameters: | key (string) – The identifier for the collection member. default (Undefined) – Optional argument for the value to return if key is not found.

  `items`()

    Return the identifiers of collection members (matching pythons dict.items() functionality).

    Returns: | (key, value) pairs for each member of this collection.
    Return type: | list of tuples

  `keys`()

    Return the identifiers of collection members (matching pythons dict.keys() functionality).

    Returns: | the identifiers for each member of this collection.
    Return type: | list of strings

  `values`()

    Return the values of collection (matching pythons dict.values() functionality).

    Returns: | the members of this collection.
    Return type: | list