func s16

Coerces an expression into a signed 16-bit value.

Syntax

   s16 (value)

Formal Declaration

   s16:s16 (value:any)

Parameters

value: An expression to be coerced. All types are valid.

Table 8-11 Derivation of the S16 Bit Pattern

Parameter Type	Action
`BOOL`	1 if `TRUE`, 0 if `FALSE`.
`U16 S16`	Transfer the original bit pattern unchanged.
`U32 S32 S64 SPTR`	Transfer the low-order 16 bits.
`LONG` Class `EADDR SADDR`	Transfer the low-order 16 bits of the offset part.
`STR`	Transfer the ASCII bit pattern for the last two characters in the string. Strings shorter than two characters are treated as if they were extended on the left with nulls.

Examples

   $nmdat > wl s16( 1 )

   $1



   $nmdat > wl s16( ffff )

   $ffff



   $nmdat > wl s16( ffff ):"#"

   #-1



   $nmdat > wl s16( 1234abcd )

   $abcd



   $nmdat > wl s16( -1 )

   $ffff



   $nmdat > wl s16( 1234.5678 )

   $5678



   $nmdat > wl s16( true )

   $1



   $nmdat > wl s16( "ABCDEFG" )

   $4647



   $nmdat > wl s16( prog(1.2) )

   $2

Limitations, Restrictions

none

func s16

Technical documentation

» Table of Contents

» Index

Syntax

Formal Declaration

Parameters

Examples

Limitations, Restrictions