
tofloat
Converts values of any snumeric data type or string to values of type float.
Available in version 5.2.0 and later.
Prototype
function tofloat ( input_val : snumeric data type or string ) return_val [dimsizes(input_val)] : float
Arguments
input_valA variable of any snumeric data type or string of any dimension.
Return value
Returns floats. If the input variable is double or signed/unsigned long, or 64-bit integer, there may be some precision lost. The dimensionality of the output matches that of the input.
Any input value that is out of range for a float will be returned as a missing value.
Description
This function converts any snumeric data or string to float values. If the input is double or signed/unsigned long, or 64-bit integer, there may be some precision lost.
Any input value that is out of range for a float will be returned as a missing value.
Attributes, with the exception of _FillValue, are not propagated by the conversion functions.
Special considerations apply to how missing values and out-of-range values are handled in the conversion functions. For this function an out-of-range value could be valid in its original type, but not in the valid range of a float. An out-of-range value is converted to a missing value, but what that missing value is depends on the circumstances of the particular conversion being performed. For example, determination has to be made whether a missing value for a variable to be converted is in the range of the type of the target variable.
See Also
tochar, tobyte, toshort, toushort, toint, touint, tolong, toulong, toint64, touint64, tostring, totype
Examples
Example
a = 64.5 b = 31.26 c = a - b d = a + b e = a * b f = e / c g = (/a, b, c, d/) print(a) print(b) print(c) print(d) print(e) print(f) print(g) h = abs(-a) print(h) i = min(g) print(i) j = max(g) print(j) short_array = new((/2,2/), short) short_array = 215h print(short_array) short2float = tofloat(short_array) print(short2float) ushort_array = new((/2,2/), ushort) ushort_array = 8924H print(ushort_array) ushort2float = tofloat(ushort_array) print(ushort2float) int_array = new((/2,2/), integer) int_array = 2147483640 print(int_array) int2float = tofloat(int_array) print(int2float) uint_array = new((/2,2/), uint) uint_array = 2147483649I print(uint_array) uint2float = tofloat(uint_array) print(uint2float) long_array = new((/2,2/), long) long_array = 2147483641l print(long_array) long2float = tofloat(long_array) print(long2float) ulong_array = new((/2,2/), ulong) ulong_array = 2147483649L print(ulong_array) ulong2float = tofloat(ulong_array) print(ulong2float) int64_array = new((/2,2/), int64) int64_array = 9223372028264841214q print(int64_array) int642float = tofloat(int64_array) print(int642float) uint64_array = new((/2,2/), uint64) uint64_array = 9223372028264841219Q print(uint64_array) uint642float = tofloat(uint64_array) print(uint642float) str_array = new((/2,2/), string, "997452379") str_array = "123.456" print(str_array) str2float = tofloat(str_array) print(str2float) float_array = new((/2,2/), float) float_array = 1.2384 print(float_array) float2float = tofloat(float_array) print(float2float) double_array = new((/2,2/), double) double_array = 12.94 print(double_array) double2float = tofloat(double_array) print(double2float) double_array = 1238278456.02394 print(double_array) double2float = tofloat(double_array) print(double2float)