GetOccLabel Function

Format

s = getocclabel(ʃitem_name ‖ group_nameʅ);

Description

The getocclabel function returns the occurrence label for a repeating item or group (i.e., the row label of a roster). If no item_name or group_name is given, the function returns the occurrence label of the current field, as calculated as follows:

s = getocclabel($(curocc($)));

In addition to uses in logic, the function can be used as a fill in question text.

Return Value

The function returns a string containing the occurrence label. If an occurrence label for the item or group does not exist, the function returns a blank string.

Example

if EXPENSES > SALES then
errmsg("You could not have made a profit on %s if expenses were greater than sales.",getocclabel());
reenter;
endif;