[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 PEEKSTR()
 Reads a byte sequence from memory
------------------------------------------------------------------------------
 Syntax

     PEEKSTR(<nSegment|cHexSegment>, <nOffset|cHexOffset>,
        [<nLength|cHexLength>]) --> cCharacterString

 Arguments

     <nSegment|cHex>  Designates the segment address from which the
     character sequence string is read.  This value can be a decimal integer
     or hexadecimal string.

     <nOffset|cHexOffset>  Designates the offset address within the
     segment specified by <nSegment|cHexSegment>.  This value can be a
     decimal integer or hexadecimal string.

     <nLength|cHexLength>   Designates the string length to read, up to a
     maximum of 65520.  This value can be a decimal integer or a hexadecimal
     string.  The default, PEEKSTR(), reads to the first CHR(0).

 Returns

     PEEKSTR() returns the character string read from memory.

 Description

     PEEKSTR() reads an area of memory and returns it as a string.  The
     function reads to the first CHR(0) or the length specified through
     <nLength|cHexLength>.

 Example

     The AT BIOS copyright is found at the F000:0h address.  Therefore, each
     byte is repeated and CHARODD() is used to display it.  It reads to the
     first CHR(0):

     ? CHARODD(PEEKSTR("F000", 0))      // "19xx, 19xx Copyright...."


See Also: PEEKBYTE() PEEKWORD()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson