@FILL

Top  Previous  Next

Syntax:

 

@FILL( <length> {, <text> { , <justification> }} )

 

Description:

 

The @FILL function creates a string of total length <length> characters.

If no other arguments are supplied, the string is filled with spaces.

If <text> is specified, this text forms the leftmost part of the string, which is then filled out to the required length with spaces. (If the length of <text> is greater than <length>, the text is truncated to <length> characters.)

The <justification> argument can be one of L, R or C. L, the default, means that the text is placed at the left of the string. If R is specified, it is placed at the right. If C is specified, the text is inserted in the center of the string.

If the <justification> argument is Z, the string is filled with binary zeros. This is useful for creating an initialized memory buffer to pass to an API function or other external DLL using the @LIB function.    

 

OK:

 

Unchanged.

 

See also:

 


@LIB