QB64-website/wiki/VARPTR.md

The VARPTR function returns an INTEGER value that is the offset part of the variable or array memory address within it's segment.

Syntax

offset% = VARPTR(variable_name[(reference_index%)])

• If variablename is not defined before VARPTR or VARSEG is called, the variable is created and it's address is returned.
• Reference index is used to set the offset address of an array index, not necessarily the lowest index.
• When a string variable, VARPTR returns the offset address location of the first byte of the string.
• Because many QBasic statements change the locations of variables in memory, use the values returned by VARPTR and VARSEG immediately after the functions are used!
• Integer array sizes are limited to 32767 elements when using VARPTR in QB and QB64!. Create a larger array using _BYTE. Example: DIM SHARED Memory (65535) AS _UNSIGNED _BYTE
• Warning: DEF SEG, VARSEG , VARPTR, PEEK or POKE access QB64's emulated 16 bit conventional memory block!

It is highly recommended that QB64's _MEM memory system be used to avoid running out of memory.

See Also

• BSAVE, BLOAD
• SADD, DEF SEG
• VARPTR$, VARSEG,
• POKE, PEEK