TableofContents
Preface .............................................................................................. iv
Conventions Used in this Book ............................................................. iv
1. Introduction to Berkeley DB .................................................................. 1
About This Manual ........................................................................... 2
Berkeley DB Concepts ....................................................................... 2
Access Methods ............................................................................... 4
Selecting Access Methods ............................................................ 4
Choosing between BTree and Hash ................................................. 5
Choosing between Queue and Recno ............................................... 5
Database Limits and Portability ............................................................ 6
Environments ................................................................................. 6
Exception Handling .......................................................................... 7
Error Returns .................................................................................. 8
Getting and Using DB ....................................................................... 8
2. Databases ......................................................................................... 9
Opening Databases ........................................................................... 9
Closing Databases ........................................................................... 10
Database Properties ........................................................................ 11
Administrative Methods .................................................................... 12
Error Reporting Functions ................................................................. 13
Managing Databases in Environments .................................................... 14
Database Example .......................................................................... 16
3. Database Records .............................................................................. 19
Using Database Records .................................................................... 19
Reading and Writing Database Records ................................................. 20
Writing Records to the Database .................................................. 21
Getting Records from the Database ............................................... 22
Deleting Records ..................................................................... 23
Data Persistence ..................................................................... 24
Using the BIND APIs ......................................................................... 25
Numerical and String Objects ...................................................... 25
Serializable Complex Objects ...................................................... 27
Usage Caveats .................................................................. 28
Serializing Objects ............................................................. 28
Deserializing Objects .......................................................... 31
Custom Tuple Bindings .............................................................. 32
Database Usage Example .................................................................. 35
4. Using Cursors ................................................................................... 47
Opening and Closing Cursors .............................................................. 47
Getting Records Using the Cursor ........................................................ 48
Searching for Records ............................................................... 50
Working with Duplicate Records ................................................... 53
Putting Records Using Cursors ............................................................ 55
Deleting Records Using Cursors ........................................................... 57
Replacing Records Using Cursors ......................................................... 58
Cursor Example ............................................................................. 59
Page iiGetting Started with DB11/9/2005
