sigmasternchen/php-doc-en
1
0
Fork 0
mirror of https://github.com/sigmasternchen/php-doc-en synced 2025-03-16 00:48:54 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

conversion to new format finished

Browse source 
git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@233023 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Hartmut Holzgraefe 2007-03-31 19:18:23 +00:00
parent 83c82b47af
commit 4af8e58936
45 changed files with 1103 additions and 1205 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

14
reference/math/functions/abs.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.7 $ -->
<!-- $Revision: 1.8 $ -->
<refentry id="function.abs">
<refnamediv>
<refname>abs</refname>
@ -12,11 +12,7 @@
<methodparam><type>mixed</type><parameter>number</parameter></methodparam>
</methodsynopsis>
<para>
Returns the absolute value of <parameter>number</parameter>. If the
argument <parameter>number</parameter> is
of type <type>float</type>, the return type is also <type>float</type>,
otherwise it is <type>integer</type> (as <type>float</type> usually has a
bigger value range than <type>integer</type>).
Returns the absolute value of <parameter>number</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
@ -37,7 +33,11 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
The absoulte value of <parameter>number</parameter>
The absoulte value of <parameter>number</parameter>. If the
argument <parameter>number</parameter> is
of type <type>float</type>, the return type is also <type>float</type>,
otherwise it is <type>integer</type> (as <type>float</type> usually has a
bigger value range than <type>integer</type>).
</para>
</refsect1>
<refsect1 role="examples">

4
reference/math/functions/acos.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.6 $ -->
<!-- $Revision: 1.7 $ -->
<refentry id="function.acos">
<refnamediv>
<refname>acos</refname>
@ -37,7 +37,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
The arc consine of <parameter>arg</parameter>
The arc consine of <parameter>arg</parameter> in radians.
</para>
</refsect1>
<refsect1 role="seealso">

4
reference/math/functions/asin.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.6 $ -->
<!-- $Revision: 1.7 $ -->
<refentry id="function.asin">
<refnamediv>
<refname>asin</refname>
@ -37,7 +37,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
The arc sine of <parameter>arg</parameter>
The arc sine of <parameter>arg</parameter> in radians
</para>
</refsect1>
<refsect1 role="seealso">

25
reference/math/functions/asinh.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.6 $ -->
<!-- $Revision: 1.7 $ -->
<refentry id="function.asinh">
<refnamediv>
<refname>asinh</refname>
@ -17,22 +17,16 @@
hyperbolic sine is <parameter>arg</parameter>.
</para>
&note.no-windows;
<para>
See also:
<function>asin</function>,
<function>acosh</function>, and
<function>atanh</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<term><parameter>arg</parameter></term>
<listitem>
<para>
The argument to process
</para>
</listitem>
</varlistentry>
@ -42,20 +36,17 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
The inverse hyperbolic sine of <parameter>arg</parameter>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>sinh</function></member>
<member><function>asin</function></member>
<member><function>acosh</function></member>
<member><function>atanh</function></member>
</simplelist>
</para>
</refsect1>

25
reference/math/functions/atan.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.6 $ -->
<!-- $Revision: 1.7 $ -->
<refentry id="function.atan">
<refnamediv>
<refname>atan</refname>
@ -18,22 +18,16 @@
<literal>a==tan(atan(a))</literal> for every value of a that is within
<function>atan</function>'s range.
</para>
<para>
See also:
<function>atanh</function>,
<function>asin</function>, and
<function>acos</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<term><parameter>arg</parameter></term>
<listitem>
<para>
The argument to process
</para>
</listitem>
</varlistentry>
@ -43,20 +37,17 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
The arc tangent of <parameter>arg</parameter> in radians.
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>tan</function></member>
<member><function>atanh</function></member>
<member><function>asin</function></member>
<member><function>acos</function></member>
</simplelist>
</para>
</refsect1>

28
reference/math/functions/atan2.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<!-- $Revision: 1.6 $ -->
<refentry id="function.atan2">
<refnamediv>
<refname>atan2</refname>
@ -24,19 +24,24 @@
The function returns the result in radians, which is between -PI
and PI (inclusive).
</simpara>
<para>
See also <function>acos</function> and <function>atan</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<term><parameter>x</parameter></term>
<listitem>
<para>
Dividend parameter
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>y</parameter></term>
<listitem>
<para>
Divisor parameter
</para>
</listitem>
</varlistentry>
@ -46,20 +51,15 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
The arg tangent of <parameter>x</parameter>/<parameter>y</parameter>
in radians.
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>atan</function></member>
</simplelist>
</para>
</refsect1>

19
reference/math/functions/atanh.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.6 $ -->
<!-- $Revision: 1.7 $ -->
<refentry id="function.atanh">
<refnamediv>
<refname>atanh</refname>
@ -29,10 +29,10 @@
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<term><parameter>arg</parameter></term>
<listitem>
<para>
The argument to process
</para>
</listitem>
</varlistentry>
@ -42,20 +42,17 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
Inverse hyperbolic tangent of <parameter>arg</parameter>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>tanh</function></member>
<member><function>atan </function></member>
<member><function>asinh</function></member>
<member><function>acosh</function></member>
</simplelist>
</para>
</refsect1>

92
reference/math/functions/base-convert.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.8 $ -->
<!-- $Revision: 1.9 $ -->
<refentry id="function.base-convert">
<refnamediv>
<refname>base_convert</refname>
@ -22,6 +22,56 @@
have to be between 2 and 36, inclusive. Digits in numbers with a
base higher than 10 will be represented with the letters a-z,
with a meaning 10, b meaning 11 and z meaning 35.
</para>
<warning>
<simpara>
<function>base_convert</function> may lose precision on large numbers
due to properties related to the internal "double" or "float" type used.
Please see the <link linkend="language.types.float">Floating point numbers</link>
section in the manual for more specific information and limitations.
</simpara>
</warning>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>number</parameter></term>
<listitem>
<para>
The number to convert
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>frombase</parameter></term>
<listitem>
<para>
The base <parameter>number</parameter> is in
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>tobase</parameter></term>
<listitem>
<para>
The base to convert <parameter>number</parameter> to
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<parameter>number</parameter> converted to base <parameter>tobase</parameter>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>base_convert</function> example</title>
<programlisting role="php">
@ -42,50 +92,12 @@ echo base_convert($hexadecimal, 16, 2);
</screen>
</example>
</para>
<warning>
<simpara>
<function>base_convert</function> may lose precision on large numbers
due to properties related to the internal "double" or "float" type used.
Please see the <link linkend="language.types.float">Floating point numbers</link>
section in the manual for more specific information and limitations.
</simpara>
</warning>
<para>
See also: <function>intval</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>intval</function></member>
</simplelist>
</para>
</refsect1>

94
reference/math/functions/bindec.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.10 $ -->
<!-- $Revision: 1.11 $ -->
<refentry id="function.bindec">
<refnamediv>
<refname>bindec</refname>
@ -17,11 +17,57 @@
</para>
<para>
<function>bindec</function> converts a binary number to an
<type>integer</type>. The largest number that can be converted is
31 bits of 1's or 2147483647 in decimal.
As of PHP 4.1.0, this function can also convert larger numbers. It returns
<type>float</type> in that case.
<type>integer</type> or, if needed for size reasons, <type>float</type>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>binary_string</parameter></term>
<listitem>
<para>
The binary string to convert
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
The decimal value of <parameter>binary_string</parameter>
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>Since 4.1.0</entry>
<entry>
The function can now convert numbers that are too large to
fit into the platforms <type>integer</type> type, larger values
are returned as <type>float</type> in that case.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>bindec</function> example</title>
@ -45,45 +91,15 @@ echo bindec('111');
</screen>
</example>
</para>
<para>
See also <function>decbin</function>,
<function>octdec</function>,
<function>hexdec</function> and
<function>base_convert</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>decbin</function></member>
<member><function>octdec</function></member>
<member><function>hexdec</function></member>
<member><function>base_convert</function></member>
</simplelist>
</para>
</refsect1>

22
reference/math/functions/ceil.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.8 $ -->
<!-- $Revision: 1.9 $ -->
<refentry id="function.ceil">
<refnamediv>
<refname>ceil</refname>
@ -14,9 +14,6 @@
<simpara>
Returns the next highest integer value by rounding up
<parameter>value</parameter> if necessary.
The return value of <function>ceil</function> is still of type
<type>float</type> as the value range of <type>float</type> is
usually bigger than that of <type>integer</type>.
</simpara>
<para>
<example>
@ -32,20 +29,16 @@ echo ceil(-3.14); // -3
</programlisting>
</example>
</para>
<simpara>
See also <function>floor</function> and
<function>round</function>.
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<term><parameter>value</parameter></term>
<listitem>
<para>
The value to round
</para>
</listitem>
</varlistentry>
@ -55,7 +48,11 @@ echo ceil(-3.14); // -3
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<parameter>value</parameter> rounded up to the next highest
integer.
The return value of <function>ceil</function> is still of type
<type>float</type> as the value range of <type>float</type> is
usually bigger than that of <type>integer</type>.
</para>
</refsect1>
<refsect1 role="examples">
@ -68,7 +65,8 @@ echo ceil(-3.14); // -3
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>floor</function></member>
<member><function>round</function></member>
</simplelist>
</para>
</refsect1>

65
reference/math/functions/cos.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.7 $ -->
<!-- $Revision: 1.8 $ -->
<refentry id="function.cos">
<refnamediv>
<refname>cos</refname>
@ -15,6 +15,30 @@
<function>cos</function> returns the cosine of the <parameter>arg</parameter>
parameter. The <parameter>arg</parameter> parameter is in radians.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>arg</parameter></term>
<listitem>
<para>
An angle in radians
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
The cosine of <parameter>arg</parameter>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>cos</function> example</title>
@ -29,46 +53,15 @@ echo cos(M_PI); // -1
</programlisting>
</example>
</para>
<para>
See also:
<function>acos</function>,
<function>sin</function>,
<function>tan</function>, and
<function>deg2rad</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>acos</function></member>
<member><function>sin</function></member>
<member><function>tan</function></member>
<member><function>deg2rad</function></member>
</simplelist>
</para>
</refsect1>

26
reference/math/functions/cosh.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<!-- $Revision: 1.6 $ -->
<refentry id="function.cosh">
<refnamediv>
<refname>cosh</refname>
@ -15,23 +15,16 @@
Returns the hyperbolic cosine of <parameter>arg</parameter>,
defined as <literal>(exp(arg) + exp(-arg))/2</literal>.
</para>
<para>
See also:
<function>cos</function>,
<function>acosh</function>,
<function>sin</function>, and
<function>tan</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<term><parameter>arg</parameter></term>
<listitem>
<para>
The argument to process
</para>
</listitem>
</varlistentry>
@ -41,20 +34,17 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
The hyperbolic cosine of <parameter>arg</parameter>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>cos</function></member>
<member><function>acosh</function></member>
<member><function>sinh</function></member>
<member><function>cosh</function></member>
</simplelist>
</para>
</refsect1>

64
reference/math/functions/decbin.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.10 $ -->
<!-- $Revision: 1.11 $ -->
<refentry id="function.decbin">
<refnamediv>
<refname>decbin</refname>
@ -16,6 +16,30 @@
<parameter>number</parameter> argument. The largest number that can be converted is
4294967295 in decimal resulting to a string of 32 1's.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>number</parameter></term>
<listitem>
<para>
Decimal value to convert
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Binary string representation of <parameter>number</parameter>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>decbin</function> example</title>
@ -36,45 +60,15 @@ echo decbin(26);
</screen>
</example>
</para>
<para>
See also <function>bindec</function>,
<function>decoct</function>,
<function>dechex</function> and
<function>base_convert</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>bindec</function></member>
<member><function>decoct</function></member>
<member><function>dechex</function></member>
<member><function>base_convert</function></member>
</simplelist>
</para>
</refsect1>

64
reference/math/functions/dechex.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.9 $ -->
<!-- $Revision: 1.10 $ -->
<refentry id="function.dechex">
<refnamediv>
<refname>dechex</refname>
@ -16,6 +16,30 @@
given <parameter>number</parameter> argument. The largest number that can
be converted is 4294967295 in decimal resulting to "ffffffff".
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>number</parameter></term>
<listitem>
<para>
Decimal value to convert
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Hexadecimal string representation of <parameter>number</parameter>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>dechex</function> example</title>
@ -36,45 +60,15 @@ a
</screen>
</example>
</para>
<para>
See also <function>hexdec</function>,
<function>decbin</function>,
<function>decoct</function> and
<function>base_convert</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>hexdec</function></member>
<member><function>decbin</function></member>
<member><function>decoct</function></member>
<member><function>base_convert</function></member>
</simplelist>
</para>
</refsect1>

64
reference/math/functions/decoct.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.9 $ -->
<!-- $Revision: 1.10 $ -->
<refentry id="function.decoct">
<refnamediv>
<refname>decoct</refname>
@ -16,6 +16,30 @@
<parameter>number</parameter> argument. The largest number that can be converted is
4294967295 in decimal resulting to "37777777777".
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter></parameter></term>
<listitem>
<para>
Decimal value to convert
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Octal string representation of <parameter>number</parameter>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>decoct</function> example</title>
@ -36,45 +60,15 @@ echo decoct(264);
</screen>
</example>
</para>
<para>
See also <function>octdec</function>,
<function>decbin</function>,
<function>dechex</function> and
<function>base_convert</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>octdec</function></member>
<member><function>decbin</function></member>
<member><function>dechex</function></member>
<member><function>base_convert</function></member>
</simplelist>
</para>
</refsect1>

58
reference/math/functions/deg2rad.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<!-- $Revision: 1.6 $ -->
<refentry id="function.deg2rad">
<refnamediv>
<refname>deg2rad</refname>
@ -17,6 +17,30 @@
This function converts <parameter>number</parameter> from degrees
to the radian equivalent.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>number</parameter></term>
<listitem>
<para>
Angular value in degrees
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
The radian equivalent of <parameter>number</parameter>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>deg2rad</function> example</title>
@ -32,42 +56,12 @@ var_dump(deg2rad(45) === M_PI_4); // bool(true)
</programlisting>
</example>
</para>
<para>
See also <function>rad2deg</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>rad2deg</function></member>
</simplelist>
</para>
</refsect1>

61
reference/math/functions/exp.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.11 $ -->
<!-- $Revision: 1.12 $ -->
<refentry id="function.exp">
<refnamediv>
<refname>exp</refname>
@ -20,6 +20,30 @@
2.718282.
</para>
</note>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>arg</parameter></term>
<listitem>
<para>
The argument to process
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
'e' raised to the power of <parameter>arg</parameter>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>exp</function> example</title>
@ -40,44 +64,13 @@ echo exp(5.7);
</screen>
</example>
</para>
<para>
See also
<function>log</function> and
<function>pow</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>log</function></member>
<member><function>pow</function></member>
</simplelist>
</para>
</refsect1>

29
reference/math/functions/expm1.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.7 $ -->
<!-- $Revision: 1.8 $ -->
<refentry id='function.expm1'>
<refnamediv>
<refname>expm1</refname>
@ -12,31 +12,27 @@
&reftitle.description;
<methodsynopsis>
<type>float</type><methodname>expm1</methodname>
<methodparam><type>float</type><parameter>number</parameter></methodparam>
<methodparam><type>float</type><parameter>arg</parameter></methodparam>
</methodsynopsis>
&warn.experimental.func;
<para>
<function>expm1</function> returns the equivalent to
'exp(<parameter>number</parameter>) - 1' computed in a way that is
accurate even if the value of <parameter>number</parameter> is near zero,
a case where 'exp (<parameter>number</parameter>) - 1' would be
'exp(<parameter>arg</parameter>) - 1' computed in a way that is
accurate even if the value of <parameter>arg</parameter> is near zero,
a case where 'exp (<parameter>arg</parameter>) - 1' would be
inaccurate due to subtraction of two numbers that are nearly equal.
</para>
&note.no-windows;
<para>
See also <function>log1p</function> and
<function>exp</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<term><parameter>arg</parameter></term>
<listitem>
<para>
The argument to process
</para>
</listitem>
</varlistentry>
@ -46,20 +42,15 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
'e' to the power of <parameter>arg</parameter> minus one
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>log1p</function></member>
<member><function>exp</function></member>
</simplelist>
</para>
</refsect1>

62
reference/math/functions/floor.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.8 $ -->
<!-- $Revision: 1.9 $ -->
<refentry id="function.floor">
<refnamediv>
<refname>floor</refname>
@ -14,10 +14,34 @@
<simpara>
Returns the next lowest integer value by rounding down
<parameter>value</parameter> if necessary.
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>number</parameter></term>
<listitem>
<para>
The numeric value to round
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<parameter>arg</parameter> rounded to the next lowest integer.
The return value of <function>floor</function> is still of type
<type>float</type> because the value range of <type>float</type> is
usually bigger than that of <type>integer</type>.
</simpara>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>floor</function> example</title>
@ -32,43 +56,13 @@ echo floor(-3.14); // -4
</programlisting>
</example>
</para>
<simpara>
See also <function>ceil</function> and
<function>round</function>.
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>ceil</function></member>
<member><function>round</function></member>
</simplelist>
</para>
</refsect1>

70
reference/math/functions/fmod.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.7 $ -->
<!-- $Revision: 1.8 $ -->
<refentry id="function.fmod">
<refnamediv>
<refname>fmod</refname>
@ -22,6 +22,39 @@
<parameter>x</parameter> and a magnitude less than the magnitude of
<parameter>y</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>x</parameter></term>
<listitem>
<para>
The dividend
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>y</parameter></term>
<listitem>
<para>
The divisor
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
The floating point remainder of
<parameter>x</parameter>/<parameter>y</parameter>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Using <function>fmod</function></title>
@ -38,41 +71,6 @@ $r = fmod($x, $y);
</example>
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

33
reference/math/functions/getrandmax.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<!-- $Revision: 1.6 $ -->
<refentry id="function.getrandmax">
<refnamediv>
<refname>getrandmax</refname>
@ -15,43 +15,20 @@
Returns the maximum value that can be returned by a call to
<function>rand</function>.
</simpara>
<simpara>
See also <function>rand</function>, <function>srand</function>
and <function>mt_getrandmax</function>.
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
The largest possible random value returned by <function>rand</function>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>rand</function></member>
<member><function>srand</function></member>
<member><function>mt_getrandmax</function></member>
</simplelist>
</para>
</refsect1>

97
reference/math/functions/hexdec.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.11 $ -->
<!-- $Revision: 1.12 $ -->
<refentry id="function.hexdec">
<refnamediv>
<refname>hexdec</refname>
@ -15,14 +15,62 @@
Returns the decimal equivalent of the hexadecimal number
represented by the <parameter>hex_string</parameter> argument.
<function>hexdec</function> converts a hexadecimal string to a
decimal number. The largest number that can be converted is
7fffffff or 2147483647 in decimal.
As of PHP 4.1.0, this function can also convert larger numbers. It returns
<type>float</type> in that case.
decimal number.
</para>
<para>
<function>hexdec</function> will ignore any non-hexadecimal
characters it encounters.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>hex_string</parameter></term>
<listitem>
<para>
The hexadezimal string to convert
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
The decimal representation of <parameter>hex_string</parameter>
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>Since 4.1.0</entry>
<entry>
The function can now convert values that are to big for
the platforms <type>integer</type> type, it will return
the value as <type>float</type> instead in that case.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>hexdec</function> example</title>
<programlisting role="php">
@ -39,50 +87,19 @@ var_dump(hexdec("a0")); // print "int(160)"
</programlisting>
</example>
</para>
<para>
See also <function>dechex</function>,
<function>bindec</function>,
<function>octdec</function> and
<function>base_convert</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>dechex</function></member>
<member><function>bindec</function></member>
<member><function>octdec</function></member>
<member><function>base_convert</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml

30
reference/math/functions/hypot.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.7 $ -->
<!-- $Revision: 1.8 $ -->
<refentry id='function.hypot'>
<refnamediv>
<refname>hypot</refname>
@ -27,10 +27,18 @@
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<term><parameter>x</parameter></term>
<listitem>
<para>
Length of first side
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>y</parameter></term>
<listitem>
<para>
Length of second side
</para>
</listitem>
</varlistentry>
@ -40,21 +48,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
</simplelist>
Calculated length of the hyptenuse
</para>
</refsect1>
</refentry>

27
reference/math/functions/is-finite.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.6 $ -->
<!-- $Revision: 1.7 $ -->
<refentry id='function.is-finite'>
<refnamediv>
<refname>is_finite</refname>
@ -12,12 +12,8 @@
<methodparam><type>float</type><parameter>val</parameter></methodparam>
</methodsynopsis>
<para>
Returns &true; if <parameter>val</parameter> is a legal finite
number within the allowed range for a PHP float on this platform.
</para>
<para>
See also <function>is_infinite</function> and
<function>is_nan</function>.
Checks whether <parameter>val</parameter> is a lecal finite
on this platform.
</para>
</refsect1>
<refsect1 role="parameters">
@ -25,10 +21,10 @@
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<term><parameter>val</parameter></term>
<listitem>
<para>
The value to check
</para>
</listitem>
</varlistentry>
@ -38,20 +34,17 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
&true; if <parameter>val</parameter> is a legal finite
number within the allowed range for a PHP float on this platform,
else &false;.
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>is_infinite</function></member>
<member><function>is_nan</function></member>
</simplelist>
</para>
</refsect1>

21
reference/math/functions/is-infinite.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.6 $ -->
<!-- $Revision: 1.7 $ -->
<refentry id='function.is-infinite'>
<refnamediv>
<refname>is_infinite</refname>
@ -16,20 +16,16 @@
negative), like the result of <literal>log(0)</literal> or any value too
big to fit into a float on this platform.
</para>
<para>
See also <function>is_finite</function> and
<function>is_nan</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<term><parameter>val</parameter></term>
<listitem>
<para>
The value to check
</para>
</listitem>
</varlistentry>
@ -39,20 +35,15 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
&true; if <parameter>val</parameter> is infinite, else &false;.
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>is_finite</function></member>
<member><function>is_nan</function></member>
</simplelist>
</para>
</refsect1>

24
reference/math/functions/is-nan.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.6 $ -->
<!-- $Revision: 1.7 $ -->
<refentry id='function.is-nan'>
<refnamediv>
<refname>is_nan</refname>
@ -12,23 +12,19 @@
<methodparam><type>float</type><parameter>val</parameter></methodparam>
</methodsynopsis>
<para>
Returns &true; if <parameter>val</parameter> is 'not a number',
Checks whether <parameter>val</parameter> is 'not a number',
like the result of <literal>acos(1.01)</literal>.
</para>
<para>
See also <function>is_finite</function> and
<function>is_infinite</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<term><parameter>val</parameter></term>
<listitem>
<para>
The value to check
</para>
</listitem>
</varlistentry>
@ -38,20 +34,16 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
Returns &true; if <parameter>val</parameter> is 'not a number',
else &false;.
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>is_finite</function></member>
<member><function>is_infinite</function></member>
</simplelist>
</para>
</refsect1>

28
reference/math/functions/lcg-value.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.4 $ -->
<!-- $Revision: 1.5 $ -->
<refentry id="function.lcg-value">
<refnamediv>
<refname>lcg_value</refname>
@ -18,38 +18,18 @@
to the product of both primes.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
A pseudo random float value in the range of (0, 1)
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>rand</function></member>
<member><function>mt_rand</function></member>
</simplelist>
</para>
</refsect1>

65
reference/math/functions/log.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.11 $ -->
<!-- $Revision: 1.12 $ -->
<refentry id="function.log">
<refnamediv>
<refname>log</refname>
@ -18,31 +18,25 @@
<parameter>arg</parameter>, otherwise <function>log</function>
returns the natural logarithm of <parameter>arg</parameter>.
</para>
<note>
<para>
The <parameter>base</parameter> parameter became available
with PHP 4.3.0.
</para>
<para>
As always you can calculate the logarithm in base <literal>b</literal>
of a number <literal>n</literal>, but using the mathematical identity:
log<subscript>b</subscript>(n) = log(n)/log(b), where log is the
neperian (or natural) logarithm.
</para>
</note>
<para>
See also <function>exp</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<term><parameter>arg</parameter></term>
<listitem>
<para>
The value to calculate the logarithm for
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>base</parameter></term>
<listitem>
<para>
The optinal logarithmic base to use
(defaults to 'e' and so to the natural logarithm).
</para>
</listitem>
</varlistentry>
@ -52,20 +46,45 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
The logarithm of <parameter>arg</parameter> to
<parameter>base</parameter>, if given, or the
natural logarithm.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>Since 4.3.0</entry>
<entry>
The optinal parameter <parameter>base</parameter> became available.
For older versions you can calculate the logarithm in base <literal>b</literal>
of a number <literal>n</literal>, but using the mathematical identity:
log<subscript>b</subscript>(n) = log(n)/log(b), where log is the
neperian (or natural) logarithm.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>log10</function></member>
<member><function>exp</function></member>
<member><function>pow</function></member>
</simplelist>
</para>
</refsect1>

16
reference/math/functions/log10.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<!-- $Revision: 1.6 $ -->
<refentry id="function.log10">
<refnamediv>
<refname>log10</refname>
@ -24,10 +24,10 @@
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<term><parameter>arg</parameter></term>
<listitem>
<para>
The argument to process
</para>
</listitem>
</varlistentry>
@ -37,20 +37,14 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
The base-10 logaritm of <parameter>arg</parameter>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>log</function></member>
</simplelist>
</para>
</refsect1>

22
reference/math/functions/log1p.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.8 $ -->
<!-- $Revision: 1.9 $ -->
<refentry id='function.log1p'>
<refnamediv>
<refname>log1p</refname>
@ -21,20 +21,16 @@
when the value of <parameter>number</parameter> is close to zero.
</para>
&note.no-windows;
<para>
See also <function>expm1</function> and
<function>log</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<term><parameter>number</parameter></term>
<listitem>
<para>
The argument to process
</para>
</listitem>
</varlistentry>
@ -44,20 +40,16 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
log(1 + <parameter>number</parameter>)
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>expm1</function></member>
<member><function>log</function></member>
<member><function>log10</function></member>
</simplelist>
</para>
</refsect1>

35
reference/math/functions/mt-getrandmax.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.6 $ -->
<!-- $Revision: 1.7 $ -->
<refentry id="function.mt-getrandmax">
<refnamediv>
<refname>mt_getrandmax</refname>
@ -15,45 +15,20 @@
Returns the maximum value that can be returned by a call to
<function>mt_rand</function>.
</simpara>
<simpara>
See also:
<function>mt_rand</function>,
<function>mt_srand</function>, and
<function>getrandmax</function>.
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
Returns the maximum random value returned by <function>mt_rand</function>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>mt_rand</function></member>
<member><function>mt_srand</function></member>
<member><function>getrandmax</function></member>
</simplelist>
</para>
</refsect1>

112
reference/math/functions/mt-rand.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.12 $ -->
<!-- $Revision: 1.13 $ -->
<refentry id="function.mt-rand">
<refnamediv>
<refname>mt_rand</refname>
@ -30,6 +30,68 @@
between 5 and 15 (inclusive), for example, use <literal>mt_rand
(5, 15)</literal>.
</simpara>
&note.randomseed;
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>min</parameter></term>
<listitem>
<para>
Optional lowest value to be returned (default: 0)
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>man</parameter></term>
<listitem>
<para>
Optional highest value to be returned (default: RAND_MAX)
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
A random integer value between <parameter>min</parameter> (or 0)
and <parameter>max</parameter> (or RAND_MAX, inclusive)
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>Since 3.0.7</entry>
<entry>
In versions before 3.0.7 the meaning of
<parameter>max</parameter> was <parameter>range</parameter>. To
get the same results in these versions the short example should
be <literal>rand (5, 11)</literal> to get a random number
between 5 and 15.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>mt_rand</function> example</title>
@ -53,56 +115,14 @@ echo mt_rand(5, 15);
</screen>
</example>
</para>
&note.randomseed;
<note>
<para>
In versions before 3.0.7 the meaning of
<parameter>max</parameter> was <parameter>range</parameter>. To
get the same results in these versions the short example should
be <literal>mt_rand (5, 11)</literal> to get a random number
between 5 and 15.
</para>
</note>
<simpara>
See also:
<function>mt_srand</function>,
<function>mt_getrandmax</function>, and
<function>rand</function>.
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>mt_srand</function></member>
<member><function>mt_getrandmax</function></member>
<member><function>rand</function></member>
</simplelist>
</para>
</refsect1>

92
reference/math/functions/mt-srand.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.10 $ -->
<!-- $Revision: 1.11 $ -->
<refentry id="function.mt-srand">
<refnamediv>
<refname>mt_srand</refname>
@ -13,10 +13,54 @@
</methodsynopsis>
<para>
Seeds the random number generator with
<parameter>seed</parameter>.
Since PHP 4.2.0, the <parameter>seed</parameter>
becomes optional and defaults to a random value if omitted.
<parameter>seed</parameter> or with a random value
if no <parameter>seed</parameter> is given.
</para>
&note.randomseed;
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>seed</parameter></term>
<listitem>
<para>
An optional seed value
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>Since 4.2.0</entry>
<entry>
The <parameter>seed</parameter> becomes optional
and defaults to a random value if omitted.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>mt_srand</function> example</title>
@ -36,48 +80,14 @@ $randval = mt_rand();
</programlisting>
</example>
</para>
&note.randomseed;
<simpara>
See also:
<function>mt_rand</function>,
<function>mt_getrandmax</function>, and
<function>srand</function>.
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>mt_rand</function></member>
<member><function>mt_getrandmax</function></member>
<member><function>srand</function></member>
</simplelist>
</para>
</refsect1>

94
reference/math/functions/octdec.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.10 $ -->
<!-- $Revision: 1.11 $ -->
<refentry id="function.octdec">
<refnamediv>
<refname>octdec</refname>
@ -14,11 +14,56 @@
<para>
Returns the decimal equivalent of the octal number
represented by the <parameter>octal_string</parameter> argument.
The largest number that can be converted is 17777777777 or 2147483647 in
decimal.
As of PHP 4.1.0, this function can also convert larger numbers. It returns
<type>float</type> in that case.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>octal_string</parameter></term>
<listitem>
<para>
The octal string to convert
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
The decimal representation of <parameter>octal_string</parameter>
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>Since 4.1.0</entry>
<entry>
The function can now convert numbers that are too large to
fit into the platforms <type>integer</type> type, larger values
are returned as <type>float</type> in that case.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>octdec</function> example</title>
@ -39,46 +84,15 @@ echo octdec(decoct(45));
</screen>
</example>
</para>
<para>
See also:
<function>decoct</function>,
<function>bindec</function>,
<function>hexdec</function>, and
<function>base_convert</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>decoct</function></member>
<member><function>bindec</function></member>
<member><function>hexdec</function></member>
<member><function>base_convert</function></member>
</simplelist>
</para>
</refsect1>

46
reference/math/functions/pi.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.7 $ -->
<!-- $Revision: 1.8 $ -->
<refentry id="function.pi">
<refnamediv>
<refname>pi</refname>
@ -19,6 +19,15 @@
Also, you can use the <constant>M_PI</constant> constant which yields
identical results to <function>pi</function>.
</simpara>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
The value of pi as float.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>pi</function> example</title>
@ -33,41 +42,6 @@ echo M_PI; // 3.1415926535898
</example>
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

137
reference/math/functions/pow.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.10 $ -->
<!-- $Revision: 1.11 $ -->
<refentry id="function.pow">
<refnamediv>
<refname>pow</refname>
@ -14,22 +14,89 @@
</methodsynopsis>
<para>
Returns <parameter>base</parameter> raised to the power of
<parameter>exp</parameter>. If possible, this function will
return an <type>integer</type>.
</para>
<para>
If the power cannot be computed, a warning will be issued,
and <function>pow</function> will return &false;. Since PHP 4.2.0
<function>pow</function> doesn't issue any warning.
<parameter>exp</parameter>.
</para>
<note>
<para>
PHP cannot handle negative <parameter>exp</parameter>s.
</para>
</note>
<example>
<title>Some examples of <function>pow</function></title>
<programlisting role="php">
<warning>
<para>
In PHP 4.0.6 and earlier <function>pow</function> always returned
a <type>float</type>, and did not issue warnings.
</para>
</warning>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>base</parameter></term>
<listitem>
<para>
The base to use
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>exp</parameter></term>
<listitem>
<para>
The exponent
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<parameter>base</parameter> raised to the power of <parameter>exp</parameter>.
If the result can be represented as integer it will be returned as type
<type>integer</type>, else it will be returned as type <type>float</type>.
If the power cannot be computed &false; will be returned instead.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>Since 4.0.6</entry>
<entry>
The function will now return <type>integer</type> results if possible,
before this it always returned a <type>float</type> result.
</entry>
</row>
<row>
<entry>Since 4.2.0</entry>
<entry>
PHP stops to emit a warning if the value can't be computed,
it will now silently return &false; only.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Some examples of <function>pow</function></title>
<programlisting role="php">
<![CDATA[
<?php
@ -41,54 +108,18 @@ echo pow(-1, 5.5); // error
?>
]]>
</programlisting>
</example>
<warning>
<para>
In PHP 4.0.6 and earlier <function>pow</function> always returned
a <type>float</type>, and did not issue warnings.
</para>
</warning>
<para>
See also:
<function>exp</function>,
<function>sqrt</function>,
<function>bcpow</function>, and
<function>gmp_pow</function>,
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>exp</function></member>
<member><function>sqrt</function></member>
<member><function>bcpow</function></member>
<member><function>gmp_pow</function></member>
</simplelist>
</para>
</refsect1>

58
reference/math/functions/rad2deg.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<!-- $Revision: 1.6 $ -->
<refentry id="function.rad2deg">
<refnamediv>
<refname>rad2deg</refname>
@ -17,6 +17,30 @@
This function converts <parameter>number</parameter> from radian
to degrees.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>number</parameter></term>
<listitem>
<para>
A radian value
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
The equivalent of <parameter>number</parameter> in degrees
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>rad2deg</function> example</title>
@ -31,42 +55,12 @@ echo rad2deg(M_PI_4); // 45
</programlisting>
</example>
</para>
<para>
See also <function>deg2rad</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>deg2rad</function></member>
</simplelist>
</para>
</refsect1>

132
reference/math/functions/rand.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.17 $ -->
<!-- $Revision: 1.18 $ -->
<refentry id="function.rand">
<refnamediv>
<refname>rand</refname>
@ -20,6 +20,78 @@
between 5 and 15 (inclusive), for example, use <literal>rand (5,
15)</literal>.
</simpara>
<note>
<simpara>
On some platforms (such as Windows) <constant>RAND_MAX</constant>
is only 32768. If you require a range larger than 32768, specifying
<parameter>min</parameter> and <parameter>max</parameter> will allow
you to create a range larger than RAND_MAX, or consider using
<function>mt_rand</function> instead.
</simpara>
</note>
&note.randomseed;
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>min</parameter></term>
<listitem>
<para>
The lowest value to return (default: 0)
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>max</parameter></term>
<listitem>
<para>
The highest value to return (default: RAND_MAX)
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
A pseudo random value between <parameter>min</parameter>
(or 0) and <parameter>max</parameter> (or RAND_MAX, inclusive).
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>Since 3.0.7</entry>
<entry>
In versions before 3.0.7 the meaning of
<parameter>max</parameter> was <parameter>range</parameter>. To
get the same results in these versions the short example should
be <literal>rand (5, 11)</literal> to get a random number
between 5 and 15.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>rand</function> example</title>
@ -43,66 +115,14 @@ echo rand(5, 15);
</screen>
</example>
</para>
<note>
<simpara>
On some platforms (such as Windows) <constant>RAND_MAX</constant>
is only 32768. If you require a range larger than 32768, specifying
<parameter>min</parameter> and <parameter>max</parameter> will allow
you to create a range larger than RAND_MAX, or consider using
<function>mt_rand</function> instead.
</simpara>
</note>
&note.randomseed;
<note>
<para>
In versions before 3.0.7 the meaning of
<parameter>max</parameter> was <parameter>range</parameter>. To
get the same results in these versions the short example should
be <literal>rand (5, 11)</literal> to get a random number
between 5 and 15.
</para>
</note>
<simpara>
See also:
<function>srand</function>,
<function>getrandmax</function>, and
<function>mt_rand</function>.
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>srand</function></member>
<member><function>getrandmax</function></member>
<member><function>mt_rand</function></member>
</simplelist>
</para>
</refsect1>

63
reference/math/functions/round.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.11 $ -->
<!-- $Revision: 1.12 $ -->
<refentry id="function.round">
<refnamediv>
<refname>round</refname>
@ -18,25 +18,6 @@
(number of digits after the decimal point).
<parameter>precision</parameter> can also be negative or zero (default).
</para>
<para>
<example>
<title><function>round</function> examples</title>
<programlisting role="php">
<![CDATA[
<?php
echo round(3.4); // 3
echo round(3.5); // 4
echo round(3.6); // 4
echo round(3.6, 0); // 4
echo round(1.95583, 2); // 1.96
echo round(1241757, -3); // 1242000
echo round(5.045, 2); // 5.05
echo round(5.055, 2); // 5.06
?>
]]>
</programlisting>
</example>
</para>
<!-- It's not true
<para>
<caution>
@ -70,22 +51,24 @@ echo round(5.055, 2); // 5.06
</simpara>
</note>
</para>
<simpara>
See also:
<function>ceil</function>,
<function>floor</function>, and
<function>number_format</function>.
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<term><parameter>val</parameter></term>
<listitem>
<para>
The value to round
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>precision</parameter></term>
<listitem>
<para>
The optional number of decimal digits to round to, defaults to 0
</para>
</listitem>
</varlistentry>
@ -95,20 +78,38 @@ echo round(5.055, 2); // 5.06
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
The rounded value
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>round</function> examples</title>
<programlisting role="php">
<![CDATA[
<?php
echo round(3.4); // 3
echo round(3.5); // 4
echo round(3.6); // 4
echo round(3.6, 0); // 4
echo round(1.95583, 2); // 1.96
echo round(1241757, -3); // 1242000
echo round(5.045, 2); // 5.05
echo round(5.055, 2); // 5.06
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>ceil</function></member>
<member><function>floor</function></member>
<member><function>number_format</function></member>
</simplelist>
</para>
</refsect1>

66
reference/math/functions/sin.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.9 $ -->
<!-- $Revision: 1.10 $ -->
<refentry id="function.sin">
<refnamediv>
<refname>sin</refname>
@ -15,6 +15,30 @@
<function>sin</function> returns the sine of the <parameter>arg</parameter>
parameter. The <parameter>arg</parameter> parameter is in radians.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>arg</parameter></term>
<listitem>
<para>
A value in radians
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
The sine of <parameter>arg</parameter>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>sin</function> example</title>
@ -31,46 +55,16 @@ echo sin(60); // -0.304810621 ...
</programlisting>
</example>
</para>
<para>
See also:
<function>asin</function>,
<function>cos</function>,
<function>tan</function>, and
<function>deg2rad</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>asin</function></member>
<member><function>sinh</function></member>
<member><function>cos</function></member>
<member><function>tan</function></member>
<member><function>deg2rad</function></member>
</simplelist>
</para>
</refsect1>

26
reference/math/functions/sinh.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<!-- $Revision: 1.6 $ -->
<refentry id="function.sinh">
<refnamediv>
<refname>sinh</refname>
@ -15,23 +15,16 @@
Returns the hyperbolic sine of <parameter>arg</parameter>,
defined as <literal>(exp(arg) - exp(-arg))/2</literal>.
</para>
<para>
See also:
<function>sin</function>,
<function>asinh</function>,
<function>cos</function>, and
<function>tan</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<term><parameter>arg</parameter></term>
<listitem>
<para>
The argument to process
</para>
</listitem>
</varlistentry>
@ -41,20 +34,17 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
The hyperbolic sine of <parameter>arg</parameter>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>sin</function></member>
<member><function>asinh</function></member>
<member><function>cosh</function></member>
<member><function>tanh</function></member>
</simplelist>
</para>
</refsect1>

58
reference/math/functions/sqrt.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.7 $ -->
<!-- $Revision: 1.8 $ -->
<refentry id="function.sqrt">
<refnamediv>
<refname>sqrt</refname>
@ -14,6 +14,30 @@
<para>
Returns the square root of <parameter>arg</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>arg</parameter></term>
<listitem>
<para>
The argument to process
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
The square root of <parameter>arg</parameter>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>sqrt</function> example</title>
@ -28,42 +52,12 @@ echo sqrt(10); // 3.16227766 ...
</programlisting>
</example>
</para>
<para>
See also <function>pow</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>pow</function></member>
</simplelist>
</para>
</refsect1>

70
reference/math/functions/srand.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.10 $ -->
<!-- $Revision: 1.11 $ -->
<refentry id="function.srand">
<refnamediv>
<refname>srand</refname>
@ -12,71 +12,59 @@
<methodparam choice="opt"><type>int</type><parameter>seed</parameter></methodparam>
</methodsynopsis>
<para>
Seeds the random number generator with <parameter>seed</parameter>.
Since PHP 4.2.0, the <parameter>seed</parameter>
becomes optional and defaults to a random value if omitted.
</para>
<para>
<example>
<title><function>srand</function> example</title>
<programlisting role="php">
<![CDATA[
<?php
// seed with microseconds
function make_seed()
{
list($usec, $sec) = explode(' ', microtime());
return (float) $sec + ((float) $usec * 100000);
}
srand(make_seed());
$randval = rand();
?>
]]>
</programlisting>
</example>
Seeds the random number generator with <parameter>seed</parameter>
or with a random value if no <parameter>seed</parameter> is given.
</para>
&note.randomseed;
<simpara>
See also:
<function>rand</function>,
<function>getrandmax</function>, and
<function>mt_srand</function>.
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<term><parameter>seed</parameter></term>
<listitem>
<para>
Optional seed value
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<refsect1 role="changelog">
&reftitle.changelog;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>Since 4.2.0</entry>
<entry>
The <parameter>seed</parameter> becomes optional
and defaults to a random value if omitted.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>rand</function></member>
<member><function>getrandmax</function></member>
<member><function>mt_srand</function></member>
</simplelist>
</para>
</refsect1>

40
reference/math/functions/tan.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.8 $ -->
<!-- $Revision: 1.9 $ -->
<refentry id="function.tan">
<refnamediv>
<refname>tan</refname>
@ -29,23 +29,16 @@ echo tan(M_PI_4); // 1
</programlisting>
</example>
</para>
<para>
See also:
<function>atan</function>,
<function>sin</function>,
<function>cos</function>, and
<function>deg2rad</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<term><parameter>arg</parameter></term>
<listitem>
<para>
The argument to process in radians
</para>
</listitem>
</varlistentry>
@ -55,20 +48,41 @@ echo tan(M_PI_4); // 1
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
The tangent of <parameter>arg</parameter>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>srand</function> example</title>
<programlisting role="php">
<![CDATA[
<?php
// seed with microseconds
function make_seed()
{
list($usec, $sec) = explode(' ', microtime());
return (float) $sec + ((float) $usec * 100000);
}
srand(make_seed());
$randval = rand();
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>atan</function></member>
<member><function>atan2</function></member>
<member><function>sin</function></member>
<member><function>cos</function></member>
<member><function>tanh</function></member>
<member><function>deg2rad</function></member>
</simplelist>
</para>
</refsect1>

26
reference/math/functions/tanh.xml
View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.5 $ -->
<!-- $Revision: 1.6 $ -->
<refentry id="function.tanh">
<refnamediv>
<refname>tanh</refname>
@ -15,23 +15,16 @@
Returns the hyperbolic tangent of <parameter>arg</parameter>,
defined as <literal>sinh(arg)/cosh(arg)</literal>.
</para>
<para>
See also:
<function>tan</function>,
<function>atanh</function>,
<function>sin</function>, and
<function>cos</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter> </parameter></term>
<term><parameter>arg</parameter></term>
<listitem>
<para>
The argument to process
</para>
</listitem>
</varlistentry>
@ -41,20 +34,17 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
The hyperbolic tangent of <parameter>arg</parameter>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function> </function></member>
<member><function>tan</function></member>
<member><function>atanh</function></member>
<member><function>sinh</function></member>
<member><function>cosh</function></member>
</simplelist>
</para>
</refsect1>