String.Format(String) Method

Description

Converts the number held by the calling String into a string based on the format specifiers given by formatString. The format specifiers are standard C/C++ specifiers as used with the sprintf function. The Format method converts a double precision floating point value to a string; the IFormat method should be used to convert an integer value to a string.

The format is specified using the syntax shown below. Each field is a single character or a number signifying a particular format option. The flag(s), width, precision, and length are optional. The simplest format specifications contain only the percent sign and a type character (for example, "%f"). For more information, see the Parsing Arbitrary String Data reference.

%[flags][width][.precision][length]type

Flags	Description
-	Left-justify.
+	Always include a plus or minus sign.
(space)	Include a space if no sign will be written.
#	Use alternate form.
0	Left-pad with zeros instead of spaces.

Width	Description
(number)	Minimum number of characters to be printed.

Precision	Description
(number)	Minimum number of digits to be written for integer types; number of digits after the decimal point for floating point types; maximum number of characters to be printed for string types.

Length	Description
h	Short integer
l	Long integer
L	Long double
I64	64-bit integer

Type	Description	Use With
d or i	Signed decimal integer	IFormat
u	Unsigned decimal integer	IFormat
o	Unsigned octal integer	IFormat
x or X	Unsigned hexadecimal integer (lowercase or uppercase)	IFormat
f	Decimal floating point	Format
e or E	Scientific notation (lowercase or uppercase)	Format
g or G	The shorter representation of decimal floating point or scientific notation (lowercase or uppercase)	Format
a or A	Hexadecimal floating point (lowercase or uppercase)	Format
c	Character	IFormat
s	String of characters	Format

Timing Precision Mode

This page describes functionality in nanosecond timing precision mode.

Click here to see the documentation for this object in millisecond timing precision mode.

Method Signature

String.Format(

String formatString)

Arguments

formatString
Description:	Format specifier to use when converting the calling String into a String. The format specifiers are standard C/C++ specifiers as used with the sprintf function.

Return Value

Type:

string

Returns a String containing the converted version of the calling String.

Syntax

myString1 = myString2.Format(myString3);