ObjectStore C++ Advanced API User Guide

Contents

Preface

Chapter 1

Advanced Persistence

Chapter 2

Advanced Transactions

Chapter 3

Threads

Chapter 4

Advanced Collections

Advanced Collections Overview
Using Paths in Navigation
- Paths
Creating Paths
- Simple Paths
- Multiple Member Paths
- Rank and Hash Functions
Paths and Member Functions
- Restrictions
- Prerequisites
- The os_query_function() Macro
- The os_query_function_returning_ref() Macro
- The os_query_function_body() Macro
- The OS_MARK_QUERY_FUNCTION() Macro
- The os_query_function_body_returning_ref() Macro
- Path String Syntax Extension
- Index Maintenance
Controlling Traversal Order
- Rank-Function-Based Traversal
- Address Order Traversal
- Path-Based Traversal
Using Ranges in Navigation
- Ranges
Specifying Collection Ranges
- Ranges with Only One Bound
- Ranges with Both an Upper and Lower Bound
Restricting the Elements Visited in a Traversal
- Dictionaries
- Duplicates
Performing Collection Updates During Traversal
- Update-Insensitive Cursors
- Safe Cursors
- Ordered, Safe Traversal
Retrieving Uniquely Specified Collection Elements
- Ordered Collections
Selecting Individual Collection Elements with pick()
- Dictionaries
- Picking an Arbitrary Element
Consolidating Duplicates with operator =()
Supplying Rank and Hash Functions
- The os_index_key() Macro
- Rank Functions
- Hash Functions
- Example Use of Rank and Hash Functions
Specifying Expected Size
Customizing Collection Behavior
- Behavior Enumerators for Collection Subtypes
- Behavior Enumerators for Dictionaries
- Required and Forbidden Behaviors
- Changing Collection Behavior with change_behavior()
Customizing Collection Representation
- Representation Classes
- Creating Collection Representation Objects
- Changing Collection Representation with change_rep()
os_chained_list
- Controlling the Number of Pointers
- Pool Allocation of Blocks
- Mutation Checks
- mutate_when_full Behavior
os_dyn_bag
- Time Complexity
- Space Overhead
os_dyn_hash
- Time Complexity
- Space Overhead
os_ixonly and os_ixonly_bc
- os_ixonly_bc
- Time Complexity
os_ordered_ptr_hash
- Time Complexity
- Space Overhead and Clustering
os_packed_list
- Time Complexity
- Space Overhead and Clustering
os_ptr_bag
- Time Complexity
- Space Overhead and Clustering
os_vdyn_bag
- Time Complexity
- Space Overhead
os_vdyn_hash
- Time Complexity
- Space Overhead
Summary of Representation Types
- Time Complexity Summary
- Space Overhead Summary

Chapter 5

Queries and Indexes

Chapter 6

Compaction

Chapter 7

Metaobject Protocol

Chapter 8

Dump/Load Facility

Chapter 9

Advanced Schema Evolution

Chapter 10

Database Utility API

Index

[next]

Copyright © 1997 Object Design, Inc. All rights reserved.

Updated: 03/31/98 15:26:45