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
You can also use VS:Concat to convert numbers to strings. Only problem is that you're limited to 6 significant digits and cannot control that.
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'}
Python
Version
Availability: from All Versions