zone.group

Syntax

s := zone.group(z<,slot>)

zone.group(z<,slot>) := s

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

On get, if the slot name is assigned a NULL string ('', or ""), a string with ALL the group and slot assignments is returned, in the format "slot=group,slot=group,slot=group,...".

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:

z - zone 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.