C H A P T E R 1 1
Data Storage and Retrieval
Summary of Data Storage
11-71
// optional tags query spec frame; see page 11-71
tagSpec: {equal:[
tagSpec: {equal:[
t1, t2, ...tN
], all:[
t1, t2, ...tN
],
any:[
t1, t2, ...tN
],none:[
t1, t2, ...tN
]},
// when non-nil, match entire string in 'words slot
entireWords:
entireWords:
Boolean
, // optional
// string(s) to match w/ word beginnings in entries
words:
words:
string
|[
str1
,
str2
, ... ,
strN
], // optional
// string to match w/ any substring in entries
text:
text:
string
, // optional
}
Tags Query Specification Frame
11
// this frame resides in tagSpec slot of query spec frame
// at least one of these slots must appear
// select only entries having identical set of tags
{equal:[
// at least one of these slots must appear
// select only entries having identical set of tags
{equal:[
t1, t2, ...tN
],
// select only entries having identical tags or superset
all:[
all:[
t1, t2, ...tN
],
// select entries having any of these tags
any:[
any:[
t1, t2, ...tN
],
// select entries having none of these tags
none:[
none:[
t1, t2, ...tN
]}
Callback Functions for Soup Change Notification
11
func(
soupNameString
,
appSymbol
,
changeTypeSymbol
,
changeData
);
Data Storage Functions and Methods
11
Stores
11
store
:AtomicAction(
function
)
store
:BusyAction(
appSymbol
,
appName
,
action
)
store
:CheckWriteProtect()
GetDefaultStore()
store
:GetInfo(
slotSymbol
)
store
:GetName()
store
:GetSoup(
soupNameString
)
store
:GetSoupNames()
GetStores()
store
:HasSoup(
soupName
)
store
:IsReadOnly()