Difference between revisions of "SHIP:Sail:itof"

From Serious Documentation
Jump to: navigation, search
Line 52: Line 52:
 
|<code>{{SailFunc|itof}}(5);</code> || 5.0 ||
 
|<code>{{SailFunc|itof}}(5);</code> || 5.0 ||
 
|}
 
|}
 +
 +
[[Categories: Numeric Functions]]

Revision as of 14:35, 4 October 2016

Function Returns Introduced Description
itof Integer v5.0 Explicitly casts an Integer to a Float Badge SHIPv5.gif

See Also:

Prototype

Float itof(Integer n);

Parameters/Return Value

Parameter Data Type Description
n Integer the number to cast
Return Float the floating point version of the supplied number

Detailed Description

The itof() function explicitly casts the supplied Integer to an Float. You may want to use this in mathematical expressions around items so that the expression evaluation is moved into the floating point domain. For example:

intValue = 5/4*10;

will return 10 since the whole expression is evaluated at run-time in the Integer domain, and 5/4 will be evaluated using integer math resulting in 1. However,

intValue = 5/itof(4)*10;

will return 11 since the 5/4 will be evaluated using floating point math. Obviously, this is equivalent to:

intValue = 5/4.0f*10;

However,this methodology becomes more useful when a function that returns a Float is used:

intValue = 5/itof(strlen(s))*10;

Examples

Example Result Notes
itof(-5); -5.0
itof(5); 5.0

Categories: Numeric Functions