Teledyne LeCroy UWBTracer Verification Script Engine Manual - Manual (Page 89)

LeCroy Corporation Verification Script Engine Manual, version 2.2
Remarks:
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 (-) causes 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 inserts a plus sign (+) before a positive signed integer. This only works with the conversion
characters d and i.
• A space inserts 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 is ignored.
• A hash mark (#) prepends a 0 to an octal number when used with the conversion character o. If # is
used with x or X, it prepends 0x or 0X to a hexadecimal number.
• A zero (0) pads 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 expands 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"
Page 89 of 95