Teledyne LeCroy SATracer 3G Verification Script Engine manual - Manual (Page 63)

LeCroy Corporation Verification Script Engine Reference Manual Version 1.01
20 String Manipulation/formating Functions
20.1 FormatEx()
Write formatted data to a string. FormatEx() is used to control the way that arguments will
print out. The format string may contain conversion specifications that affect the way in which the
arguments in the value string are returned. Format conversion characters, flag characters and field
width modifiers are used to define the conversion specifications.
Format :
FormatEx ( format_string, argument_list )
Parameters:
format_string - Format-control string
argument_list- Optional list of arguments to fill in the format string
Return Values:
Formatted string .
Format conversion characters:
Code Type Output
c Integer Character
d Integer Signed decimal integer
i Integer Signed decimal integer
o Integer Unsigned octal integer
u Integer Unsigned decimal integer
x Integer Unsigned hexadecimal integer, using "abcdef."
X Integer Unsigned hexadecimal integer, using "ABCDEF."
s String String
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 .
58