HP 3000 Manuals

System Debug Reference Manual

func strextract 

String extract.  Returns a string (extracted) from the specified virtual
address.

Syntax 

     strextract (virtaddr [length])

Formal Declaration 

     strextract:str (virtaddr:ptr [length:u16=$4])

Parameters 

 virtaddr        The virtual address of the start of the string.

                 Virtaddr can be a short pointer, a long pointer, or a
                 full logical code pointer.

 length          The number of characters to retrieve starting at
                 virtaddr.  If this parameter is not specified, the
                 string returned will be four characters long.  If the
                 value given in length is greater than the maximum string
                 size, the string returned is truncated to the maximum
                 size.

Examples 

     $nmdebug > dv r28, 4, a 
     VIRT $12f.4000d638   ASCII  EXCL USIV E VI OLAT
     $nmdebug > wl strextract (r28, 9) 
     EXCLUSIVE

Register R28 is used as the virtual address at which a nine-character
string is extracted.

     $nmdebug > var tblname strextract(b0002c40) 

The variable tblname is assigned a four-character string which is
extracted from the virtual address defined by the short pointer
(b0002c40).

Limitations, Restrictions 

If length is greater than the maximum supported string length (see the
STRMAX function), only up to STRMAX characters are returned.

MPE/iX 5.0 Documentation