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 re

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

BSD Aug 16, 2001

BSD