Format:
i = soccurs(record-name);
Description:
The soccurs function returns the total number of occurrences of a record.
During data entry, you may determine the current occurrence of a record. The occurrence value is updated after the first entry into the first field. If the soccurs function is executed prior to the roster or form it specifies then it returns 0. If it is executed from a field within the roster or form, it returns the current occurrence number after the first field is on the path. For example, its value in the PREPROC of the first occurrence of the first item entered in a form or roster is zero (0), i.e., before entry. After entry its value will always be one (1). This is true for each occurrence keyed, the soccurs function is not incremented until the cursor is in or has passed through the first field on the record. If it is executed after the form or roster, it returns the total number of occurrences in the form or roster. If the form does not repeat, noccurs will return 1 (a roster must always repeat). When used in Data entry noccurs and soccurs functions are the same.
During batch editing, soccurs always returns the total number of record occurrences found.
Return value:
The function returns the number of occurrences as an integer value.
Example:
NUM_HH_MEMBERS = soccurs(PERSON_REC);
See also: Totocc Function, Curocc Function, Noccurs Function, Count Function