SetOccLabel Function

Format

b = setocclabel(ʃitem_name ‖ group_name,ʅoccurrence_label);

Description

The setocclabel function sets the occurrence label for a repeating item or group (i.e., the row label of a roster). This is especially useful when designing applications for mobile devices, as it allows you to specify the label that is displayed in the navigational case tree. If no item_name or group_name is given, the function sets the occurrence label of the current field. The occurrence label is set to the string expression occurrence_label.

Return Value

The function returns a logical value of 1 (true) if the label was set successfully and 0 (false) if the occurrence for the item or group item does not exist.

Example 1

PROC PERSON_NAME

setocclabel(PERSON_ROSTER,strip(PERSON_NAME));

Example 2

PROC MYSURVEY_QUEST

preproc

// fill in occurrence labels for the household roster
do numeric ctr = 1 while ctr <= totocc(PERSON_ROSTER)
setocclabel(PERSON_ROSTER(ctr),strip(NAME(ctr)));
enddo;