LDTBINDEX(3x,L)             AIX Technical Reference             LDTBINDEX(3x,L)



-------------------------------------------------------------------------------
ldtbindex



PURPOSE

Computes the index of a symbol table entry of a common object file.

LIBRARY

Object File Access Routine Library (libld.a)

SYNTAX

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

long ldtbindex  (ldptr)
LDFILE *ldptr;

DESCRIPTION

The ldtbindex subroutine returns the (long) index of the symbol table entry at
the current position of the common object file associated with ldptr.  Note
that the first symbol in the symbol table has an index of 0.

The index returned by ldtbindex may be used in subsequent calls to the ldtbread
subroutine.  However, since ldtbindex returns the index of the symbol table
entry that begins at the current position of the object file, if ldtbindex is
called immediately after a particular symbol table entry has been read, it
returns the index of the next entry.

The ldtbindex subroutine fails 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.

RELATED INFORMATION

In this book:  "ldclose, ldaclose," "ldfcn," "ldopen, ldaopen," "ldtbread," and
"ldtbseek."













Processed November 7, 1990      LDTBINDEX(3x,L)                               1