$nav
===== Function: llRound =====

<code lsl2>
integer llRound(float fval)
</code>

Round a $lty[float] to the nearest integer.

===== Parameters =====

=== fval ===
The $lty[float] value to be rounded.

===== Return value =====

Returns the integer value that is the nearest to $prm[fval]. If the decimal part is exactly .5, it will be rounded up (towards positive infinity).

===== Notes =====

  * The function returns -2147483648 (Hex. 0x80000000) for float values of 2147483648.0 or bigger (including $pinf), or less than -2147483648.0 (including $minf), or $nan.

===== Short examples =====

<code lsl2>
integer i;
// Any float between 2.5 and approx. 3.4999998 will cause the function to return 3
// (3.4999998 is the biggest possible float less than 3.5, due to float limitations)
i = llRound(2.6);    // i will become 3
i = llRound(3.3);    // i will become 3
i = llRound(3.499);  // i will become 3
i = llRound(3.5);    // i will become 4
i = llRound(3.501);  // i will become 4
// Any float between -3.5 and approx. -2.5000002 will cause the function to return -3
// (-2.5000002 is the biggest possible float less than -2.5, due to float limitations)
i = llRound(-3.3);   // i will become -3
i = llRound(-3.499); // i will become -3
i = llRound(-3.5);   // i will become -3
i = llRound(-3.501); // i will become -4
</code>

===== See also =====

  * $lfn[llCeil] rounds always towards positive infinity (e.g. 1.1 is rounded up to 2.0, and -1.1 is rounded up to -1.0).
  * $lfn[llFloor] rounds always towards negative infinity (e.g. 1.1 is rounded down to 1.0 and -1.1 is rounded down to -2.0).
  * $lty[float] type and associated caveats and limitations.