Data storage functions and methods 11 – Apple Newton Programmer’s Newton 2.0 (for Newton 2.0) User Manual

Page 503

Advertising
background image

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:[

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:

Boolean

, // optional

// string(s) to match w/ word beginnings in entries

words:

string

|[

str1

,

str2

, … ,

strN

], // optional

// string to match w/ any substring in entries

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:[

t1, t2, …tN

],

// select only entries having identical tags or superset

all:[

t1, t2, …tN

],

// select entries having any of these tags

any:[

t1, t2, …tN

],

// select entries having none of these tags

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()

Advertising