Mod and Modulus (Float functions): Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
mNo edit summary
 
(22 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Template:Float:Mod subtitle}}
{{Template:Float:Mod and Modulus subtitle}}


{{Template:Float:Modulus subtitle}}
The <var>Mod</var> and <var>Modulus</var> [[Intrinsic classes|intrinsic]] functions return the remainder from the division of the method object by the method argument.  The numbers to be divided are first rounded to an integer, including zero, so the remainder is always an integer or zero.


These [[Intrinsic classes|intrinsic]] functions return the remainder
<var>Mod</var> is a synonym for <var>Modulus</var>.
from the division of the method object by the method argument.
The numbers to be divided are first rounded to an integer, including zero,
so the remainder is always an integer or zero.


''Mod'' is a synonym for ''Modulus''.
==Syntax==
{{Template:Float:Mod syntax}}
{{Template:Float:Modulus syntax}}
 
===Syntax terms===
<table class="syntaxTable">
<tr><th>%number</th>
<td>A variable to receive the integral remainder of the quotient of <var class="term">float</var> / <var class="term">divisor</var>. </td></tr>
 
<tr><th>float</th>
<td>A <var>Float</var> value to be divided by the method argument, <var class="term">divisor</var>. </td></tr>


The [[Div (Float function)|Div function]] returns the integral quotient of a division.
<tr><th>divisor</th>
<td>A non-zero numeric value. A <var>divisor</var> with a value of 0, or a value that rounds down to 0, causes a request cancellation.</td></tr>
</table>


The Modulus function is available as of version 7.3 of the [[Sirius Mods]].
==Usage notes==
===Modulus syntax===
<ul>
{{Template:Float:Mod syntax}}
<li><var>Mod</var> / <var>Modulus</var> are available as of <var class="product">Sirius Mods</var> Version 7.3.
{{Template:Float:Modulus syntax}}
</ul>
====Syntax terms====
 
<dl>
==Examples==
<dt>%mod
<ol><li>The following statement returns to <code>%z</code> the remainder from the division of the number in <code>%x</code> (rounded) by the number in <code>%y</code> (rounded):
<dd>A variable to receive the integral remainder of the quotient of ''number'' / ''num''.
<p class="code">  %z = %x:mod(%y)</p>
<dt>number
 
<dd>A Float value to be divided by the method argument, ''num''.
<li>The following statement returns <code>-1</code> to <code>%z</code>:
<dt>num
<p class="code">%z = -191.4:mod(2.0)</p>
<dd>A non-zero numeric value. A value of 0, or a value that rounds down to 0, causes a request cancellation.
 
</dl>
<li>The following displays the quotient and remainder when dividing <code>9997</code> by <code>7</code>:
===Examples===
<p class="code">begin
The following statement returns to %z the remainder from the division of
the number in %x (rounded) by the number in %y (rounded):
    %z = %x:mod(%y)
The following statement returns ''-1'' to %z:
    %z = -191.4:mod(2.0)
The following displays the quotient and remainder when dividing 9997 by 7:
  b
   %dividend is float
   %dividend is float
   %divisor  is float
   %divisor  is float
   %dividend = 9997
   %dividend = 9997
   %divisor  =  7
   %divisor  =  7
   [[PrintText statement|printText]] {~} = {%dividend:div(%divisor)}
   <var>[[Intrinsic classes#printtext|printtext]]</var> {~} = {%dividend:div(%divisor)}
   printText {~} = {%dividend:mod(%divisor)}
   printText {~} = {%dividend:mod(%divisor)}
  end
end</p>
so displays:
The result is:
  %dividend:div(%divisor) = 1428
<p class="output">%dividend:div(%divisor) = 1428
  %dividend:mod(%divisor) = 1
%dividend:mod(%divisor) = 1</p>
 
</ol>
===See also===
[[List of intrinsic Float methods]]
[[Category: Intrinsic Float methods|Mod and Modulus function]]
[[Category: Intrinsic methods]]
 


==See also==
<ul>
<li>The <var>[[Div (Float function)|Div]]</var> function returns the integral quotient of a division.
</ul>


<!--
{{Template:Float:Mod and Modulus footer}}
<section begin=dpl_desc />
Remainder of integer division
<section end=dpl_desc />
-->

Latest revision as of 18:02, 2 November 2012

Remainder of integer division (Float class)


The Mod and Modulus intrinsic functions return the remainder from the division of the method object by the method argument. The numbers to be divided are first rounded to an integer, including zero, so the remainder is always an integer or zero.

Mod is a synonym for Modulus.

Syntax

%number = float:Mod( divisor)

%number = float:Modulus( divisor)

Syntax terms

%number A variable to receive the integral remainder of the quotient of float / divisor.
float A Float value to be divided by the method argument, divisor.
divisor A non-zero numeric value. A divisor with a value of 0, or a value that rounds down to 0, causes a request cancellation.

Usage notes

  • Mod / Modulus are available as of Sirius Mods Version 7.3.

Examples

  1. The following statement returns to %z the remainder from the division of the number in %x (rounded) by the number in %y (rounded):

    %z = %x:mod(%y)

  2. The following statement returns -1 to %z:

    %z = -191.4:mod(2.0)

  3. The following displays the quotient and remainder when dividing 9997 by 7:

    begin %dividend is float %divisor is float %dividend = 9997 %divisor = 7 printtext {~} = {%dividend:div(%divisor)} printText {~} = {%dividend:mod(%divisor)} end

    The result is:

    %dividend:div(%divisor) = 1428 %dividend:mod(%divisor) = 1

See also

  • The Div function returns the integral quotient of a division.
Retrieved from "https://m204wiki.rocketsoftware.com/index.php?title=Mod_and_Modulus_(Float_functions)&oldid=4086"