Stor.Getdata Method (previously .Get)

Top  Previous  Next

 

Function:

Reads data from the EEPROM.

Syntax:

stor.getdata(startaddr as word, len as byte) as string

Returns:

String contains the data read out from the EEPROM.

See Also:

Stor Object, stor.set

 


Part

Description

startaddr

The starting address in the EEPROM memory (addresses are counted from 1, if you set this parameter to 0 it will be interpreted as 1).

len

Maximum number of bytes to read.

Details

The len parameter defines the maximum number of bytes to read from the EEPROM. Actual amount of extracted data is also limited by the capacity of the receiving variable and the starting address (in relation to the memory capacity of the EEPROM). Memory capacity can be checked through the stor.size read-only property. Notice that when the stor.getdata executes, an offset equal to the value of stor.base is added to the startaddr. For example, if the stor.base returns 9 and you do stor.getdata(1,3) then you will actually be reading the data starting from physical EEPROM location 9. If you set the stor.base to 1 you will be able to access the EEPROM right from the physical address 1.

By default, the stor.base is set in such a way as to allow access to the EEPROM starting from the address just above the special configuration area of your device — for details on what this area actually stores see your device's platform documentation (for example, EM1000's is here). By setting the stor.base to 1 you are allowing access to the special configuration area.

 

note_tip-wt

With Tibbo BASIC/C release V2, this method had to be renamed from .get to .getdata. This is because the period (".") separating "stor" from "getdata" is now a "true" part of the language, i.e. it is recognized as a syntax unit, not just part of identifier. Hence, Tibbo BASIC/C sees "stor" and "get" as separate entities and "get" is a reserved word that can't be used.