Round (Float function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (match syntax diagram to template; fix tags and links)
m (remove Mods reference)
 
(4 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Template:Float:Round subtitle}}
{{Template:Float:Round subtitle}}


The <var>Round</var> <var>[[Intrinsic classes|intrinsic]]</var> function returns a floating point number that is the method object number rounded to a specified number of decimal places.
The <var>Round</var> [[Intrinsic classes|intrinsic]] function returns a floating point number that is the method object number rounded to a specified number of decimal places.


==Syntax==
==Syntax==
{{Template:Float:Round syntax}}
{{Template:Float:Round syntax}}
===Syntax terms===
===Syntax terms===
<table class="syntaxTable">
<table class="syntaxTable">
<tr><th>%number</th>
<tr><th>%number</th>
<td>A variable to receive the floating point result. </td></tr>
<td>A variable to receive the floating point result. </td></tr>
<tr><th>float</th>
<tr><th>float</th>
<td>A <var>Float</var> value to be rounded to the number of decimal places specified in the method argument, <var class="term">number</var>. </td></tr>
<td>A <var>Float</var> value to be rounded to the number of decimal places specified in the method argument, <var class="term">dp</var>. </td></tr>
<tr><th>number</th>
 
<tr><th>dp</th>
<td>A numeric value that specifies the number of decimal places to which the input number is rounded. This value defaults to 0, and it must be between 0 and 75.</td></tr>
<td>A numeric value that specifies the number of decimal places to which the input number is rounded. This value defaults to 0, and it must be between 0 and 75.</td></tr>
</table>
</table>


==Usage notes==
==Usage notes==
<ul><li>Negative numbers are rounded down to the nearest integer; positive numbers are rounded up.
<ul>
<li><var>Round</var> is available as of <var class="product">[[Sirius Mods|"Sirius Mods"]]</var> Version 7.6.</ul>
<li>Negative numbers are rounded down to the nearest integer; positive numbers are rounded up. </li>
</ul>


==Examples==
==Examples==
<ol><li>The following program demonstrates the <var>Round</var> method.
The following program demonstrates the <var>Round</var> method.
<p class="code">begin
<p class="code">begin
   [[PrintText statement|printText]] {~} = {3.1415926:round}
   [[PrintText statement|printText]] {~} = {3.1415926:round}
Line 33: Line 37:
3.1415926:round(1) = 3.1
3.1415926:round(1) = 3.1
3.1415926:round(4) = 3.1416
3.1415926:round(4) = 3.1416
</p></ol>
</p>


==See also==
==See also==
{{Template:Float:Round footer}}
{{Template:Float:Round footer}}

Latest revision as of 22:38, 22 May 2017

Round a floating point number to specified decimal places (Float class)


The Round intrinsic function returns a floating point number that is the method object number rounded to a specified number of decimal places.

Syntax

%number = float:Round[( [dp])]

Syntax terms

%number A variable to receive the floating point result.
float A Float value to be rounded to the number of decimal places specified in the method argument, dp.
dp A numeric value that specifies the number of decimal places to which the input number is rounded. This value defaults to 0, and it must be between 0 and 75.

Usage notes

  • Negative numbers are rounded down to the nearest integer; positive numbers are rounded up.

Examples

The following program demonstrates the Round method.

begin printText {~} = {3.1415926:round} printText {~} = {3.1415926:round(0)} printText {~} = {3.1415926:round(1)} printText {~} = {3.1415926:round(4)} end

The result is:

3.1415926:round = 3 3.1415926:round(0) = 3 3.1415926:round(1) = 3.1 3.1415926:round(4) = 3.1416

See also