1
1
Fork 0
mirror of https://github.com/QB64-Phoenix-Edition/QB64pe.git synced 2024-07-04 04:50:22 +00:00
QB64-PE/internal/help/VARPTR_111111.txt
Roland Heyder aeb9c0668b Updates help files for use with new Wiki parser (2nd try)
Note: Many files were removed (not yet existing/empty pages). The parser will try to download them on demand and will auto-generate text for missing pages (eg. most _gl pages).
2022-05-21 00:18:31 +02:00

28 lines
1.3 KiB
Plaintext

{{QBDLDATE:05-20-2022}}
{{QBDLTIME:23:17:16}}
The '''VARPTR''' function returns an [[INTEGER]] value that is the offset part of the variable or array memory address within it's segment.
{{PageSyntax}}
:: 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]]
{{PageNavigation}}