pdb_FindRecordByID(3)

NAME
pdb_FindRecordByID pdb_FindRecordByIndex - search for records in Palm databases

LIBRARY
libpdb

SYNOPSIS
#include <pdb.h>
struct pdb_record *
pdb_FindRecordByID(const struct pdb *db, const udword id);
struct pdb_record *
pdb_FindRecordByIndex(const struct pdb *db, const uword index);

DESCRIPTION
pdb_FindRecordByID looks for a record in db whose ID is id, and returns a pointer to it. Note that pdb_FindRecordByID does not make a copy of the record, so the pointer it returns should not be freed with pdb_FreeRecord, nor should it be added to another struct pdb ; for this, use pdb_CopyRecord() first.

pdb_FindRecordByIndex returns the indexth record in db, or NULL if there are fewer than index - 1 records in db.

RETURN VALUE
pdb_FindRecordByID and pdb_FindRecordByIndex return a pointer to the matching record, or NULL if there is none.

SEE ALSO
libpdb(3), pdb_FreeRecord(3), pdb_CopyRecord(3).

AUTHORS
Andrew Arensburger <arensb@ooblick.com>

LIMITATIONS
If there is more than one record in a database with the same ID (which should never happen), pdb_FindRecordByID will only find the first one.