mirror of
https://github.com/sigmasternchen/php-doc-en
synced 2025-03-19 10:28:54 +00:00
fa26a01a2d
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@38558 c90b9560-bf6c-de11-be94-00142212c4b1
300 lines
9.1 KiB
XML
300 lines
9.1 KiB
XML
<reference id="ref.bc">
|
|
<title>BCMath Arbitrary Precision Mathematics Functions</title>
|
|
<titleabbrev>BC math</titleabbrev>
|
|
|
|
<partintro>
|
|
<para>
|
|
These functions are only available if PHP was configured with
|
|
<option role="configure">--enable-bcmath</option>.
|
|
</para>
|
|
<note>
|
|
<para>
|
|
Due to changes in the licensing, the BCMATH library is distributed
|
|
separate from the standard PHP source distribution.
|
|
You can download the tar-gzipped archive at the url:
|
|
<ulink url="&url.bcmath;">&url.bcmath;</ulink>. Read the
|
|
file <filename>README.BCMATH</filename> in the PHP distribution
|
|
for more information.
|
|
</para>
|
|
</note>
|
|
</partintro>
|
|
|
|
<refentry id="function.bcadd">
|
|
<refnamediv>
|
|
<refname>bcadd</refname>
|
|
<refpurpose>Add two arbitrary precision numbers</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcprototype>
|
|
<funcdef>string <function>bcadd</function></funcdef>
|
|
<paramdef>string <parameter>left operand</parameter></paramdef>
|
|
<paramdef>string <parameter>right operand</parameter></paramdef>
|
|
<paramdef>int
|
|
<parameter><optional>scale</optional></parameter>
|
|
</paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
<para>
|
|
Adds the <parameter>left operand</parameter> to the
|
|
<parameter>right operand</parameter> and returns the sum in a
|
|
string. The optional <parameter>scale</parameter> parameter is
|
|
used to set the number of digits after the decimal place in the
|
|
result.
|
|
</para>
|
|
<para>
|
|
See also <function>bcsub</function>.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.bccomp">
|
|
<refnamediv>
|
|
<refname>bccomp</refname>
|
|
<refpurpose>Compare two arbitrary precision numbers</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcprototype>
|
|
<funcdef>int <function>bccomp</function></funcdef>
|
|
<paramdef>string <parameter>left operand</parameter></paramdef>
|
|
<paramdef>string <parameter>right operand</parameter></paramdef>
|
|
<paramdef>int
|
|
<parameter><optional>scale</optional></parameter>
|
|
</paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
<para>
|
|
Compares the <parameter>left operand</parameter> to the
|
|
<parameter>right operand</parameter> and returns the result as an
|
|
integer. The optional <parameter>scale</parameter> parameter is
|
|
used to set the number of digits after the decimal place which
|
|
will be used in the comparion. The return value is 0 if the two
|
|
operands are equal. If the <parameter>left operand</parameter>
|
|
is larger than the <parameter>right operand</parameter> the
|
|
return value is +1 and if the <parameter>left operand</parameter>
|
|
is less than the <parameter>right operand</parameter> the return
|
|
value is -1.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.bcdiv">
|
|
<refnamediv>
|
|
<refname>bcdiv</refname>
|
|
<refpurpose>Divide two arbitrary precision numbers</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcprototype>
|
|
<funcdef>string <function>bcdiv</function></funcdef>
|
|
<paramdef>string <parameter>left operand</parameter></paramdef>
|
|
<paramdef>string <parameter>right operand</parameter></paramdef>
|
|
<paramdef>int
|
|
<parameter><optional>scale</optional></parameter>
|
|
</paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
<para>
|
|
Divides the <parameter>left operand</parameter> by the
|
|
<parameter>right operand</parameter> and returns the result. The
|
|
optional <parameter>scale</parameter> sets the number of digits
|
|
after the decimal place in the result.
|
|
</para>
|
|
<para>
|
|
See also <function>bcmul</function>.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.bcmod">
|
|
<refnamediv>
|
|
<refname>bcmod</refname>
|
|
<refpurpose>
|
|
Get modulus of an arbitrary precision number
|
|
</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcprototype>
|
|
<funcdef>string <function>bcmod</function></funcdef>
|
|
<paramdef>string <parameter>left operand</parameter></paramdef>
|
|
<paramdef>string <parameter>modulus</parameter></paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
<para>
|
|
Get the modulus of the <parameter>left operand</parameter> using
|
|
<parameter>modulus</parameter>.
|
|
</para>
|
|
<para>
|
|
See also <function>bcdiv</function>.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.bcmul">
|
|
<refnamediv>
|
|
<refname>bcmul</refname>
|
|
<refpurpose>Multiply two arbitrary precision number</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcprototype>
|
|
<funcdef>string <function>bcmul</function></funcdef>
|
|
<paramdef>string <parameter>left operand</parameter></paramdef>
|
|
<paramdef>string <parameter>right operand</parameter></paramdef>
|
|
<paramdef>int
|
|
<parameter><optional>scale</optional></parameter>
|
|
</paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
<para>
|
|
Multiply the <parameter>left operand</parameter> by the
|
|
<parameter>right operand</parameter> and returns the result. The
|
|
optional <parameter>scale</parameter> sets the number of digits
|
|
after the decimal place in the result.
|
|
</para>
|
|
<para>
|
|
See also <function>bcdiv</function>.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.bcpow">
|
|
<refnamediv>
|
|
<refname>bcpow</refname>
|
|
<refpurpose>
|
|
Raise an arbitrary precision number to another
|
|
</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcprototype>
|
|
<funcdef>string <function>bcpow</function></funcdef>
|
|
<paramdef>string <parameter>x</parameter></paramdef>
|
|
<paramdef>string <parameter>y</parameter></paramdef>
|
|
<paramdef>int
|
|
<parameter><optional>scale</optional></parameter>
|
|
</paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
<para>
|
|
Raise <parameter>x</parameter> to the power
|
|
<parameter>y</parameter>. The optional
|
|
<parameter>scale</parameter> can be used to set the number of
|
|
digits after the decimal place in the result.
|
|
</para>
|
|
<para>
|
|
See also <function>bcsqrt</function>.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.bcscale">
|
|
<refnamediv>
|
|
<refname>bcscale</refname>
|
|
<refpurpose>
|
|
Set default scale parameter for all bc math functions
|
|
</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcprototype>
|
|
<funcdef>string <function>bcscale</function></funcdef>
|
|
<paramdef>int <parameter>scale</parameter></paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
<para>
|
|
This function sets the default scale parameter for all subsequent
|
|
bc math functions that do not explicitly specify a scale
|
|
parameter.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.bcsqrt">
|
|
<refnamediv>
|
|
<refname>bcsqrt</refname>
|
|
<refpurpose>
|
|
Get the square root of an arbitray precision number
|
|
</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcprototype>
|
|
<funcdef>string <function>bcsqrt</function></funcdef>
|
|
<paramdef>string <parameter>operand</parameter></paramdef>
|
|
<paramdef>int
|
|
<parameter><optional>scale</optional></parameter>
|
|
</paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
<para>
|
|
Return the square root of the <parameter>operand</parameter>.
|
|
The optional <parameter>scale</parameter> parameter sets the
|
|
number of digits after the decimal place in the result.
|
|
</para>
|
|
<para>
|
|
See also <function>bcpow</function>.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
<refentry id="function.bcsub">
|
|
<refnamediv>
|
|
<refname>bcsub</refname>
|
|
<refpurpose>
|
|
Subtract one arbitrary precision number from another
|
|
</refpurpose>
|
|
</refnamediv>
|
|
<refsect1>
|
|
<title>Description</title>
|
|
<funcsynopsis>
|
|
<funcprototype>
|
|
<funcdef>string <function>bcsub</function></funcdef>
|
|
<paramdef>string <parameter>left operand</parameter></paramdef>
|
|
<paramdef>string <parameter>right operand</parameter></paramdef>
|
|
<paramdef>int
|
|
<parameter><optional>scale</optional></parameter>
|
|
</paramdef>
|
|
</funcprototype>
|
|
</funcsynopsis>
|
|
<para>
|
|
Subtracts the <parameter>right operand</parameter> from the
|
|
<parameter>left operand</parameter> and returns the result in a
|
|
string. The optional <parameter>scale</parameter> parameter is
|
|
used to set the number of digits after the decimal place in the
|
|
result.
|
|
</para>
|
|
<para>
|
|
See also <function>bcadd</function>.
|
|
</para>
|
|
</refsect1>
|
|
</refentry>
|
|
|
|
</reference>
|
|
|
|
<!-- Keep this comment at the end of the file
|
|
Local variables:
|
|
mode: sgml
|
|
sgml-omittag:t
|
|
sgml-shorttag:t
|
|
sgml-minimize-attributes:nil
|
|
sgml-always-quote-attributes:t
|
|
sgml-indent-step:1
|
|
sgml-indent-data:t
|
|
sgml-parent-document:nil
|
|
sgml-default-dtd-file:"../../manual.ced"
|
|
sgml-exposed-tags:nil
|
|
sgml-local-catalogs:nil
|
|
sgml-local-ecat-files:nil
|
|
End:
|
|
-->
|