xpxFindAggrInstancesBN

FUNCTION xpxFindAggrInstancesBN(instanceId            : GENERIC;
                                aggrName, condition   : STRING;
                                firstIndex , maxHits  : INTEGER;
                                VAR indexOfLastFound  : INTEGER;
                                VAR actualHits        : INTEGER;
                                VAR foundInstancs     : LIST OF GENERIC)
                                status                : INTEGER;

The xpxFindAggrInstancesBN function searches the specified aggregate aggrName in the specified instance instanceId for instances that matches a specified condition. The condition to match is specified in the condition argument. The condition argument can be an empty string meaning that all instances in the actual aggregate will match the query. The argument firstIndex specifies the index of the first instance in the actual aggregate to test against the condition. The first instance in the aggregate has an index equal to one. The argument maxHits specifies the maximum number of matching instanceIds that should be returned in the foundInstances argument. The argument indexOfLastFound is the index in the aggregate of the last found matching instance and the argument actualHits returns the actual number of returned instanceIds in the foundInstances aggregate. When the input arguments ((maxHits == 0) && (foundInstances == NULL)) no instanceId or elementNumber will be returned. Only the number of matching instances/elements will be returned.

Arguments

Return Value

Options

Example

<Missing Example>

See also