RoundRealToNearestInteger

long RoundRealToNearestInteger (double realNumber);

Purpose

Rounds its floating-point argument and returns the result as a long integer. Using the round-half-even algorithm, also known as banker's rounding, the function rounds a value with a fractional part of exactly 0.5 to the nearest even number.

Example Code

long n;
n = RoundRealToNearestInteger (1.2); /* result: 1L */
n = RoundRealToNearestInteger (1.8); /* result: 2L */
n = RoundRealToNearestInteger (1.5); /* result: 2L */
n = RoundRealToNearestInteger (0.5); /* result: 0L */
n = RoundRealToNearestInteger (-1.2); /* result: -1L */
n = RoundRealToNearestInteger (-1.8); /* result: -2L */
n = RoundRealToNearestInteger (-1.5); /* result: -2L */
n = RoundRealToNearestInteger (-0.5); /* result: 0L */

Parameters

Return Value

Additional Information

Library: Utility Library

Include file: utility.h

LabWindows/CVI compatibility: LabWindows/CVI 3.0 and later