zone.face.isgroup

Syntax

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

Note

• In the description below, the following correspondence is assumed between 3D and 2D analysis:

  • There is no 2D equivalence for 3D zone edges

  • 3D zone faces (surfaces) <-> 2D zone edges (lines)

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 4 in 2D and from 1 to 6 in 3D

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.