ifRegistry

Implemented by

NameDescription
roRegistryThe Registry is an area of non-volatile storage where a small number of persistent settings can be stored

Supported methods

GetSpaceAvailable() as Integer

Description

Returns the number of bytes available in the app's device registry (32K). This function can be used, for example, to check the remaining space and remove older entries before writing newer ones. The following code demonstrates how to do this:

registry = CreateObject("roRegistry")
buffer = 512 ' arbitrary limit based on the app
if (registry.GetSpaceAvailable() < buffer)
' remove some old registry entries before writing new ones
end if

Return Value

An integer representing the number of bytes available in the device registry.

GetSectionList() as Object

Description

Returns the registry sections on the device.

Return Value

An roList with one entry for each registry section. Each registry section is an roString containing the name of the section. The section itself can be accessed by creating an roRegistrySection object using that name.

Delete(section as String) as Boolean

Description

Deletes the specified registry section.

Parameters

NameTypeDescription
sectionStringThe registry section to be deleted.

Return Value

A flag indicating whether the registry section was successfully deleted.

Flush() as Boolean

Description

Flushes the contents of the registry out to persistent storage in order to permanently store a token or other setting on the device.

Return Value

A flag indicating whether the registry was successfully flushed.