ball.group

Syntax

s := ball.group(bp<,slot>)

ball.group(bp<,slot>) := s

Get/set the group name assigned to ball bp in slot slot, if provided. The slot named 'Default' is used by default if slot is not provided.

On set, a group index may be used instead of a string for s. On get or set, a slot index may be used instead of a string for slot. Indices operate more efficiently than strings.*

Returns:

s - the group name; None is returned if no group has been assigned in the given slot

Accepts:

s - the group name or index*; if not present, the group is created in the given slot

Arguments:

bp - ball pointer

slot - the slot name or index*; if not given, the slot name 'Default' is used

Note

*Use the group.find and group.find.slot intrinsics to obtain group and slot indices, respectively, and for further information.

Use of the group logic is described in Groups.