1
1
Fork 0
mirror of https://github.com/QB64-Phoenix-Edition/QB64pe.git synced 2024-07-05 22:50:23 +00:00
QB64-PE/internal/help/_MEMEXISTS.txt
2016-03-18 08:36:04 -03:00

23 lines
818 B
Plaintext

{{DISPLAYTITLE:_MEMEXISTS}}
The '''_MEMEXISTS''' function returns true (-1) if the memory block variable name specified exists in memory and false (0) if it does not.
{{PageSyntax}}
::: ret = '''[[_MEMEXISTS]] ('''''memblock''''')'''
''Details:''
* The memblock variable name should have been created using [[DIM]] blockname [[AS]] [[_MEM]] type ([[DIM]].
* The function verifies that the memory variable exists in memory before using a passed block to avoid generating QB64 errors.
* Typically, this function is used by a [[DECLARE LIBRARY|LIBRARY]] [[SUB]] or [[FUNCTION]] which accepts a [[_MEM]] structure as input to avoid an error.
''See Also:''
* [[_MEM (function)]]
* [[_MEMELEMENT]], [[_MEMCOPY]]
* [[_MEMIMAGE]], [[_MEMNEW]]
* [[_MEMGET]], [[_MEMPUT]]
* [[_MEMFILL]], [[_MEMFREE]]
{{PageNavigation}}