IDS_NTH_SDS(3)



NAME

     ids_nth_sds    -  returns the nth SDS in the sds list of the
     IDS.



SYNOPSIS

          SDS *ids_nth_sds(IDS *ids, int n);



DESCRIPTION

     Returns a pointer to the nth SDS in the SDS list of the IDS.
     Null  if  not  found.  Indexing starts from 1.  Note that it
     does NOT returns a copy of the SDS.



KEYWORDS


RETURN VALUES

     Pointer to the nth SDS.  NULL if an error is encountered.



EXAMPLES

          IDS *myids;
          SDS *first_sds, *last_sds;
              .
              .
              .
          first_sds = ids_nth_sds(myids, 1);
          last_sds = ids_nth_sds(myids, ids_length(myids));



SEE ALSO


WARNINGS

     None


FILES


BUGS

     None


RESTRICTIONS

     None


PLANNED IMPROVEMENTS

     None


REFERENCES

     None


VERSION

     1994-02-24     Lup Ng    SOI Version 0.8