func ascc

Coerces an expression into a string value.

Syntax

 ascc (value)

Formal Declaration

   ascc:str (value:any)

Parameters

value

An expression to be coerced. Its type can be anything except BOOL.

This function takes the internal bit pattern for value and treats it as a sequence of ASCII characters. The function value returned is a string made up of these characters, the length of which is determined by the natural size of value according to the following table:

Table 10-1 Length of Coerced Strings

Parameter Type	String Length
`U16, S16`	2
`U32, S32, SPTR`	4
`S64, LONG` class	8
`EADDR, SADDR`	12
`STR`	Parameter string length

Examples

   $nmdebug > = ascc(%100+%1)
   'A'
   $nmdebug > wl strlen (ascc(%100+%1))
   $2

The expression %100+%1 is evaluated and coerced into a string value. Since the parameter type is effectively U16, the string contains two characters, a NULL (0) followed by a capital "A".

   $nmdebug > var bell strdel(ascc(7),1,1)
   $nmdebug > wl bell
   <beep>

This example builds a single-character string and assigns the result to the variable named bell. The STRDEL function is used to delete the leading NULL character, which is returned in the two-character string returned by the function ASCC.

Limitations, Restrictions

none

func ascc

Technical documentation

» Table of Contents

» Index

Syntax

Formal Declaration

Parameters

Examples

Limitations, Restrictions