LDTBINDEX(3X-SVR3)  RISC/os Reference Manual   LDTBINDEX(3X-SVR3)



NAME
     ldtbindex - compute the index of a symbol table entry of a
          common object file

SYNOPSIS
     #include <stdio.h>
     #include <filehdr.h>
     #include <syms.h>
     #include <ldfcn.h>

     long ldtbindex (ldptr)
     LDFILE *ldptr;

DESCRIPTION
     ldtbindex returns the (long) index of the symbol table entry
     at the current position of the common object file associated
     with ldptr.

     The index returned by ldtbindex can be used in later calls
     to ldtbread(3X).  ldtbindex returns the index of the symbol
     table entry that begins at the current position of the
     object file; therefore, if ldtbindex is called immediately
     after a particular symbol table entry has been read, it
     returns the the index of the next entry.

     If there are no symbols in the object file or if the object
     file is not positioned at the beginning of a symbol table
     entry, ldtbindex fails and returns BADINDEX (-1).

     NOTE: The first symbol in the symbol table has an index of
     zero.

     The program must be loaded with the object file access rou-
     tine library libmld.a.

SEE ALSO
     ldclose(3X), ldopen(3X), ldtbread(3X), ldtbseek(3X),
     ldfcn(4).

















                        Printed 11/19/92                   Page 1