Variable.IFormat(String) Method

Top 

Description

Converts the number held by the calling object into a string based on the specified format specifiers. The format specifiers are standard C/C++ specifiers as used with the sprintf function. The IFormat method converts an integer value to a string; the Format method should be used to convert a double precision floating point 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 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.IFormat(

String formatString)

 

 

Arguments

formatString


Description:

Format specifier to use when converting the calling integer Variable into a String.

 

 

 

Return Value

Type:

string

 

 

Converts an integer value to a string. If the calling Variable is not an integer, only the integer part of the value will be used.

 

Syntax

myString1 = myVariable1.IFormat(myString2);

 

 

See also

Variable Object

Matrix, Array, and Variable Math Guide