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 an

other 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 point

er 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.

BSD Aug 16, 2001

BSD