func ltos
MPE documents | |
 Complete PDF | |
| Table of Contents | |
| Index | |
| E0201 Edition 4 ♥ | |
| E0300 Edition 3 | |
| E0692 Edition 3 |
Syntax
ltos (virtaddr)The LTOS function converts a virtual address to a short pointer. If the parameter virtaddr is already a short pointer, it is simply returned. If the parameter virtaddr is a long pointer, or a full logical code address, a special additional test is performed to ensure that the offset portion can be returned as the short pointer value. The SID (space) portion must match the current value of the associated space register. This ensures that the returned short pointer value can be successfully converted back into the long pointer argument.
Formal Declaration
ltos:sptr (virtaddr:ptr)
Parameters
- virtaddr
The virtual address to be converted to a short pointer.
Virtaddr can be a short pointer, a long pointer, or a full logical code pointer.
Examples
$nmdebug > wl pc
PROG $3c.12004
$nmdebug > wl ltos(pc)
$12004
$nmdebug > var save 42.40151025
$nmdebug > wl ltos(save)
$40151025
$nmdat > dr sr4
SR4=$a
$nmdat > wl ltos(22.200)
SID in LPTR for LTOS conversion does not match corresponding
space reg.
Error evaluating a predefined function. (error #4240)
function is"ltos"
In this example SR4 contains $a. The function LTOS detects
that the SID portion of the long pointer ($22) does not match the
value of the associated space register (SR4=$a), and the conversion
fails.
Limitations, Restrictions
none
|
func ltolog |
func macbody |