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 Python’s 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 Python’s 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 Python’s 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 Python’s dict.keys() functionality).

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

values()¶

Return the values of collection (matching Python’s dict.values() functionality).

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