User:Yonicstudios/sandbox

BigInteger provides integer arbitrary-precision arithmetic to Lua modules.

For decimal arbitrary-precision arithmetic, use BCmath, although it is much slower than BigInteger when operating between integers. Both extensions can operate between each other.

BigInteger has the following dependencies:

• The Scribunto extension.
• A PHP installation containing support for GMP. Most installations should already have this.

You can see the version of GMP used by PHP by viewing a phpinfo() web page, or from the command line with the following command:

php-r'echo "gmp: " . ( extension_loaded( "gmp" ) ? GMP_VERSION : "no" ) . "\n";'

Follow these steps to install:

• Download and move the extracted BigInteger folder to your extensions/ directory.
  Developers and code contributors should install the extension from Git instead, using:

  cdextensions/
  gitclonehttps://gerrit.wikimedia.org/r/mediawiki/extensions/BigInteger
  

• Add the following code at the bottom of your LocalSettings.php file:

  wfLoadExtension( 'BigInteger' );
  

• Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Create a BigInteger object, then you can use it in chained operations, expressions (with mixed type support) and function calls. You can use strings and numbers to create BigIntegers and to operate between them. The decimal part is truncated in both types. Note that with Lua numbers, IEEE 754-exclusive values (NaNs and infinities) will throw an error, while 0 has the sign dropped.

-- Shortname for using the library
localBigInt=mw.extensions.biginteger
-- Used for chained operations
localsum1=BigInt.new(0):add(42)-- 42
localsum2=BigInt.new(0.0):add(42.0)-- 42
localsum3=BigInt.new('0'):add('42')-- 42
-- Used in an expression
localsum4=sum1*sum2+3.14-- 1767
-- Used in function calls
localsum4=BigInt.add(mw.bcmath.mul(sum1,sum2),3.14)-- 1767
-- Conversion to string and to BCmath
localstr=tostring(sum4)-- "1767"
localbcnum=mw.bcmath.new(str):add(3.14)-- 1770.140000000

For further help, see the generated LDoc documentation.

The following configuration variables are available:

$wgGMPMaxDigits

Sets the maximum number of digits used for operating between big integers. The least significant digits are trimmed when an integer exceeds this amount. Note that the result may have more digits than this limit when converted to a string. By default, it's set to 100.

$wgGMPMaxFactorial

Sets the maximum value to calculate the factorial of an integer. Calculating the factorial of a number larger than this will result in a Lua error. By default, it's set to 1000.

• Scribunto
• Lua reference manual
• BCmath

• Experimental extensions
• API extensions
• GPL licensed extensions
• Extensions in GitHub version control
• ScribuntoExternalLibraries extensions
• All extensions

• Extensions without an image
• Extensions with release branches compatibility policy
• Extensions with manual MediaWiki version
• Extensions not in ExtensionJson