man libpdb (Fonctions bibliothèques) - libpdb

NAME

libpdb - library for reading and writing Palm database files

SYNOPSIS

#include <palm.h>#include <pdb.h>

Function prototypes are given in their respective man pages.

If was built with I18N support, you may need to link with -lintl

DESCRIPTION

The library provides functions for reading and writing Palm database files, both PDB (record database) and PRC (resource database).

INTRODUCTION

A Palm database file has the following overall structure:

•
Header. This includes the database's name; attribute flags; version; creation, modification, and backup time; modification number; type; creator; and unique ID number seed. It also specifies whether or not the database has an AppInfo and/or sort block. The creator field identifies the application with which the database is associated: it will be the same as the creator field of the application database.
•
Index header.
•
Record/resource index. The index lists the locations of records or resources in the database. The index header specifies the number of records in the index, and may optionally point to another index in the database. manages the index and index header.
•
Optional AppInfo block. The AppInfo block contains application-specific data that pertains to the database as a whole. Typically, it contains category information, as well as user preference settings.
•
Optional sort block. I'm not sure what this is. I think it specifies the order in which to display the records.
•
Records/resources.

FUNCTIONS

includes the following functions, which are described in their respective manual pages:

free_pdb struct pdb *dbnew_Record const ubyte flags const ubyte category const udword id const uword len const ubyte *datanew_Resource const udword type const uword id const uword len const ubyte *datapdb_FreeRecord struct pdb_record *recpdb_FreeResource struct pdb_resource *rsrcpdb_Read int fdpdb_Write const struct pdb *db int fdpdb_FindRecordByID const struct pdb *db const udword idpdb_FindRecordByIndex const struct pdb *db const uword indexpdb_DeleteRecordByID struct pdb *db const udword idpdb_AppendRecord struct pdb *db struct pdb_record *newrecpdb_AppendResource struct pdb *db struct pdb_resource *newrsrcpdb_InsertRecord struct pdb *db struct pdb_record *prev struct pdb_record *newrecpdb_InsertResource struct pdb *db struct pdb_resource *prev struct pdb_resource *newrsrcnew_Record const ubyte attributes const ubyte category const udword id const uword len const ubyte *datapdb_CopyRecord const struct pdb *db const struct pdb_record *recpdb_CopyResource const struct pdb *db const struct pdb_resource *rsrcpdb_LoadHeader int fd struct pdb *db

AUTHORS

Andrew Arensburger Aq arensb@ooblick.com

LIMITATIONS

Does not support multiple indexes in one database.