pdb_AppendRecord(3)

NAME
pdb_AppendRecord pdb_AppendResource pdb_InsertRecord pdb_InsertResource - add records to a Palm database

LIBRARY
libpdb

SYNOPSIS
#include <pdb.h>
int
pdb_AppendRecord(struct pdb *db, struct pdb_record *newrec);
int
pdb_AppendResource(struct pdb *db, struct pdb_resource *newrsrc);
int
pdb_InsertRecord(struct pdb *db, struct pdb_record *prev, struct pdb_record *newrec);
int
pdb_InsertResource(struct pdb *db, struct pdb_resource *prev, struct pdb_resource *newrsrc);

DESCRIPTION
pdb_AppendRecord appends the record pointed to by newrec to the database db. Note that newrec is not copied, so the caller must not free it.

pdb_AppendResource appends the resource pointed to by newrsrc to the database db. Note that newrsrc is not copied, so the caller must not free it.

pdb_InsertRecord adds the record pointed to by newrec into the database pointed to by db, immediately after the record prev. If prev is NULL, the new record is inserted at the beginning of the database.

pdb_InsertResource adds the resource pointed to by newrsrc into the database pointed to by db, immediately after the resource prev. If prev is NULL, the new resource is inserted at the beginning of the database.

RETURN VALUE
These functions return 0 if successful, or a negative value otherwise.

SEE ALSO
libpdb(3), new_Record(3), new_Resource(3).

AUTHORS
Andrew Arensburger <arensb@ooblick.com> LIMITATIONS pdb_InsertRecord and pdb_InsertResource do not check whether prev is in db. It is strongly recommended that the caller not abuse this behavior.