Coerces an expression into a GRP logical code pointer (LCPTR).
Syntax |
 |
During the evaluation of the parameter to this function, the search path used for procedure name lookups is limited to the group library file (GRP).
Formal Declaration |
|
Parameters |
|
- value
An expression to be coerced. All types are valid.
Table 8-5 Derivation of the GRP Bit Pattern
| Parameter Type | Action |
|---|
| 0.1 if TRUE, 0.0 if FALSE. |
| Set the SID part to zero.
Right justify the original value in the low-order 32 bits of the offset part
with zero fill. |
| Set the SID part to zero.
Right justify the original value in the low-order 32 bits of the offset part
with sign extension. |
| Transfer both parts of the address unchanged. |
| Transfer the SID part unchanged. Transfer the low-order 32 bits of
the offset part. |
| Transfer the ASCII bit pattern for the last eight characters in the
string. Strings shorter than eight characters are treated as if they were
extended on the left with nulls.
|
Examples |
|
%cmdebug > wl grp( 12.304 )
GRP %12.304
|
Coerce the simple long pointer into a GRP logical code pointer.
%cmdebug > wl grp( sort )
GRP %2.1364
|
Print the address of the procedure named sort.
Note that the search path
used for procedure name lookups is restricted to the group library (GRP).
%cmdebug > wl grp( sys(24.630) )
GRP %24.630
|
The coercion simply changes the associated logical file. Note that
no complicated conversion or range checking is performed.
$nmdat > wl grp( 1 )
GRP $0.1
$nmdat > wl grp( ffff )
GRP $0.ffff
$nmdat > wl grp( 1234abcd )
GRP $0.1234abcd
$nmdat > wl grp( -1 )
GRP $0.ffffffff
$nmdat > wl grp( 1234.5678 )
GRP $1234.5678
$nmdat > wl grp( true )
GRP $0.1
$nmdat > wl grp( "ABCDEFG" )
GRP $414243.44454647
|
Limitations, Restrictions |
|
none
