Routines (alphabetical) > Routines: H > HDF-EOS Routines > EOS_PT_GETRECNUMS

# EOS_PT_GETRECNUMS

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

5.2 | Introduced