xiv
Chapter 11
Data Storage and Retrieval
11-1
About Data Storage on Newton Devices
11-1
Introduction to Data Storage Objects
11-2
Where to Go From Here
11-6
Stores
11-6
Packages
11-7
Soups
11-7
Indexes
11-8
Saving User Preference Data in the System Soup
11-10
Queries
11-10
Querying for Indexed Values
11-10
Begin Keys and End Keys
11-12
Tag-based Queries
11-14
Customized Tests
11-14
Text Queries
11-15
Cursors
11-16
Entries
11-17
Alternatives to Soup-Based Storage
11-18
Dynamic Data
11-18
Static Data
11-19
Compatibility Information
11-20
Obsolete Store Functions and Methods
11-20
Soup Compatibility Information
11-20
Query Compatibility Information
11-23
Obsolete Entry Functions
11-24
Obsolete Data Backup and Restore Functions
11-24
Using Newton Data Storage Objects
11-25
Programmer's Overview
11-25
Using Stores
11-28
Store Object Size Limits
11-29
Referencing Stores
11-29
Retrieving Packages From Stores
11-29
Testing Stores for Write-Protection
11-30
Getting or Setting the Default Store
11-30
Getting and Setting the Store Name
11-30
Accessing the Store Information Frame
11-31
Using Soups
11-31
Naming Soups
11-31
Registering and Unregistering Soup Definitions
11-32