View source for Extension:BCmath/pl

<languages/>
{{Extension|templatemode =
|status               = experimental
|type1                = api
|type2                = 
|hook1                = ScribuntoExternalLibraryPaths
|hook2                = ScribuntoExternalLibraries
|username             = Jeblad
|author               = * {{Nowrap|John Erling Blad}}
|description          = <span lang="en" dir="ltr" class="mw-content-ltr">Provides arbitrary-precision arithmetic for Scribunto.</span>
|image                = PI constant.svg
|imagesize            = 320
|version              =
|update               =
|mediawiki            =
|php                  =
|needs-updatephp      = No
|schema-registry      =
|license              = GPL-2.0+
|download             = {{GithubDownload|jeblad|BCmath}}
|readme               = [https://github.com/jeblad/BCmath/blob/master/README.md README], [https://jeblad.github.io/BCmath/ LDoc]
|changelog            =
|parameters           =
|tags                 =
|rights               =
|example              =
|compatibility policy = master
|compatibility        =
|translate            = mwgithub-bcmath
}}
<span lang="en" dir="ltr" class="mw-content-ltr">'''BCmath''' provides [[w:arbitrary-precision arithmetic|arbitrary-precision arithmetic]] to [[Special:MyLanguage/Help:Lua|Lua modules]].</span>
<span lang="en" dir="ltr" class="mw-content-ltr">With the lib from this extension it would be completely valid to do calculations on 𝜋 <!-- mathematical italic small pi --> with 125 characters, 𝜋 ≅ 3,141 592 653 589 793 238 462 643 383 279 502 884 197 169 399 375 105 820 974 944 592 307 816 406 286 208 998 628 034 825 342 117 067 982 148 086 513 282 306 647 093 8… (Actually, the real 𝜋 is even [[w:transcendental number|infinitely much longer]]!)</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
The extension uses PHP [https://php.net/book.bc ''BCMath Arbitrary Precision Mathematics''] api through use of [https://github.com/phpseclib/bcmath_compat phpseclib/bcmath_compat] to access the [[w:bc (programming language)|bc programming language]].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Installation ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Expect depends on modules from the {{ll|Extension:Scribunto|Scribunto}} extension.
</div>
{{ExtensionInstall
|repo-name=BCmath
|registration=required
|download-link=[https://github.com/jeblad/BCmath/archive/master.zip <span lang="en" dir="ltr" class="mw-content-ltr">Download</span>]
}}

<div lang="en" dir="ltr" class="mw-content-ltr">
== Usage ==
</div>
<span lang="en" dir="ltr" class="mw-content-ltr">The workflow is to first define a BCmath instance, and then use that in ordinary equations, in chained operations, or as part of function calls.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">Existence of an instance in supported operations will trigger use of the special functions and methods.</span>

<syntaxhighlight lang="Lua">
-- Used for chained operations
local sum1 = mw.bcmath.new( 0.0 ):add( 42.0 )                   -- 42.000000000000000
local sum2 = mw.bcmath.new( '0' ):add( '42' )                   -- 42

-- Used in an equation
local sum3 = sum1 * sum2 + 3.14                                 -- 1767.140000000000000

-- Used in function calls
local sum4 = mw.bcmath.add( mw.bcmath.mul( sum1, sum2 ), 3.14 ) -- 1767.140000000000000
local str1 = sum4 'sci'                                         -- 1.767140000000000000e3
local str2 = sum4( 'sci', 4 )                                   -- 1.767e3
</syntaxhighlight>

<div lang="en" dir="ltr" class="mw-content-ltr">
For further help, see the generated [https://jeblad.github.io/BCmath/ LDoc] documentation.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
== Development ==
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
For recreating the Vagrant-based development environment, see [https://jeblad.github.io/BCmath/manual/vagrant.md.html BCmath: Manual/Vagrant].
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
==Alternatives==
</div>
<span lang="en" dir="ltr" class="mw-content-ltr">The best and perhaps only real alternative is the ''decNumber'' [[w:C (programming language)|C-library]], which implements [[w:IEEE 754r|IEEE 754r]], and the ''ldecNumber'' Lua wrapper library for interfacing with decNumber.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">These two must be used together.</span>
* decNumber (C-library)
** [http://speleotrove.com/decimal/decnumber.html <span lang="en" dir="ltr" class="mw-content-ltr">The decNumber Library</span>]
** [https://github.com/gcc-mirror/gcc/tree/master/libdecnumber GitHub: gcc-mirror/libdecnumber]
* ldecNumber (Lua-library)
** [http://luaforge.net/projects/ldecnumber/ LuaForge: Lua decNumber]
** [http://math2.org/luasearch/ldecNumber.html <span lang="en" dir="ltr" class="mw-content-ltr">Ldocnumber documentation</span>]

<span lang="en" dir="ltr" class="mw-content-ltr">The ''decNumber'' library should have a security audit before it is used, but it is probably safe.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">The Lua library is archived, and is hopelessly outdated with a last version (ldecNumber-21) from August 2007.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">There are no known MediaWiki-integration for decNumber/ldecNumber.</span>

<span id="See_also"></span>
== Zobacz też ==
* {{ll|Extension:Scribunto|nsp=0}}
* {{ll|Extension:Scribunto/Lua reference manual|2=<span lang="en" dir="ltr" class="mw-content-ltr">Lua reference manual</span>}}
* {{ll|Extension:BCmath/Glossary|2=<span lang="en" dir="ltr" class="mw-content-ltr">BCmath glossary</span>}}