This function returns the record numbers in one level that are connected to a given set of records in a different level. The two levels need not be adjacent. The records in one level are related to those in another through the link field. These in turn are related to the next. In this way, each record in any level is related to others in all the levels of the point structure.
Examples
In this example, we get the record numbers in the second level that are related to the first record in the first level:
nrec = 1
recs[0] = 0
inLevel = 0
outLevel = 1
status = EOS_PT_GETRECNUMS(pointID2, inLevel, outLevel, $
nrec, recs, outNrec, outRecs)
Syntax
Result = EOS_PT_GETRECNUMS( pointID, inlevel, outlevel, inNrec, inRecs, outNrec, outRecs)
Return Value
Returns SUCCEED (0) if successful and FAIL (–1) otherwise.
Arguments
pointID
Point id (long) returned by EOS_PT_CREATE or EOS_PT_ATTACH.
inlevel
Level number (long) of input records (0-based).
outlevel
Level number (long) of output records (0-based).
inNrec
Number of records (long) in the inRecs array.
inRecs
Array (long) containing the input record numbers.
outNrec
A named variable that will contain the number of records (long) in the outRecs array.
outRecs
A named variable that will contain the array (long) of output record numbers.
Keywords
None
Version History