# VS:Num2Str

.VectorScript|VectorScript ..VS:Function Reference|Function Reference ..VS:Function_Reference_Appendix|Appendix

## Description

Function Num2Str converts a REAL value to a string and returns the value.

Parameter decPlace has a range of -1 to 9; if -1 is specified, the value will be returned in scientific notation.

`FUNCTION Num2Str(         decPlace   :INTEGER;         v          :REAL) : STRING;`
```def vs.Num2Str(decPlace, v):
return STRING```

## Parameters

 decPlace INTEGER Number of decimal places. v REAL Numeric value.

## Remarks

(Orso, 2014.09.14):

You can also use VS:Concat to convert numbers to strings, but it uses exclusively a dot "." as symbol for the decimal marker, because it outputs the number as seen from inside VS, I suppose. See the table below for a list of routines formatting according to your system's settings.

+ symbol for the decimal marker
Metric: ',' American '.'
100,123
100.123
Formatting routines: Non formatting routines:
VS:Num2Str, VS:Num2StrF, VS:Angle2Str, VS:Area2Str, VS:Volume2Str
`Num2Str(3, 100.123) { --> 100,123 on metric systems } `
`Num2Str(3, 100.123) { --> 100.123 on American systems } `
VS:Concat
`Concat(100.123) { --> 100.123 on any system } `

The parameter decPlace can be the following values:

Value Meaning Sample
positive round-up the value 10.56 -> 10.6 (1 decimal place)
0 round-up the value 10.56 -> 11
-1 Use scientific notation (9 decimal places) 10.56 -> 1.056000000e+001
-2 Use scientific notation (15 decimal places) 10.56 -> 1.056000000000000e+001

## Example

#### VectorScript

```oldnumValue := 232.5148;
newStrValue := Num2Str(3, oldnumValue);
{ would return '232.515' if your system is american }
{ would return '232,515' if your system is metric }
```

```
```

## Version

Availability: from All Versions