Format:
i = totocc([group]);
Description:
The totocc function returns the total number of multiply occurring records or the total number of multiply-occurring items that a group currently contains.
During data entry, the occurrence value is updated in the preproc of the first field within a repeating form, record or roster. If the totocc function is executed prior to the entry of form or roster, it returns 0. If it is executed from a group or field within the form or roster, it returns the total number of occurrences currently entered. If it is executed after the form or roster, it returns the total number of occurrences in the form or roster.
During batch editing, totocc always returns the total number of occurrences in the group.
Return value:
The function returns an integer value of the number of occurrences.
Example 1:
if totocc(HOUSING) > 1 then
errmsg("More than 1 housing record");
endif;
Example 2:
PROC HOUSING
if totocc() > 1 then
errmsg("More than 1 housing record");
endif;
See also: Curocc Function, Maxocc Function, Count Function, Soccurs Function, Noccurs Function