Apple Newton Programmer’s Newton 2.0 (for Newton 2.0) - Manual (Page 457)

C H A P T E R 1 1
Data Storage and Retrieval
Using Newton Data Storage Objects 11-25
Heap Space Requirements of Words and Text Queries 11
On systems prior to version 2.0, words and text queries generally require more
memory than index queries, because each entry to be tested must first be read into
the NewtonScript heap. System software version 2.0 uses virtual binary objects to
reduce the memory requirements of words and text queries significantly; however,
you need not be familiar with these objects yourself in order to query on string
values. Virtual binary objects are described in Chapter 12, “Special-Purpose
Objects for Data Storage and Retrieval.”
Obsolete Entry Functions 11
The following entry functions are obsolete:
EntryChange( entry ) // use -xmit version instead
EntryCopy( entry , newSoup ) // use -xmit version instead
EntryMove( entry , newSoup )// use -xmit version instead
EntryRemoveFromSoup( entry )// use -xmit version instead
EntryReplace( oldEntry , newEntry )// use -xmit version instead
EntryUndoChanges( entry )// use -xmit version instead
Obsolete Data Backup and Restore Functions 11
The utility functions and methods in the following list are obsolete. Note that these
functions and methods are intended for use only by utility programs that back up
and restore Newton data.
soup :AddWithUniqueId ( entry )// use -xmit version instead
soup :SetAllInfo ( frame )// use -xmit version instead
EntryChangeWithModTime( entry )// use -xmit version instead
EntryReplaceWithModTime( original , replacement )// use -xmit version
Using Newton Data Storage Objects 11
This section describes how to use the most common Newton data storage objects
and methods. It presumes knowledge of the material in preceding sections. This
section begins with a programmer’s overview, which is followed by sections
providing detailed explanations of the use of stores, soups, queries, cursors,
and entries.
Programmer’s Overview 11
This section provides a code-level overview of common objects, methods, and
functions that provide data storage and retrieval services to Newton applications.