[<<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