[<<Previous Entry]
[^^Up^^]
[Next Entry>>]
[Menu]
[About The Guide]
POKEWORD()
Writes a 16-bit word to memory
------------------------------------------------------------------------------
Syntax
POKEWORD(<nSegment|cHexSegment>,<nOffset|cHexOffset>,
<nWord|cHexWord>) --> lSuccessful
Arguments
<nSegment|cHex> Designates the segment address where a word is
stored. This value can be a decimal integer or hexadecimal string. The
maximum is 65520 ("FFF0").
<nOffset|cHexOffset> Designates the offset address within the
segment specified by <nSegment|cHexSegment>. This value can be a
decimal integer or hexadecimal string. The maximum is 65534 ("FFFE").
<nWord|cHexWord> Designates the word to be stored in memory. This
value can be a decimal integer or hexadecimal string. The maximum is
65535 ("FFFF").
Returns
POKEWORD() returns .T. when the operation is successfully completed. A
return value of .F. indicates an error.
Description
POKEWORD() writes a word to a desired memory area within the
conventional memory. The segment address and offset are required.
Warning! Be aware that this is not always safe. If you
inadvertently manipulate the wrong memory location, there may be serious
consequences. Use POKEWORD() ONLY when you have a thorough knowledge of
the system environment and there is no other solution than to directly
alter a memory location.
Notes
. The function does not test whether the word is stored in
memory.
. POKEWORD() stores the <nWord|cHexWord> word in memory in the
low-byte/high-byte sequence.
Examples
. Poke a word using decimal parameters:
? POKEWORD(32768, 1000, 65535) // Can be dangerous!
. Poke a word using hexadecimal parameters:
? POKEWORD("F000", "8000", "FFFF") // Impossible, ROM area
See Also:
PEEKWORD()
POKEBYTE()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility.
Written by Dave Pearson