Truncate or floor a number with decimal digits to a whole number.
Namespace:
XSharp.RT
Assembly:
XSharp.RT (in XSharp.RT.dll) Version: 2.7
Syntax FUNCTION Integer(
nValue AS USUAL
) AS USUAL
public static Usual Integer(
Usual nValue
)
Request Example
View SourceParameters
- nValue
- Type: Usual
The number to truncate or floor.
Return Value
Type:
Usual
The whole number to the left of the decimal point. Since both <uValue> and the return value are data type USUAL, you are not limited to the size of an integer.
Remarks
Integer() converts a numeric value to an integer by taking the floor of the number. Note – this is not the same as truncation except for positive integers — it is not rounding. Integer() is useful in operations where the decimal portion of a number is not needed.
Note that a loss of precision on floating numbers might be significant.
For example, you might not know that a number is internally represented as 0.99999999999999999, because, when that number is displayed with QOut() or passed to the Str() function, internal rounding returns a value of 1.0.
When a number like that is passed to the Integer() function, however, its decimal portion is truncated and a value of zero is returned.
If this is not what you had intended, you can use Round(<nValue>, 0) instead of Integer().
Tip |
---|
Integer() is the same as the Int() function in CA-Clipper, but INT is a reserved word in X#.
Under X#, Int() is a conversion operator. With numbers that are not greater than a short integer, it yields the same results as Integer() and maintains compatibility with CA-Clipper.
|
Examples
These examples demonstrate the results of various invocations of the Integer() function:
1? Integer(100.00)
2? Integer(.5)
3? Integer(-100.75)
4? Integer(-1.2)
See Also