pTAL Conversion Guide

pTAL Built-In Routines
pTAL Conversion Guide—527302-002
18-24
$FILL8, $FILL16 and $FILL32
$FILL8, $FILL16 and $FILL32
$FILL8, $FILL16, and $FILL32 fill an array or structure with repetitions of an 8-bit,
16-bit, or 32-bit value, respectively (sometimes called a “smear” operation).
area-to-fill
is a variable of any data type. The address of area-to-fill specifies the
beginning of the area to fill.
repetitions
is an INT expression whose value specifies the number of times to write.
value
is an expression whose value is a STRING value for $FILL8, to an INT value for
$FILL16, and to an INT(32) value for $FILL32.
$FILL16 and $FILL32 cause an alignment trap if area-to-fill is not aligned to at
least a 2-byte boundary.
Example 18-15. Call to $EXTADDR_TO_WADDR Routine
PROC p(x);
INT .EXT x;
BEGIN
INT .j;
@j := $EXTADDR_TO_WADDR(@x);
@j := $EXTADDR_TO_WADDR(x); ! ERROR: x is INT, not EXTADDR
END;
pTAL privileged procedure No
Can be executed only by privileged procedures No
Sets condition code No
Sets $CARRY No
Sets $OVERFLOW No
CALL
$FILL8
$FILL16
$FILL32
( area-to-fill , repetitions , value )
VST688.vsd