zone.face.isgroup

Syntax

b := zone.face.isgroup(z,iside,s<,slot>)

Check if the group name s is associated with the zone face indicated by z and iside and return true if a match is found in any slot. The check for s will only occur in slot, if provided.

Note that this function will return a match if any zone attached to the face contains that group name, as well as the face itself.

A group index or slot index may be used for the arguments s or slot, respectively. Indices operate more efficiently than strings*.

Returns:

b - true if a match is found, false otherwise

Arguments:

z - zone pointer

iside - side of the zone indicating the face, from 1 to 6

s - group name or index*

slot - slot name or index*

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 i Groups.