Str Function

Description

Returns a string representation of a number.

Syntax

Str(number)

The number argument is any valid numeric expression.

Remarks

When numbers are converted to strings, a leading space is always reserved for the sign of number. If number is positive, the returned string contains a leading space and the plus sign is implied.

Use the Format function to convert numeric values you want formatted as dates, times, or currency or in other user-defined formats. Unlike Str, the Format function doesn’t include a leading space for the sign of number.

Note The Str function recognizes only the period (.) as a valid decimal separator. When a possibility exists that different decimal separators may be used (for example, in international applications), you should use CStr to convert a number to a string.

See Also

CStr Function, Format Function, Val Function.

Example

This example uses the Str function to return a string representation of a number. When a number is converted to a string, a leading space is always reserved for its sign.


MyString = Str(459)            ' Returns " 459".= Str(-459.65)        ' Returns "-459.65".= Str(459.001)        ' Returns " 459.001".