Teledyne LeCroy SierraFC Verification Script Engine Reference Manual User Manual

Page 60

Verification Script Engine Reference Manual

Remark:

A conversion specification begins with a percent sign (%) and ends with a conversion

character. The following optional items can be included, in order, between the % and the conversion
character to further control argument formatting:

• Flag characters are used to further specify the formatting. There are five flag characters: A

minus sign (-) will cause an argument to be left-aligned in its field. Without the minus sign, the
default position of the argument is right-aligned.

• A plus sign will insert a plus sign (+) before a positive signed integer. This only works with the

conversion characters d and i.

• A space will insert a space before a positive signed integer. This only works with the

conversion characters d and i. If both a space and a plus sign are used, the space flag will be
ignored.

• A hash mark (#) will prepend a 0 to an octal number when used with the conversion character

o. If # is used with x or X, it will prepend 0x or 0X to a hexadecimal number.

• A zero (0) will pad the field with zeros instead of with spaces.

• Field width specification is a positive integer that defines the field width, in spaces, of the

converted argument. If the number of characters in the argument is smaller than the field width,
then the field is padded with spaces. If the argument has more characters than the field width
has spaces, then the field will expand to accommodate the argument.

Example:

str = "String";

i = 12;

hex_i = 0xAABBCCDD;

…

formatted_str = FormatEx( "%s, %d, 0x%08X", str, i, hex_i );

# formatted_str = "String, 12, 0xAABBCCDD"