C H A P T E R 1 1
Data Storage and Retrieval
11-22
About Data Storage on Newton Devices
The following soup methods and functions are obsolete:
SetupCardSoups() // use RegUnionSoup instead
RegisterCardSoup(
RegisterCardSoup(
soupName
,
indexArray
,
appSymbol
,
appObject
) // useRegUnionSoup instead
UnRegisterCardSoup(
soupName
)// use UnRegUnionSoup instead
BroadcastSoupChange(
soupNameString
) // use -xmit methods or
// XmitSoupChange fn instead
UnionSoupIsNull(
unionSoup
)// no null uSoups from GetUnionSoupAlways
GetUnionSoup(
soupNameString
)// use GetUnionSoupAlways instead
soup
:Add(
frame
) // use -xmit version instead
soup
:AddIndex(
indexSpec
) // use -xmit version instead
soupOrUSoup
:AddTags(
tagsToAdd
)// use -xmit version instead
unionSoup
:AddToDefaultStore(
frame
)// use -xmit version instead
soup
:AddWithUniqueId(
frame
)// use -xmit version instead
sourceSoup
:CopyEntries(
destSoup
)// use -xmit version instead
soup
:RemoveAllEntries() // use -xmit version instead
soup
:RemoveFromStore() // use -xmit version instead
soup
:RemoveIndex(
indexPath
) // use -xmit version instead
soupOrUSoup
:RemoveTags(
tagsToRemove
)// use -xmit version instead
soup
:SetInfo(
slotSymbol
) // use -xmit version instead
New Soup Change Notification Mechanism
11
Applications no longer modify system data structures directly to register and
unregister with the soup change notification mechanism. Instead, they use the
unregister with the soup change notification mechanism. Instead, they use the
RegSoupChange
and
UnRegSoupChange
global functions provided for
this purpose.
In addition to the new registration and unregistration functions, the soup change
mechanism provides additional information about the nature of the change and
allows applications to register callback functions to be executed whenever a particular
soup changes. Consequently, the global function
mechanism provides additional information about the nature of the change and
allows applications to register callback functions to be executed whenever a particular
soup changes. Consequently, the global function
BroadcastSoupChange
is obsolete.
For more details, see the section "Using Soup Change Notification" beginning on
page 11-63.
page 11-63.
Soup Information Frame
11
Soups created from a soup definition frame carry a default soup information frame
that holds a copy of the soup definition frame. Soups created by the obsolete global
function
that holds a copy of the soup definition frame. Soups created by the obsolete global
function
RegisterCardSoup
have a default soup information frame that
contains only the slots
applications
and
itemNames
.
Soups created by the obsolete store method
CreateSoup
do not contain a default
soup information frame.