SLOG_Irec_GetAssocs

Retrieve the association array of the interval record.

Synopsis


int SLOG_Irec_GetAssocs( const SLOG_intvlrec_t  *intvlrec,
                         const SLOG_N_assocs_t   size_assocs,
                               SLOG_assoc_t     *assocs )

Unmodified Input Variables

intvlrec - pointer to the internal Interval record to be retrieved.
size_assocs - Number of elements available for the input association array.

Modified Intput Variables

assocs - association array, array of file pointers to the associated interval records of the specified interval record. It is assumed the input array, assocs[], is big enough to hold the association array of the interval record.

Modified Output Variables

returned value - N_assocs : Number of elements in the association array returned. If the input size, size_assocs, is smaller than the actual number of elements of the association array, the return value will be SLOG_EOF and only the first size_assocs elements will be returned.

Usage Notes on this subroutine

The subroutine gets the association array of the specified Internal Interval Record. This subroutine is meant to be called once for each interval record. Calling multiple times for the same interval record returns the same results. If the return value, N_assocs, is equal to zero. It means there is no associated record.

Include File Needed

slog.h

Location:../src/slog_irec_read.c