ThinBASIC Core Language > BuiltIn Functions > Memory handling and pointers

Description

Store a sequence of bytes at a specified memory location.

Syntax

s = POKE$(Address, StringExpression)

s = POKE$(ASCIIZ, Address, StringExpression)

s = POKE$(STRING, Address, StringExpression)

Returns

String, the passed string expression

Parameters

Name	Type	Optional	Meaning
ASCIIZ	Command	Yes	If ASCIIZ is specified, POKE$ writes successive characters to a target address in memory until a terminating $NUL byte is found in the source string. If no $NUL is found in the string, one is automatically appended to the target buffer.
STRING	Command	Yes	If STRING is specified, address is interpreted as a 32 bit placeholder for a dynamic string. This form allow handling dynamic strings inside UDT or using whatever 32 bit number.
Address	Numeric	No	A valid 32-bit memory address specifying the location in memory where starting to store data
StringExpression	String	No	A string expression that specifies the sequence of bytes to be stored in memory starting at the byte referenced by address

Remarks

POKE$ stores a string in consecutive bytes where the ASCII code of the first character of the string is stored in the first byte of memory, the next ASCII code is stored in the next byte of memory, and so on, until all bytes in StringExpression are stored. It is the programmer’s responsibility to ensure that POKE$ does not overrun the target memory area to avoid data corruption or protection faults.

Restrictions