.getdata Method (Previously .get)

Function:	Reads data from the EEPROM.
Syntax:	stor.getdata(startaddr as word, len as byte) as string
Returns:	String that contains the data read out from the EEPROM.
See Also:	stor. Object, stor.setdata

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. The 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 stor.getdata executes, an offset equal to the value of stor.base is added to startaddr. For example, if 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 stor.base to 1, you will be able to access the EEPROM right from physical address 1.

By default, 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, the EM1000's is here). By setting stor.base to 1, you are allowing access to the special configuration area.

A tip note icon. 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.