hpux man page for dtmmdbdlpgetnextsectionid

Query: dtmmdbdlpgetnextsectionid

OS: hpux

Section: 3

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

DtMmdbDlpGetNextSectionId(library call) 								   DtMmdbDlpGetNextSectionId(library call)

NAME
DtMmdbDlpGetNextSectionId -- obtains the object identifier of the next section
SYNOPSIS
#include <DtMmdb.h> DtMmdbHandle* DtMmdbDlpGetNextSectionId( DtMmdbInfoRequest* request);
DESCRIPTION
The DtMmdbDlpGetNextSectionId function returns the object identifier of the next section. You can use this function to traverse the TOC hierarchy in a depth-first fashion. Use the DtMmdbFreeHandleList function to release the memory when the object identifier is no longer needed. Table lookup is involved.
ARGUMENTS
request Specifies the bookcase in the bookcase descriptor field, as well as the id of the current section in the primary_oid field.
RETURN VALUE
If DtMmdbDlpGetNextSectionId completes successfully, it returns a pointer to the object identifier for the next section or DtMmdbGroundId, if there is no next section. If it fails, it returns a NULL pointer.
EXAMPLE
The following shows how a DtMmdbDlpGetNextSectionId call might be coded. DtMmdbHandle* my_oid; DtMmdbInfoRequest request; request.bookcase_descriptor = DtMmdbGetBookCase(myInfoLibPtr, "myBase"); request.primary_oid = my_oid; DtMmdbHandle* x = DtMmdbDlpGetNextSectionId(&request); if ( x == DtMMdbGroundId) { /* no next section */ } else { if (x == 0) { /* bad request */ } else { /* make use of x */ }
SEE ALSO
DtMmdbDlpGetPrevSectionId(3) DtMmdbDlpGetNextSectionId(library call)
Related Man Pages
dtmmdbbookgetlongtitle(3) - hpux
dtmmdbbookgettocobjectid(3) - hpux
dtmmdbdlpgetprevsectionid(3) - hpux
dtmmdbgetbookcasebyloc(3) - hpux
dtmmdbsectiongetlongtitle(3) - hpux
Similar Topics in the Unix Linux Community
How to list file size on HPUX?
How to extract every repeated string between two specific string?
Sequence extraction
Shopt -s histappend