HP 3000 Manuals

func trans [ System Debug Reference Manual ] MPE/iX 5.0 Documentation


System Debug Reference Manual

func trans 

Coerces an expression into a TRANS logical code pointer (LCPTR).

Syntax 

     trans (value)

Formal Declaration 

     trans:trans (value:any)

Parameters 

 value           An expression to be coerced.  All types are acceptable.

          Derivation of the TRANS Bit Pattern 

--------------------------------------------------------------------------------------------
|                           |                                                              |
|      Parameter Type       |                            Action                            |
|                           |                                                              |
--------------------------------------------------------------------------------------------
|                           |                                                              |
| BOOL                      | 0.1 if TRUE, 0.0 if FALSE.                                   |
|                           |                                                              |
--------------------------------------------------------------------------------------------
|                           |                                                              |
| U16                       | Set the high-order 32 bits (SID or segment part) to zero.    |
| S16                       | Right justify the original 16-bit value in the low-order 32  |
|                           | bits (offset part) with zero fill.                           |
|                           |                                                              |
--------------------------------------------------------------------------------------------
|                           |                                                              |
| U32                       | Set the high-order 32 bits (SID or segment part) to zero.    |
| S32                       | Transfer the original bit pattern into the low-order 32 bits |
| SPTR                      | (offset part) unchanged.                                     |
|                           |                                                              |
--------------------------------------------------------------------------------------------
|                           |                                                              |
| LPTR                      | Transfer both parts of the address unchanged.                |
| PROG                      |                                                              |
| GRP                       |                                                              |
| PUB                       |                                                              |
| LGRP                      |                                                              |
| LPUB                      |                                                              |
| SYS                       |                                                              |
| USER                      |                                                              |
| TRANS                     |                                                              |
| CST                       |                                                              |
| CSTX                      |                                                              |
|                           |                                                              |
--------------------------------------------------------------------------------------------
|                           |                                                              |
| STR                       | 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 trans(12.304) 
     TRANS %12.304

Coerce the simple long pointer into a TRANS logical code pointer.

     %cmdebug > wl trans(sys(24.630)) 
     TRANS %24.630

The coercion simply changes the type.  Note that no complicated
conversion or range checking is performed.

Limitations, Restrictions 

none



MPE/iX 5.0 Documentation