POKE

<< Click to Display Table of Contents >>

Navigation:  ThinBASIC Core Language > BuiltIn Functions > Memory handling and pointers >

POKE

 

Description

 

Store a number at a specified memory location.

 

Syntax

 

n = POKE([DataType, ] address, DataValue)

 

Returns

 

Number, the passed numeric expression

 

Parameters

 

Name

Type

Optional

Meaning

DataType

Command

Yes

Optional parameter indicating the numeric data type to retrieve, which can be one of the following data type:

BYTE

WORD

DWORD

INTEGER

LONG

QUAD

SINGLE

DOUBLE

EXT

CUR

If no data type is specified, BYTE will be assumed.

Address

Numeric

No

A valid 32-bit memory address specifying the location in memory where data retrieval should begin

DataValue

Numeric

No

The data value to be stored at address

 

Remarks

 

POKE provides the functionality of a dynamic pointer: the datatype parameter specifies the data type and also the size of the target data to write to the target memory address.

Datatype can be any one of BYTE, WORD, DWORD, INTEGER, LONG, QUAD, SINGLE, DOUBLE, EXT, CUR.

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

 

See also

 

STRPTR, VARPTR, POKE$, POKE, PEEK$, PEEK

 

Examples