Variable.ToString(String) Method

Top

Description

Converts the number held by the calling Variable 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"). A common format specification is rounding a floating point to a number of digits after the decimal point. 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
d or i	Signed decimal integer
u	Unsigned decimal integer
o	Unsigned octal integer
x or X	Unsigned hexadecimal integer (lowercase or uppercase)
f	Decimal floating point
e or E	Scientific notation (lowercase or uppercase)
g or G	The shorter representation of decimal floating point or scientific notation (lowercase or uppercase)
a or A	Hexadecimal floating point (lowercase or uppercase)
c	Character
s	String of characters

Timing Precision Mode

This page describes functionality in millisecond timing precision mode. Millisecond timing precision mode is deprecated and will be removed in a future release. We recommend that you migrate your Mission Plans to nanosecond timing precision mode.

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

Method Signature

Variable.ToString(

String format)

Arguments

format
Description:	The format specification to use when converting the value to a string.

Return Value

Type:

string

The resulting String from the conversion.

Syntax

myString1 = myVariable1.ToString(myString2);