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