ZBasicSysLib - page 329 of 361

Page 329 of 361

Start Back Next End

ZBasic System Library

ZBasic Microcontrollers

Function returning Byte

The string variable whose string type is desired.

This function returns a value indicating the nature of a string variable. The values returned have the

meaning shown in the table below.

The string is a standard statically allocated string or a bounded string. The value returned by

StrAddress() is a RAM address and can be read using RamPeek()or MemCopy().

The string is dynamically allocated. The value returned by StrAddress() is a RAM

address (which may be zero) and can be read using RamPeek() or MemCopy().

The string is in Program Memory. The value returned by StrAddress() is a Program

Memory address and can be read using GetProgMem().

The string is in Persistent Memory. The value returned by StrAddress() is a Persistent

Memory address and can be read using GetPersistent().

The string is in RAM. The value returned by StrAddress() is a RAM address (which may

be zero) and can be read using RamPeek() or MemCopy().

The string is in RAM and is limited to 1 or 2 characters. The value returned by

StrAddress()is a RAM address and can be read using RamPeek() or MemCopy().

The string is in RAM. The value returned by StrAddress()is a RAM address and can

be read using RamPeek() or MemCopy(). This special string type is used for native-mode

code to pass a bounded string or fixed-length string to a subroutine/function ByVal.

The string is a statically allocated fixed-length string. The value returned by StrAddress()

is a RAM address and the data can be read using RamPeek() or MemCopy().

See the section on strings in the ZBasic Reference Manual for more details about dynamically vs.

statically allocated strings.

This function is not available in BasicX compatibility mode.