You are currently not logged in! Enter your authentication credentials below to log in. You need to have cookies enabled to log in.
This shows you the differences between two versions of the page.
|
functions:llround [2014-05-16 04:35 SLT] sei Enhance examples |
functions:llround [2015-02-04 13:29 SLT] (current) sei pinf and minf |
||
|---|---|---|---|
| Line 1: | Line 1: | ||
| + | $nav | ||
| ===== Function: llRound ===== | ===== Function: llRound ===== | ||
| Line 5: | Line 6: | ||
| </code> | </code> | ||
| - | Round a float to the nearest integer. | + | Round a $lty[float] to the nearest integer. |
| ===== Parameters ===== | ===== Parameters ===== | ||
| === fval === | === fval === | ||
| - | The float value to be rounded. | + | The $lty[float] value to be rounded. |
| - | ===== Result ===== | + | ===== Return value ===== |
| - | Returns the integer value that is the nearest to **fval**. If the decimal part is exactly .5, it will be rounded up (towards positive infinity). | + | 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 ===== | ===== Notes ===== | ||
| - | * The function returns -2147483648 (Hex. 80000000) for float values of 2147483648.0 or bigger, or less than -2147483648.0. | + | * 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 ===== | ===== Short examples ===== | ||
| Line 24: | Line 25: | ||
| <code lsl2> | <code lsl2> | ||
| integer i; | integer i; | ||
| - | i = llRound(-3.3); // i will become -3 | + | // 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.3); // i will become 3 | ||
| + | i = llRound(3.499); // i will become 3 | ||
| i = llRound(3.5); // i will become 4 | 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.5); // i will become -3 | ||
| - | i = llRound(-99.6); // i will become -100 | + | i = llRound(-3.501); // i will become -4 |
| </code> | </code> | ||
| ===== See also ===== | ===== See also ===== | ||
| - | * [[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[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). |
| - | * [[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). | + | * $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). |
| - | * [[types/float]] type and associated caveats and limitations. | + | * $lty[float] type and associated caveats and limitations. |