
CHAPTER 11
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(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
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
BroadcastSoupChange
is obsolete.
For more details, see the section “Using Soup Change Notification” beginning on
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
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.
Commentaires sur ces manuels