Block.vertices_attributes

Block.vertices_attributes(names=None, values=None, keys=None)

Get or set multiple attributes of multiple vertices.

Parameters:
nameslist[str], optional

The names of the attribute.

valueslist[Any], optional

The values of the attributes.

keyslist[int], optional

A list of vertex identifiers.

Returns:
list[dict[str, Any]] | list[list[Any]] | None

If the parameter names is empty, the function returns a list containing an attribute dict per vertex. If the parameter names is not empty, the function returns a list containing a list of attribute values per vertex corresponding to the provided attribute names. The function returns None if it is used as a “setter”.

Raises:
KeyError

If any of the vertices does not exist.