Round (Float function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
m (remove Mods reference)
 
(18 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Template:Float:Round subtitle}}
{{Template:Float:Round subtitle}}


This [[Intrinsic classes|intrinsic]] function returns a floating point number that is the
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.
method object number rounded to a specified number of decimal places.


The <var>Round</var> function is available as of version 7.6 of the <var class=product>Sirius Mods</var>.
==Syntax==
==Syntax==
{{Template:Float:Round syntax}}
{{Template:Float:Round syntax}}
===Syntax terms===
===Syntax terms===
<table class="syntaxTable">
<table class="syntaxTable">
<tr><th>%num </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>number </th>
 
<td>A Float value to be rounded to the number of decimal places specified in the method argument, ''dp''. </td></tr>
<tr><th>float</th>
<tr><th>dp </th>
<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>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==
*Negative numbers are rounded down to the nearest integer; positive numbers are rounded up.
<ul>
<li>Negative numbers are rounded down to the nearest integer; positive numbers are rounded up. </li>
</ul>
 
==Examples==
==Examples==
The following program demonstrates the <var>Round</var> method.
The following program demonstrates the <var>Round</var> method.
  begin
<p class="code">begin
   [[PrintText statement|printText]] {~} = {3.1415926:round}
   [[PrintText statement|printText]] {~} = {3.1415926:round}
   printText {~} = {3.1415926:round(0)}
   printText {~} = {3.1415926:round(0)}
   printText {~} = {3.1415926:round(1)}
   printText {~} = {3.1415926:round(1)}
   printText {~} = {3.1415926:round(4)}
   printText {~} = {3.1415926:round(4)}
  end
end
</p>
The result is:
The result is:
  3.1415926:round = 3
<p class="output">3.1415926:round = 3
  3.1415926:round(0) = 3
3.1415926:round(0) = 3
  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>


==See also==
==See also==
[[List of intrinsic Float methods]]
{{Template:Float:Round footer}}
 
[[Category:Float methods|Round function]]
[[Category:Intrinsic methods]]
 
 
 
<!--
<section begin=dpl_desc />
<var>Round</var> a floating point value to the closest integer
<section end=dpl_desc />
-->

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