cvs: phpdoc /en/reference/math/functions abs.xml acos.xml acosh.xml asin.xml asinh.xml atan.xml atan2.xml atanh.xml base-convert.xml bindec.xml
ceil.xml cos.xml cosh.xml decbin.xml dechex.xml decoct.xml deg2rad.xml exp.xml expm1.xml floor.xml fmod.xml getrandmax.xml hexdec.xml hypot.xml
is-finite.xml is-infinite.xml is-nan.xml lcg-value.xml log.xml log10.xml log1p.xml max.xml min.xml mt-getrandmax.xml mt-rand.xml mt-srand.xml
octdec.xml pi.xml pow.xml rad2deg.xml rand.xml round.xml sin.xml sinh.xml sqrt.xml srand.xml tan.xml tanh.xml

hholzgra Sat Mar 31 10:43:52 2007 UTC Modified files: /phpdoc/en/reference/math/functions abs.xml acos.xml acosh.xml asin.xml asinh.xml atan.xml atan2.xml atanh.xml base-convert.xml bindec.xml ceil.xml cos.xml cosh.xml decbin.xml dechex.xml decoct.xml deg2rad.xml exp.xml expm1.xml floor.xml fmod.xml getrandmax.xml hexdec.xml hypot.xml is-finite.xml is-infinite.xml is-nan.xml lcg-value.xml log.xml log10.xml log1p.xml max.xml min.xml mt-getrandmax.xml mt-rand.xml mt-srand.xml octdec.xml pi.xml pow.xml rad2deg.xml rand.xml round.xml sin.xml sinh.xml sqrt.xml srand.xml tan.xml tanh.xml Log: whitespace

http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/abs.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/math/functions/abs.xml diff -u phpdoc/en/reference/math/functions/abs.xml:1.5 phpdoc/en/reference/math/functions/abs.xml:1.6 --- phpdoc/en/reference/math/functions/abs.xml:1.5 Mon Dec 8 09:17:26 2003 +++ phpdoc/en/reference/math/functions/abs.xml Sat Mar 31 10:43:52 2007 @@ -1,27 +1,27 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.abs"> - <refnamediv> - <refname>abs</refname> - <refpurpose>Absolute value</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>number</type><methodname>abs</methodname> - <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>). - </para> - <example> - <title><function>abs</function> example</title> - <programlisting role="php"> +<refentry id="function.abs"> + <refnamediv> + <refname>abs</refname> + <refpurpose>Absolute value</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>number</type><methodname>abs</methodname> + <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>). + </para> + <example> + <title><function>abs</function> example</title> + <programlisting role="php"> <![CDATA[ <?php $abs = abs(-4.2); // $abs = 4.2; (double/float) @@ -29,10 +29,10 @@ $abs3 = abs(-5); // $abs3 = 5; (integer) ?> ]]> - </programlisting> - </example> - </refsect1> - </refentry> + </programlisting> + </example> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/acos.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/math/functions/acos.xml diff -u phpdoc/en/reference/math/functions/acos.xml:1.4 phpdoc/en/reference/math/functions/acos.xml:1.5 --- phpdoc/en/reference/math/functions/acos.xml:1.4 Wed Mar 10 14:39:13 2004 +++ phpdoc/en/reference/math/functions/acos.xml Sat Mar 31 10:43:52 2007 @@ -1,32 +1,32 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.57 --> - <refentry id="function.acos"> - <refnamediv> - <refname>acos</refname> - <refpurpose>Arc cosine</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>acos</methodname> - <methodparam><type>float</type><parameter>arg</parameter></methodparam> - </methodsynopsis> - <para> - Returns the arc cosine of <parameter>arg</parameter> in radians. - <function>acos</function> is the complementary function of - <function>cos</function>, which means that - <literal>a==cos(acos(a))</literal> for every value of a that is within - <function>acos</function>' range. - </para> - <para> - See also: - <function>acosh</function>, - <function>asin</function>, and - <function>atan</function>. - </para> - </refsect1> - </refentry> +<refentry id="function.acos"> + <refnamediv> + <refname>acos</refname> + <refpurpose>Arc cosine</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>acos</methodname> + <methodparam><type>float</type><parameter>arg</parameter></methodparam> + </methodsynopsis> + <para> + Returns the arc cosine of <parameter>arg</parameter> in radians. + <function>acos</function> is the complementary function of + <function>cos</function>, which means that + <literal>a==cos(acos(a))</literal> for every value of a that is within + <function>acos</function>' range. + </para> + <para> + See also: + <function>acosh</function>, + <function>asin</function>, and + <function>atan</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/acosh.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/math/functions/acosh.xml diff -u phpdoc/en/reference/math/functions/acosh.xml:1.4 phpdoc/en/reference/math/functions/acosh.xml:1.5 --- phpdoc/en/reference/math/functions/acosh.xml:1.4 Wed Mar 10 14:39:13 2004 +++ phpdoc/en/reference/math/functions/acosh.xml Sat Mar 31 10:43:52 2007 @@ -1,31 +1,31 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.acosh"> - <refnamediv> - <refname>acosh</refname> - <refpurpose>Inverse hyperbolic cosine</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>acosh</methodname> - <methodparam><type>float</type><parameter>arg</parameter></methodparam> - </methodsynopsis> - <para> - Returns the inverse hyperbolic cosine of - <parameter>arg</parameter>, i.e. the value whose - hyperbolic cosine is <parameter>arg</parameter>. - </para> - &note.no-windows; - <para> - See also: - <function>acos</function>, - <function>asinh</function>, and - <function>atanh</function>. - </para> - </refsect1> - </refentry> +<refentry id="function.acosh"> + <refnamediv> + <refname>acosh</refname> + <refpurpose>Inverse hyperbolic cosine</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>acosh</methodname> + <methodparam><type>float</type><parameter>arg</parameter></methodparam> + </methodsynopsis> + <para> + Returns the inverse hyperbolic cosine of + <parameter>arg</parameter>, i.e. the value whose + hyperbolic cosine is <parameter>arg</parameter>. + </para> + &note.no-windows; + <para> + See also: + <function>acos</function>, + <function>asinh</function>, and + <function>atanh</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/asin.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/math/functions/asin.xml diff -u phpdoc/en/reference/math/functions/asin.xml:1.4 phpdoc/en/reference/math/functions/asin.xml:1.5 --- phpdoc/en/reference/math/functions/asin.xml:1.4 Wed Mar 10 14:39:13 2004 +++ phpdoc/en/reference/math/functions/asin.xml Sat Mar 31 10:43:52 2007 @@ -1,32 +1,32 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.57 --> - <refentry id="function.asin"> - <refnamediv> - <refname>asin</refname> - <refpurpose>Arc sine</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>asin</methodname> - <methodparam><type>float</type><parameter>arg</parameter></methodparam> - </methodsynopsis> - <para> - Returns the arc sine of <parameter>arg</parameter> in radians. - <function>asin</function> is the complementary function of - <function>sin</function>, which means that - <literal>a==sin(asin(a))</literal> for every value of a that is within - <function>asin</function>'s range. - </para> - <para> - See also: - <function>asinh</function>, - <function>acos</function>, and - <function>atan</function>. - </para> - </refsect1> - </refentry> +<refentry id="function.asin"> + <refnamediv> + <refname>asin</refname> + <refpurpose>Arc sine</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>asin</methodname> + <methodparam><type>float</type><parameter>arg</parameter></methodparam> + </methodsynopsis> + <para> + Returns the arc sine of <parameter>arg</parameter> in radians. + <function>asin</function> is the complementary function of + <function>sin</function>, which means that + <literal>a==sin(asin(a))</literal> for every value of a that is within + <function>asin</function>'s range. + </para> + <para> + See also: + <function>asinh</function>, + <function>acos</function>, and + <function>atan</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/asinh.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/math/functions/asinh.xml diff -u phpdoc/en/reference/math/functions/asinh.xml:1.4 phpdoc/en/reference/math/functions/asinh.xml:1.5 --- phpdoc/en/reference/math/functions/asinh.xml:1.4 Wed Mar 10 14:39:13 2004 +++ phpdoc/en/reference/math/functions/asinh.xml Sat Mar 31 10:43:52 2007 @@ -1,31 +1,31 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.asinh"> - <refnamediv> - <refname>asinh</refname> - <refpurpose>Inverse hyperbolic sine</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>asinh</methodname> - <methodparam><type>float</type><parameter>arg</parameter></methodparam> - </methodsynopsis> - <para> - Returns the inverse hyperbolic sine of - <parameter>arg</parameter>, i.e. the value whose - 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> - </refentry> +<refentry id="function.asinh"> + <refnamediv> + <refname>asinh</refname> + <refpurpose>Inverse hyperbolic sine</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>asinh</methodname> + <methodparam><type>float</type><parameter>arg</parameter></methodparam> + </methodsynopsis> + <para> + Returns the inverse hyperbolic sine of + <parameter>arg</parameter>, i.e. the value whose + 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> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/atan.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/math/functions/atan.xml diff -u phpdoc/en/reference/math/functions/atan.xml:1.4 phpdoc/en/reference/math/functions/atan.xml:1.5 --- phpdoc/en/reference/math/functions/atan.xml:1.4 Wed Mar 10 14:39:13 2004 +++ phpdoc/en/reference/math/functions/atan.xml Sat Mar 31 10:43:52 2007 @@ -1,32 +1,32 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.57 --> - <refentry id="function.atan"> - <refnamediv> - <refname>atan</refname> - <refpurpose>Arc tangent</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>atan</methodname> - <methodparam><type>float</type><parameter>arg</parameter></methodparam> - </methodsynopsis> - <para> - Returns the arc tangent of <parameter>arg</parameter> in radians. - <function>atan</function> is the complementary function of - <function>tan</function>, which means that - <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> - </refentry> +<refentry id="function.atan"> + <refnamediv> + <refname>atan</refname> + <refpurpose>Arc tangent</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>atan</methodname> + <methodparam><type>float</type><parameter>arg</parameter></methodparam> + </methodsynopsis> + <para> + Returns the arc tangent of <parameter>arg</parameter> in radians. + <function>atan</function> is the complementary function of + <function>tan</function>, which means that + <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> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/atan2.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/math/functions/atan2.xml diff -u phpdoc/en/reference/math/functions/atan2.xml:1.3 phpdoc/en/reference/math/functions/atan2.xml:1.4 --- phpdoc/en/reference/math/functions/atan2.xml:1.3 Mon Dec 8 09:18:07 2003 +++ phpdoc/en/reference/math/functions/atan2.xml Sat Mar 31 10:43:52 2007 @@ -1,35 +1,35 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.atan2"> - <refnamediv> - <refname>atan2</refname> - <refpurpose>Arc tangent of two variables</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>atan2</methodname> - <methodparam><type>float</type><parameter>y</parameter></methodparam> - <methodparam><type>float</type><parameter>x</parameter></methodparam> - </methodsynopsis> - <simpara> - This function calculates the arc tangent of the two variables - <parameter>x</parameter> and <parameter>y</parameter>. It is - similar to calculating the arc tangent of - <parameter>y</parameter> / <parameter>x</parameter>, except that - the signs of both arguments are used to determine the quadrant of - the result. - </simpara> - <simpara> - 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> - </refentry> +<refentry id="function.atan2"> + <refnamediv> + <refname>atan2</refname> + <refpurpose>Arc tangent of two variables</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>atan2</methodname> + <methodparam><type>float</type><parameter>y</parameter></methodparam> + <methodparam><type>float</type><parameter>x</parameter></methodparam> + </methodsynopsis> + <simpara> + This function calculates the arc tangent of the two variables + <parameter>x</parameter> and <parameter>y</parameter>. It is + similar to calculating the arc tangent of + <parameter>y</parameter> / <parameter>x</parameter>, except that + the signs of both arguments are used to determine the quadrant of + the result. + </simpara> + <simpara> + 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> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/atanh.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/math/functions/atanh.xml diff -u phpdoc/en/reference/math/functions/atanh.xml:1.4 phpdoc/en/reference/math/functions/atanh.xml:1.5 --- phpdoc/en/reference/math/functions/atanh.xml:1.4 Wed Mar 10 14:39:13 2004 +++ phpdoc/en/reference/math/functions/atanh.xml Sat Mar 31 10:43:52 2007 @@ -1,31 +1,31 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.atanh"> - <refnamediv> - <refname>atanh</refname> - <refpurpose>Inverse hyperbolic tangent</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>atanh</methodname> - <methodparam><type>float</type><parameter>arg</parameter></methodparam> - </methodsynopsis> - <para> - Returns the inverse hyperbolic tangent of - <parameter>arg</parameter>, i.e. the value whose - hyperbolic tangent is <parameter>arg</parameter>. - </para> - &note.no-windows; - <para> - See also: - <function>atan</function>, - <function>asinh</function>, and - <function>acosh</function>. - </para> - </refsect1> - </refentry> +<refentry id="function.atanh"> + <refnamediv> + <refname>atanh</refname> + <refpurpose>Inverse hyperbolic tangent</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>atanh</methodname> + <methodparam><type>float</type><parameter>arg</parameter></methodparam> + </methodsynopsis> + <para> + Returns the inverse hyperbolic tangent of + <parameter>arg</parameter>, i.e. the value whose + hyperbolic tangent is <parameter>arg</parameter>. + </para> + &note.no-windows; + <para> + See also: + <function>atan</function>, + <function>asinh</function>, and + <function>acosh</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/base-convert.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/math/functions/base-convert.xml diff -u phpdoc/en/reference/math/functions/base-convert.xml:1.6 phpdoc/en/reference/math/functions/base-convert.xml:1.7 --- phpdoc/en/reference/math/functions/base-convert.xml:1.6 Fri Dec 30 23:10:53 2005 +++ phpdoc/en/reference/math/functions/base-convert.xml Sat Mar 31 10:43:52 2007 @@ -1,61 +1,61 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.base-convert"> - <refnamediv> - <refname>base_convert</refname> - <refpurpose>Convert a number between arbitrary bases</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>base_convert</methodname> - <methodparam><type>string</type><parameter>number</parameter></methodparam> - <methodparam><type>int</type><parameter>frombase</parameter></methodparam> - <methodparam><type>int</type><parameter>tobase</parameter></methodparam> - </methodsynopsis> - <para> - Returns a string containing <parameter>number</parameter> - represented in base <parameter>tobase</parameter>. The base in - which <parameter>number</parameter> is given is specified in - <parameter>frombase</parameter>. Both - <parameter>frombase</parameter> and <parameter>tobase</parameter> - 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. - <example> - <title><function>base_convert</function> example</title> - <programlisting role="php"> +<refentry id="function.base-convert"> + <refnamediv> + <refname>base_convert</refname> + <refpurpose>Convert a number between arbitrary bases</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>string</type><methodname>base_convert</methodname> + <methodparam><type>string</type><parameter>number</parameter></methodparam> + <methodparam><type>int</type><parameter>frombase</parameter></methodparam> + <methodparam><type>int</type><parameter>tobase</parameter></methodparam> + </methodsynopsis> + <para> + Returns a string containing <parameter>number</parameter> + represented in base <parameter>tobase</parameter>. The base in + which <parameter>number</parameter> is given is specified in + <parameter>frombase</parameter>. Both + <parameter>frombase</parameter> and <parameter>tobase</parameter> + 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. + <example> + <title><function>base_convert</function> example</title> + <programlisting role="php"> <![CDATA[ <?php $hexadecimal = 'A37334'; echo base_convert($hexadecimal, 16, 2); ?> ]]> - </programlisting> - <para> - Outputs: - </para> - <screen> + </programlisting> + <para> + Outputs: + </para> + <screen> <![CDATA[ 101000110111001100110100 ]]> - </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> - </refentry> + </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> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/bindec.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/math/functions/bindec.xml diff -u phpdoc/en/reference/math/functions/bindec.xml:1.8 phpdoc/en/reference/math/functions/bindec.xml:1.9 --- phpdoc/en/reference/math/functions/bindec.xml:1.8 Fri Mar 11 16:11:50 2005 +++ phpdoc/en/reference/math/functions/bindec.xml Sat Mar 31 10:43:52 2007 @@ -1,32 +1,32 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.bindec"> - <refnamediv> - <refname>bindec</refname> - <refpurpose>Binary to decimal</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>number</type><methodname>bindec</methodname> - <methodparam><type>string</type><parameter>binary_string</parameter></methodparam> - </methodsynopsis> - <para> - Returns the decimal equivalent of the binary number represented by - the <parameter>binary_string</parameter> argument. - </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. - </para> - <para> - <example> - <title><function>bindec</function> example</title> - <programlisting role="php"> +<refentry id="function.bindec"> + <refnamediv> + <refname>bindec</refname> + <refpurpose>Binary to decimal</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>number</type><methodname>bindec</methodname> + <methodparam><type>string</type><parameter>binary_string</parameter></methodparam> + </methodsynopsis> + <para> + Returns the decimal equivalent of the binary number represented by + the <parameter>binary_string</parameter> argument. + </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. + </para> + <para> + <example> + <title><function>bindec</function> example</title> + <programlisting role="php"> <![CDATA[ <?php echo bindec('110011') . "\n"; @@ -35,25 +35,25 @@ echo bindec('111'); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ 51 51 7 ]]> - </screen> - </example> - </para> - <para> - See also <function>decbin</function>, - <function>octdec</function>, - <function>hexdec</function> and - <function>base_convert</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + <para> + See also <function>decbin</function>, + <function>octdec</function>, + <function>hexdec</function> and + <function>base_convert</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/ceil.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/math/functions/ceil.xml diff -u phpdoc/en/reference/math/functions/ceil.xml:1.6 phpdoc/en/reference/math/functions/ceil.xml:1.7 --- phpdoc/en/reference/math/functions/ceil.xml:1.6 Sun Oct 15 23:24:12 2006 +++ phpdoc/en/reference/math/functions/ceil.xml Sat Mar 31 10:43:52 2007 @@ -1,28 +1,28 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.ceil"> - <refnamediv> - <refname>ceil</refname> - <refpurpose>Round fractions up</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>ceil</methodname> - <methodparam><type>float</type><parameter>value</parameter></methodparam> - </methodsynopsis> - <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> - <title><function>ceil</function> example</title> - <programlisting role="php"> +<refentry id="function.ceil"> + <refnamediv> + <refname>ceil</refname> + <refpurpose>Round fractions up</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>ceil</methodname> + <methodparam><type>float</type><parameter>value</parameter></methodparam> + </methodsynopsis> + <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> + <title><function>ceil</function> example</title> + <programlisting role="php"> <![CDATA[ <?php echo ceil(4.3); // 5 @@ -30,15 +30,15 @@ echo ceil(-3.14); // -3 ?> ]]> - </programlisting> - </example> - </para> - <simpara> - See also <function>floor</function> and - <function>round</function>. - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <simpara> + See also <function>floor</function> and + <function>round</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/cos.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/math/functions/cos.xml diff -u phpdoc/en/reference/math/functions/cos.xml:1.5 phpdoc/en/reference/math/functions/cos.xml:1.6 --- phpdoc/en/reference/math/functions/cos.xml:1.5 Wed Mar 10 14:39:13 2004 +++ phpdoc/en/reference/math/functions/cos.xml Sat Mar 31 10:43:52 2007 @@ -1,25 +1,25 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.cos"> - <refnamediv> - <refname>cos</refname> - <refpurpose>Cosine</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>cos</methodname> - <methodparam><type>float</type><parameter>arg</parameter></methodparam> - </methodsynopsis> - <para> - <function>cos</function> returns the cosine of the <parameter>arg</parameter> - parameter. The <parameter>arg</parameter> parameter is in radians. - </para> - <para> - <example> - <title><function>cos</function> example</title> - <programlisting role="php"> +<refentry id="function.cos"> + <refnamediv> + <refname>cos</refname> + <refpurpose>Cosine</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>cos</methodname> + <methodparam><type>float</type><parameter>arg</parameter></methodparam> + </methodsynopsis> + <para> + <function>cos</function> returns the cosine of the <parameter>arg</parameter> + parameter. The <parameter>arg</parameter> parameter is in radians. + </para> + <para> + <example> + <title><function>cos</function> example</title> + <programlisting role="php"> <![CDATA[ <?php @@ -27,18 +27,18 @@ ?> ]]> - </programlisting> - </example> - </para> - <para> - See also: - <function>acos</function>, - <function>sin</function>, - <function>tan</function>, and - <function>deg2rad</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + See also: + <function>acos</function>, + <function>sin</function>, + <function>tan</function>, and + <function>deg2rad</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/cosh.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/math/functions/cosh.xml diff -u phpdoc/en/reference/math/functions/cosh.xml:1.3 phpdoc/en/reference/math/functions/cosh.xml:1.4 --- phpdoc/en/reference/math/functions/cosh.xml:1.3 Wed Mar 10 14:39:13 2004 +++ phpdoc/en/reference/math/functions/cosh.xml Sat Mar 31 10:43:52 2007 @@ -1,30 +1,30 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.57 --> - <refentry id="function.cosh"> - <refnamediv> - <refname>cosh</refname> - <refpurpose>Hyperbolic cosine</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>cosh</methodname> - <methodparam><type>float</type><parameter>arg</parameter></methodparam> - </methodsynopsis> - <para> - 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> - </refentry> +<refentry id="function.cosh"> + <refnamediv> + <refname>cosh</refname> + <refpurpose>Hyperbolic cosine</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>cosh</methodname> + <methodparam><type>float</type><parameter>arg</parameter></methodparam> + </methodsynopsis> + <para> + 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> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/decbin.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/math/functions/decbin.xml diff -u phpdoc/en/reference/math/functions/decbin.xml:1.8 phpdoc/en/reference/math/functions/decbin.xml:1.9 --- phpdoc/en/reference/math/functions/decbin.xml:1.8 Fri Mar 11 16:11:50 2005 +++ phpdoc/en/reference/math/functions/decbin.xml Sat Mar 31 10:43:52 2007 @@ -1,50 +1,50 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.decbin"> - <refnamediv> - <refname>decbin</refname> - <refpurpose>Decimal to binary</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>decbin</methodname> - <methodparam><type>int</type><parameter>number</parameter></methodparam> - </methodsynopsis> - <para> - Returns a string containing a binary representation of the given - <parameter>number</parameter> argument. The largest number that can be converted is - 4294967295 in decimal resulting to a string of 32 1's. - </para> - <para> - <example> - <title><function>decbin</function> example</title> - <programlisting role="php"> +<refentry id="function.decbin"> + <refnamediv> + <refname>decbin</refname> + <refpurpose>Decimal to binary</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>string</type><methodname>decbin</methodname> + <methodparam><type>int</type><parameter>number</parameter></methodparam> + </methodsynopsis> + <para> + Returns a string containing a binary representation of the given + <parameter>number</parameter> argument. The largest number that can be converted is + 4294967295 in decimal resulting to a string of 32 1's. + </para> + <para> + <example> + <title><function>decbin</function> example</title> + <programlisting role="php"> <![CDATA[ <?php echo decbin(12) . "\n"; echo decbin(26); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ 1100 11010 ]]> - </screen> - </example> - </para> - <para> - See also <function>bindec</function>, - <function>decoct</function>, - <function>dechex</function> and - <function>base_convert</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + <para> + See also <function>bindec</function>, + <function>decoct</function>, + <function>dechex</function> and + <function>base_convert</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/dechex.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/math/functions/dechex.xml diff -u phpdoc/en/reference/math/functions/dechex.xml:1.7 phpdoc/en/reference/math/functions/dechex.xml:1.8 --- phpdoc/en/reference/math/functions/dechex.xml:1.7 Fri Mar 11 16:11:50 2005 +++ phpdoc/en/reference/math/functions/dechex.xml Sat Mar 31 10:43:52 2007 @@ -1,50 +1,50 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> +<!-- $Revision: 1.8 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.dechex"> - <refnamediv> - <refname>dechex</refname> - <refpurpose>Decimal to hexadecimal</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>dechex</methodname> - <methodparam><type>int</type><parameter>number</parameter></methodparam> - </methodsynopsis> - <para> - Returns a string containing a hexadecimal representation of the - given <parameter>number</parameter> argument. The largest number that can - be converted is 4294967295 in decimal resulting to "ffffffff". - </para> - <para> - <example> - <title><function>dechex</function> example</title> - <programlisting role="php"> +<refentry id="function.dechex"> + <refnamediv> + <refname>dechex</refname> + <refpurpose>Decimal to hexadecimal</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>string</type><methodname>dechex</methodname> + <methodparam><type>int</type><parameter>number</parameter></methodparam> + </methodsynopsis> + <para> + Returns a string containing a hexadecimal representation of the + given <parameter>number</parameter> argument. The largest number that can + be converted is 4294967295 in decimal resulting to "ffffffff". + </para> + <para> + <example> + <title><function>dechex</function> example</title> + <programlisting role="php"> <![CDATA[ <?php echo dechex(10) . "\n"; echo dechex(47); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ a 2f ]]> - </screen> - </example> - </para> - <para> - See also <function>hexdec</function>, - <function>decbin</function>, - <function>decoct</function> and - <function>base_convert</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + <para> + See also <function>hexdec</function>, + <function>decbin</function>, + <function>decoct</function> and + <function>base_convert</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/decoct.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/math/functions/decoct.xml diff -u phpdoc/en/reference/math/functions/decoct.xml:1.7 phpdoc/en/reference/math/functions/decoct.xml:1.8 --- phpdoc/en/reference/math/functions/decoct.xml:1.7 Fri Mar 11 16:11:50 2005 +++ phpdoc/en/reference/math/functions/decoct.xml Sat Mar 31 10:43:52 2007 @@ -1,50 +1,50 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> +<!-- $Revision: 1.8 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.8 --> - <refentry id="function.decoct"> - <refnamediv> - <refname>decoct</refname> - <refpurpose>Decimal to octal</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>string</type><methodname>decoct</methodname> - <methodparam><type>int</type><parameter>number</parameter></methodparam> - </methodsynopsis> - <para> - Returns a string containing an octal representation of the given - <parameter>number</parameter> argument. The largest number that can be converted is - 4294967295 in decimal resulting to "37777777777". - </para> - <para> - <example> - <title><function>decoct</function> example</title> - <programlisting role="php"> +<refentry id="function.decoct"> + <refnamediv> + <refname>decoct</refname> + <refpurpose>Decimal to octal</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>string</type><methodname>decoct</methodname> + <methodparam><type>int</type><parameter>number</parameter></methodparam> + </methodsynopsis> + <para> + Returns a string containing an octal representation of the given + <parameter>number</parameter> argument. The largest number that can be converted is + 4294967295 in decimal resulting to "37777777777". + </para> + <para> + <example> + <title><function>decoct</function> example</title> + <programlisting role="php"> <![CDATA[ <?php echo decoct(15) . "\n"; echo decoct(264); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ 17 410 ]]> - </screen> - </example> - </para> - <para> - See also <function>octdec</function>, - <function>decbin</function>, - <function>dechex</function> and - <function>base_convert</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + <para> + See also <function>octdec</function>, + <function>decbin</function>, + <function>dechex</function> and + <function>base_convert</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/deg2rad.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/math/functions/deg2rad.xml diff -u phpdoc/en/reference/math/functions/deg2rad.xml:1.3 phpdoc/en/reference/math/functions/deg2rad.xml:1.4 --- phpdoc/en/reference/math/functions/deg2rad.xml:1.3 Tue Oct 21 11:48:57 2003 +++ phpdoc/en/reference/math/functions/deg2rad.xml Sat Mar 31 10:43:52 2007 @@ -1,27 +1,27 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.deg2rad"> - <refnamediv> - <refname>deg2rad</refname> - <refpurpose> - Converts the number in degrees to the radian equivalent - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>deg2rad</methodname> - <methodparam><type>float</type><parameter>number</parameter></methodparam> - </methodsynopsis> - <para> - This function converts <parameter>number</parameter> from degrees - to the radian equivalent. - </para> - <para> - <example> - <title><function>deg2rad</function> example</title> - <programlisting role="php"> +<refentry id="function.deg2rad"> + <refnamediv> + <refname>deg2rad</refname> + <refpurpose> + Converts the number in degrees to the radian equivalent + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>deg2rad</methodname> + <methodparam><type>float</type><parameter>number</parameter></methodparam> + </methodsynopsis> + <para> + This function converts <parameter>number</parameter> from degrees + to the radian equivalent. + </para> + <para> + <example> + <title><function>deg2rad</function> example</title> + <programlisting role="php"> <![CDATA[ <?php @@ -30,14 +30,14 @@ ?> ]]> - </programlisting> - </example> - </para> - <para> - See also <function>rad2deg</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + See also <function>rad2deg</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/exp.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/math/functions/exp.xml diff -u phpdoc/en/reference/math/functions/exp.xml:1.9 phpdoc/en/reference/math/functions/exp.xml:1.10 --- phpdoc/en/reference/math/functions/exp.xml:1.9 Tue Apr 18 07:54:45 2006 +++ phpdoc/en/reference/math/functions/exp.xml Sat Mar 31 10:43:52 2007 @@ -1,53 +1,53 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> +<!-- $Revision: 1.10 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.exp"> - <refnamediv> - <refname>exp</refname> - <refpurpose>Calculates the exponent of <constant>e</constant></refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>exp</methodname> - <methodparam><type>float</type><parameter>arg</parameter></methodparam> - </methodsynopsis> - <para> - Returns <constant>e</constant> raised to the power of <parameter>arg</parameter>. - </para> - <note> - <para> - 'e' is the base of the natural system of logarithms, or approximately - 2.718282. - </para> - </note> - <para> - <example> - <title><function>exp</function> example</title> - <programlisting role="php"> +<refentry id="function.exp"> + <refnamediv> + <refname>exp</refname> + <refpurpose>Calculates the exponent of <constant>e</constant></refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>exp</methodname> + <methodparam><type>float</type><parameter>arg</parameter></methodparam> + </methodsynopsis> + <para> + Returns <constant>e</constant> raised to the power of <parameter>arg</parameter>. + </para> + <note> + <para> + 'e' is the base of the natural system of logarithms, or approximately + 2.718282. + </para> + </note> + <para> + <example> + <title><function>exp</function> example</title> + <programlisting role="php"> <![CDATA[ <?php echo exp(12) . "\n"; echo exp(5.7); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ 1.6275E+005 298.87 ]]> - </screen> - </example> - </para> - <para> - See also - <function>log</function> and - <function>pow</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + <para> + See also + <function>log</function> and + <function>pow</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/expm1.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/math/functions/expm1.xml diff -u phpdoc/en/reference/math/functions/expm1.xml:1.5 phpdoc/en/reference/math/functions/expm1.xml:1.6 --- phpdoc/en/reference/math/functions/expm1.xml:1.5 Sat Sep 25 09:27:22 2004 +++ phpdoc/en/reference/math/functions/expm1.xml Sat Mar 31 10:43:52 2007 @@ -1,35 +1,35 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.63 --> - <refentry id='function.expm1'> - <refnamediv> - <refname>expm1</refname> - <refpurpose> - Returns exp(number) - 1, computed in a way that is accurate even - when the value of number is close to zero - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>expm1</methodname> - <methodparam><type>float</type><parameter>number</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 - 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> - </refentry> +<refentry id='function.expm1'> + <refnamediv> + <refname>expm1</refname> + <refpurpose> + Returns exp(number) - 1, computed in a way that is accurate even + when the value of number is close to zero + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>expm1</methodname> + <methodparam><type>float</type><parameter>number</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 + 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> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/floor.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/math/functions/floor.xml diff -u phpdoc/en/reference/math/functions/floor.xml:1.6 phpdoc/en/reference/math/functions/floor.xml:1.7 --- phpdoc/en/reference/math/functions/floor.xml:1.6 Sun Oct 15 23:24:12 2006 +++ phpdoc/en/reference/math/functions/floor.xml Sat Mar 31 10:43:52 2007 @@ -1,28 +1,28 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.floor"> - <refnamediv> - <refname>floor</refname> - <refpurpose>Round fractions down</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>floor</methodname> - <methodparam><type>float</type><parameter>value</parameter></methodparam> - </methodsynopsis> - <simpara> - Returns the next lowest integer value by rounding down - <parameter>value</parameter> if necessary. - 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> - <example> - <title><function>floor</function> example</title> - <programlisting role="php"> +<refentry id="function.floor"> + <refnamediv> + <refname>floor</refname> + <refpurpose>Round fractions down</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>floor</methodname> + <methodparam><type>float</type><parameter>value</parameter></methodparam> + </methodsynopsis> + <simpara> + Returns the next lowest integer value by rounding down + <parameter>value</parameter> if necessary. + 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> + <example> + <title><function>floor</function> example</title> + <programlisting role="php"> <![CDATA[ <?php echo floor(4.3); // 4 @@ -30,15 +30,15 @@ echo floor(-3.14); // -4 ?> ]]> - </programlisting> - </example> - </para> - <simpara> - See also <function>ceil</function> and - <function>round</function>. - </simpara> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <simpara> + See also <function>ceil</function> and + <function>round</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/fmod.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/math/functions/fmod.xml diff -u phpdoc/en/reference/math/functions/fmod.xml:1.5 phpdoc/en/reference/math/functions/fmod.xml:1.6 --- phpdoc/en/reference/math/functions/fmod.xml:1.5 Mon Jun 16 18:31:33 2003 +++ phpdoc/en/reference/math/functions/fmod.xml Sat Mar 31 10:43:52 2007 @@ -1,31 +1,31 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> - <refentry id="function.fmod"> - <refnamediv> - <refname>fmod</refname> - <refpurpose>Returns the floating point remainder (modulo) of the division - of the arguments</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>fmod</methodname> - <methodparam><type>float</type><parameter>x</parameter></methodparam> - <methodparam><type>float</type><parameter>y</parameter></methodparam> - </methodsynopsis> - <para> - Returns the floating point remainder of dividing the dividend - (<parameter>x</parameter>) by the divisor (<parameter>y</parameter>). - The reminder (<varname>r</varname>) is defined as: x = i * y + r, for - some integer <varname>i</varname>. If <parameter>y</parameter> is - non-zero, <varname>r</varname> has the same sign as - <parameter>x</parameter> and a magnitude less than the magnitude of - <parameter>y</parameter>. - </para> - <para> - <example> - <title>Using <function>fmod</function></title> - <programlisting role="php"> +<!-- $Revision: 1.6 $ --> +<refentry id="function.fmod"> + <refnamediv> + <refname>fmod</refname> + <refpurpose>Returns the floating point remainder (modulo) of the division + of the arguments</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>fmod</methodname> + <methodparam><type>float</type><parameter>x</parameter></methodparam> + <methodparam><type>float</type><parameter>y</parameter></methodparam> + </methodsynopsis> + <para> + Returns the floating point remainder of dividing the dividend + (<parameter>x</parameter>) by the divisor (<parameter>y</parameter>). + The reminder (<varname>r</varname>) is defined as: x = i * y + r, for + some integer <varname>i</varname>. If <parameter>y</parameter> is + non-zero, <varname>r</varname> has the same sign as + <parameter>x</parameter> and a magnitude less than the magnitude of + <parameter>y</parameter>. + </para> + <para> + <example> + <title>Using <function>fmod</function></title> + <programlisting role="php"> <![CDATA[ <?php $x = 5.7; @@ -34,11 +34,11 @@ // $r equals 0.5, because 4 * 1.3 + 0.5 = 5.7 ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/getrandmax.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/math/functions/getrandmax.xml diff -u phpdoc/en/reference/math/functions/getrandmax.xml:1.3 phpdoc/en/reference/math/functions/getrandmax.xml:1.4 --- phpdoc/en/reference/math/functions/getrandmax.xml:1.3 Mon Jun 3 15:06:16 2002 +++ phpdoc/en/reference/math/functions/getrandmax.xml Sat Mar 31 10:43:52 2007 @@ -1,27 +1,27 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.getrandmax"> - <refnamediv> - <refname>getrandmax</refname> - <refpurpose>Show largest possible random value</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>getrandmax</methodname> - <void/> - </methodsynopsis> - <simpara> - 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> - </refentry> +<refentry id="function.getrandmax"> + <refnamediv> + <refname>getrandmax</refname> + <refpurpose>Show largest possible random value</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>getrandmax</methodname> + <void/> + </methodsynopsis> + <simpara> + 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> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/hexdec.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/math/functions/hexdec.xml diff -u phpdoc/en/reference/math/functions/hexdec.xml:1.9 phpdoc/en/reference/math/functions/hexdec.xml:1.10 --- phpdoc/en/reference/math/functions/hexdec.xml:1.9 Wed Aug 18 16:18:48 2004 +++ phpdoc/en/reference/math/functions/hexdec.xml Sat Mar 31 10:43:52 2007 @@ -1,32 +1,32 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> +<!-- $Revision: 1.10 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.16 --> - <refentry id="function.hexdec"> - <refnamediv> - <refname>hexdec</refname> - <refpurpose>Hexadecimal to decimal</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>number</type><methodname>hexdec</methodname> - <methodparam><type>string</type><parameter>hex_string</parameter></methodparam> - </methodsynopsis> - <para> - 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. - </para> - <para> - <function>hexdec</function> will ignore any non-hexadecimal - characters it encounters. - <example> - <title><function>hexdec</function> example</title> - <programlisting role="php"> +<refentry id="function.hexdec"> + <refnamediv> + <refname>hexdec</refname> + <refpurpose>Hexadecimal to decimal</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>number</type><methodname>hexdec</methodname> + <methodparam><type>string</type><parameter>hex_string</parameter></methodparam> + </methodsynopsis> + <para> + 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. + </para> + <para> + <function>hexdec</function> will ignore any non-hexadecimal + characters it encounters. + <example> + <title><function>hexdec</function> example</title> + <programlisting role="php"> <![CDATA[ <?php var_dump(hexdec("See")); @@ -37,17 +37,17 @@ 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> - </refentry> + </programlisting> + </example> + </para> + <para> + See also <function>dechex</function>, + <function>bindec</function>, + <function>octdec</function> and + <function>base_convert</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/hypot.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/math/functions/hypot.xml diff -u phpdoc/en/reference/math/functions/hypot.xml:1.5 phpdoc/en/reference/math/functions/hypot.xml:1.6 --- phpdoc/en/reference/math/functions/hypot.xml:1.5 Tue Sep 21 15:47:51 2004 +++ phpdoc/en/reference/math/functions/hypot.xml Sat Mar 31 10:43:52 2007 @@ -1,29 +1,29 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.72 --> - <refentry id='function.hypot'> - <refnamediv> - <refname>hypot</refname> - <refpurpose> - Calculate the length of the hypotenuse of a right-angle triangle - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>hypot</methodname> - <methodparam><type>float</type><parameter>x</parameter></methodparam> - <methodparam><type>float</type><parameter>y</parameter></methodparam> - </methodsynopsis> - <para> - <function>hypot</function> returns the length of the hypotenuse of a - right-angle triangle with sides of length <parameter>x</parameter> and - <parameter>y</parameter>, or the distance of the point - (<parameter>x</parameter>, <parameter>y</parameter>) from the origin. - This is equivalent to <literal>sqrt(x*x + y*y)</literal>. - </para> - </refsect1> - </refentry> +<refentry id='function.hypot'> + <refnamediv> + <refname>hypot</refname> + <refpurpose> + Calculate the length of the hypotenuse of a right-angle triangle + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>hypot</methodname> + <methodparam><type>float</type><parameter>x</parameter></methodparam> + <methodparam><type>float</type><parameter>y</parameter></methodparam> + </methodsynopsis> + <para> + <function>hypot</function> returns the length of the hypotenuse of a + right-angle triangle with sides of length <parameter>x</parameter> and + <parameter>y</parameter>, or the distance of the point + (<parameter>x</parameter>, <parameter>y</parameter>) from the origin. + This is equivalent to <literal>sqrt(x*x + y*y)</literal>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/is-finite.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/math/functions/is-finite.xml diff -u phpdoc/en/reference/math/functions/is-finite.xml:1.4 phpdoc/en/reference/math/functions/is-finite.xml:1.5 --- phpdoc/en/reference/math/functions/is-finite.xml:1.4 Tue Oct 21 11:23:44 2003 +++ phpdoc/en/reference/math/functions/is-finite.xml Sat Mar 31 10:43:52 2007 @@ -1,27 +1,27 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.72 --> - <refentry id='function.is-finite'> - <refnamediv> - <refname>is_finite</refname> - <refpurpose>Finds whether a value is a legal finite number</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>is_finite</methodname> - <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>. - </para> - </refsect1> - </refentry> +<refentry id='function.is-finite'> + <refnamediv> + <refname>is_finite</refname> + <refpurpose>Finds whether a value is a legal finite number</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>is_finite</methodname> + <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>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/is-infinite.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/math/functions/is-infinite.xml diff -u phpdoc/en/reference/math/functions/is-infinite.xml:1.4 phpdoc/en/reference/math/functions/is-infinite.xml:1.5 --- phpdoc/en/reference/math/functions/is-infinite.xml:1.4 Tue Oct 21 11:23:45 2003 +++ phpdoc/en/reference/math/functions/is-infinite.xml Sat Mar 31 10:43:52 2007 @@ -1,28 +1,28 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.72 --> - <refentry id='function.is-infinite'> - <refnamediv> - <refname>is_infinite</refname> - <refpurpose>Finds whether a value is infinite</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>is_infinite</methodname> - <methodparam><type>float</type><parameter>val</parameter></methodparam> - </methodsynopsis> - <para> - Returns &true; if <parameter>val</parameter> is infinite (positive or - 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> - </refentry> +<refentry id='function.is-infinite'> + <refnamediv> + <refname>is_infinite</refname> + <refpurpose>Finds whether a value is infinite</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>is_infinite</methodname> + <methodparam><type>float</type><parameter>val</parameter></methodparam> + </methodsynopsis> + <para> + Returns &true; if <parameter>val</parameter> is infinite (positive or + 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> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/is-nan.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/math/functions/is-nan.xml diff -u phpdoc/en/reference/math/functions/is-nan.xml:1.4 phpdoc/en/reference/math/functions/is-nan.xml:1.5 --- phpdoc/en/reference/math/functions/is-nan.xml:1.4 Tue Oct 21 11:23:45 2003 +++ phpdoc/en/reference/math/functions/is-nan.xml Sat Mar 31 10:43:52 2007 @@ -1,27 +1,27 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.63 --> - <refentry id='function.is-nan'> - <refnamediv> - <refname>is_nan</refname> - <refpurpose>Finds whether a value is not a number</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>bool</type><methodname>is_nan</methodname> - <methodparam><type>float</type><parameter>val</parameter></methodparam> - </methodsynopsis> - <para> - Returns &true; if <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> - </refentry> +<refentry id='function.is-nan'> + <refnamediv> + <refname>is_nan</refname> + <refpurpose>Finds whether a value is not a number</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>bool</type><methodname>is_nan</methodname> + <methodparam><type>float</type><parameter>val</parameter></methodparam> + </methodsynopsis> + <para> + Returns &true; if <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> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/lcg-value.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc/en/reference/math/functions/lcg-value.xml diff -u phpdoc/en/reference/math/functions/lcg-value.xml:1.2 phpdoc/en/reference/math/functions/lcg-value.xml:1.3 --- phpdoc/en/reference/math/functions/lcg-value.xml:1.2 Wed Apr 17 06:39:53 2002 +++ phpdoc/en/reference/math/functions/lcg-value.xml Sat Mar 31 10:43:52 2007 @@ -1,25 +1,25 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> +<!-- $Revision: 1.3 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.lcg-value"> - <refnamediv> - <refname>lcg_value</refname> - <refpurpose>Combined linear congruential generator</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>lcg_value</methodname> - <void/> - </methodsynopsis> - <para> - <function>lcg_value</function> returns a pseudo random number in - the range of (0, 1). The function combines two CGs with periods - of 2^31 - 85 and 2^31 - 249. The period of this function is equal - to the product of both primes. - </para> - </refsect1> - </refentry> +<refentry id="function.lcg-value"> + <refnamediv> + <refname>lcg_value</refname> + <refpurpose>Combined linear congruential generator</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>lcg_value</methodname> + <void/> + </methodsynopsis> + <para> + <function>lcg_value</function> returns a pseudo random number in + the range of (0, 1). The function combines two CGs with periods + of 2^31 - 85 and 2^31 - 249. The period of this function is equal + to the product of both primes. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/log.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/math/functions/log.xml diff -u phpdoc/en/reference/math/functions/log.xml:1.9 phpdoc/en/reference/math/functions/log.xml:1.10 --- phpdoc/en/reference/math/functions/log.xml:1.9 Sat Mar 6 02:40:21 2004 +++ phpdoc/en/reference/math/functions/log.xml Sat Mar 31 10:43:52 2007 @@ -1,41 +1,41 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> +<!-- $Revision: 1.10 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.log"> - <refnamediv> - <refname>log</refname> - <refpurpose>Natural logarithm</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>log</methodname> - <methodparam><type>float</type><parameter>arg</parameter></methodparam> - <methodparam choice="opt"><type>float</type><parameter>base</parameter></methodparam> - </methodsynopsis> - <para> - If the optional <parameter>base</parameter> parameter is specified, - <function>log</function> returns log<subscript>base</subscript> - <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> - </refentry> +<refentry id="function.log"> + <refnamediv> + <refname>log</refname> + <refpurpose>Natural logarithm</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>log</methodname> + <methodparam><type>float</type><parameter>arg</parameter></methodparam> + <methodparam choice="opt"><type>float</type><parameter>base</parameter></methodparam> + </methodsynopsis> + <para> + If the optional <parameter>base</parameter> parameter is specified, + <function>log</function> returns log<subscript>base</subscript> + <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> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/log10.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/math/functions/log10.xml diff -u phpdoc/en/reference/math/functions/log10.xml:1.3 phpdoc/en/reference/math/functions/log10.xml:1.4 --- phpdoc/en/reference/math/functions/log10.xml:1.3 Tue Sep 2 02:27:36 2003 +++ phpdoc/en/reference/math/functions/log10.xml Sat Mar 31 10:43:52 2007 @@ -1,26 +1,26 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.log10"> - <refnamediv> - <refname>log10</refname> - <refpurpose>Base-10 logarithm</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>log10</methodname> - <methodparam><type>float</type><parameter>arg</parameter></methodparam> - </methodsynopsis> - <para> - Returns the base-10 logarithm of <parameter>arg</parameter>. - </para> - <simpara> - See Also: - <function>log</function> - </simpara> - </refsect1> - </refentry> +<refentry id="function.log10"> + <refnamediv> + <refname>log10</refname> + <refpurpose>Base-10 logarithm</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>log10</methodname> + <methodparam><type>float</type><parameter>arg</parameter></methodparam> + </methodsynopsis> + <para> + Returns the base-10 logarithm of <parameter>arg</parameter>. + </para> + <simpara> + See Also: + <function>log</function> + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/log1p.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/math/functions/log1p.xml diff -u phpdoc/en/reference/math/functions/log1p.xml:1.6 phpdoc/en/reference/math/functions/log1p.xml:1.7 --- phpdoc/en/reference/math/functions/log1p.xml:1.6 Sat Sep 25 09:27:22 2004 +++ phpdoc/en/reference/math/functions/log1p.xml Sat Mar 31 10:43:52 2007 @@ -1,33 +1,33 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.63 --> - <refentry id='function.log1p'> - <refnamediv> - <refname>log1p</refname> - <refpurpose> - Returns log(1 + number), computed in a way that is accurate even when - the value of number is close to zero - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>log1p</methodname> - <methodparam><type>float</type><parameter>number</parameter></methodparam> - </methodsynopsis> - &warn.experimental.func; - <para> - <function>log1p</function> returns log(1 + - <parameter>number</parameter>) computed in a way that is accurante even - 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> - </refentry> +<refentry id='function.log1p'> + <refnamediv> + <refname>log1p</refname> + <refpurpose> + Returns log(1 + number), computed in a way that is accurate even when + the value of number is close to zero + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>log1p</methodname> + <methodparam><type>float</type><parameter>number</parameter></methodparam> + </methodsynopsis> + &warn.experimental.func; + <para> + <function>log1p</function> returns log(1 + + <parameter>number</parameter>) computed in a way that is accurante even + 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> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/max.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/math/functions/max.xml diff -u phpdoc/en/reference/math/functions/max.xml:1.7 phpdoc/en/reference/math/functions/max.xml:1.8 --- phpdoc/en/reference/math/functions/max.xml:1.7 Mon Nov 28 16:35:53 2005 +++ phpdoc/en/reference/math/functions/max.xml Sat Mar 31 10:43:52 2007 @@ -1,48 +1,48 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> +<!-- $Revision: 1.8 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.max"> - <refnamediv> - <refname>max</refname> - <refpurpose>Find highest value</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>mixed</type><methodname>max</methodname> - <methodparam><type>number</type><parameter>arg1</parameter></methodparam> - <methodparam><type>number</type><parameter>arg2</parameter></methodparam> - <methodparam choice="opt"><type>number</type><parameter>...</parameter></methodparam> - </methodsynopsis> - <methodsynopsis> - <type>mixed</type><methodname>max</methodname> - <methodparam><type>array</type><parameter>numbers</parameter></methodparam> - </methodsynopsis> - <para> - <function>max</function> returns the numerically highest of the - parameter values. - </para> - <para> - If the first and only parameter is an array, <function>max</function> - returns the highest value in that array. If the first parameter - is an integer, string or float, you need at least two parameters - and <function>max</function> returns the biggest of these values. - You can compare an unlimited number of values. - </para> - <note> - <para> - PHP will evaluate a non-numeric <type>string</type> as - <literal>0</literal>, but still return the string if it's seen as the - numerically highest value. If multiple arguments evaluate to - <literal>0</literal>, <function>max</function> will return a numeric - <literal>0</literal> if given, else the alphabetical highest string - value will be returned. - </para> - </note> - <para> - <example> - <title>Example uses of <function>max</function></title> - <programlisting role="php"> +<refentry id="function.max"> + <refnamediv> + <refname>max</refname> + <refpurpose>Find highest value</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>mixed</type><methodname>max</methodname> + <methodparam><type>number</type><parameter>arg1</parameter></methodparam> + <methodparam><type>number</type><parameter>arg2</parameter></methodparam> + <methodparam choice="opt"><type>number</type><parameter>...</parameter></methodparam> + </methodsynopsis> + <methodsynopsis> + <type>mixed</type><methodname>max</methodname> + <methodparam><type>array</type><parameter>numbers</parameter></methodparam> + </methodsynopsis> + <para> + <function>max</function> returns the numerically highest of the + parameter values. + </para> + <para> + If the first and only parameter is an array, <function>max</function> + returns the highest value in that array. If the first parameter + is an integer, string or float, you need at least two parameters + and <function>max</function> returns the biggest of these values. + You can compare an unlimited number of values. + </para> + <note> + <para> + PHP will evaluate a non-numeric <type>string</type> as + <literal>0</literal>, but still return the string if it's seen as the + numerically highest value. If multiple arguments evaluate to + <literal>0</literal>, <function>max</function> will return a numeric + <literal>0</literal> if given, else the alphabetical highest string + value will be returned. + </para> + </note> + <para> + <example> + <title>Example uses of <function>max</function></title> + <programlisting role="php"> <![CDATA[ <?php echo max(1, 3, 5, 6, 7); // 7 @@ -61,15 +61,15 @@ $val = max('string', array(2, 5, 7), 42); // array(2, 5, 7) ?> ]]> - </programlisting> - </example> - </para> - <para> - See also <function>min</function> and - <function>count</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + See also <function>min</function> and + <function>count</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/min.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/math/functions/min.xml diff -u phpdoc/en/reference/math/functions/min.xml:1.6 phpdoc/en/reference/math/functions/min.xml:1.7 --- phpdoc/en/reference/math/functions/min.xml:1.6 Mon Nov 28 16:35:53 2005 +++ phpdoc/en/reference/math/functions/min.xml Sat Mar 31 10:43:52 2007 @@ -1,48 +1,48 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.min"> - <refnamediv> - <refname>min</refname> - <refpurpose>Find lowest value</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>mixed</type><methodname>min</methodname> - <methodparam><type>number</type><parameter>arg1</parameter></methodparam> - <methodparam><type>number</type><parameter>arg2</parameter></methodparam> - <methodparam choice="opt"><type>number</type><parameter>...</parameter></methodparam> - </methodsynopsis> - <methodsynopsis> - <type>mixed</type><methodname>min</methodname> - <methodparam><type>array</type><parameter>numbers</parameter></methodparam> - </methodsynopsis> - <para> - <function>min</function> returns the numerically lowest of the - parameter values. - </para> - <para> - If the first and only parameter is an array, <function>min</function> - returns the lowest value in that array. If the first parameter - is an integer, string or float, you need at least two parameters - and <function>min</function> returns the smallest of these values. - You can compare an unlimited number of values. - </para> - <note> - <para> - PHP will evaluate a non-numeric <type>string</type> as - <literal>0</literal>, but still return the string if it's seen as the - numerically lowest value. If multiple arguments evaluate to - <literal>0</literal>, <function>min</function> will return the lowest - alphanumerical string value if any strings are given, else a numeric - <literal>0</literal> is returned. - </para> - </note> - <para> - <example> - <title>Example uses of <function>min</function></title> - <programlisting role="php"> +<refentry id="function.min"> + <refnamediv> + <refname>min</refname> + <refpurpose>Find lowest value</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>mixed</type><methodname>min</methodname> + <methodparam><type>number</type><parameter>arg1</parameter></methodparam> + <methodparam><type>number</type><parameter>arg2</parameter></methodparam> + <methodparam choice="opt"><type>number</type><parameter>...</parameter></methodparam> + </methodsynopsis> + <methodsynopsis> + <type>mixed</type><methodname>min</methodname> + <methodparam><type>array</type><parameter>numbers</parameter></methodparam> + </methodsynopsis> + <para> + <function>min</function> returns the numerically lowest of the + parameter values. + </para> + <para> + If the first and only parameter is an array, <function>min</function> + returns the lowest value in that array. If the first parameter + is an integer, string or float, you need at least two parameters + and <function>min</function> returns the smallest of these values. + You can compare an unlimited number of values. + </para> + <note> + <para> + PHP will evaluate a non-numeric <type>string</type> as + <literal>0</literal>, but still return the string if it's seen as the + numerically lowest value. If multiple arguments evaluate to + <literal>0</literal>, <function>min</function> will return the lowest + alphanumerical string value if any strings are given, else a numeric + <literal>0</literal> is returned. + </para> + </note> + <para> + <example> + <title>Example uses of <function>min</function></title> + <programlisting role="php"> <![CDATA[ <?php echo min(2, 3, 1, 6, 7); // 1 @@ -61,15 +61,15 @@ $val = min('string', array(2, 5, 7), 42); // string ?> ]]> - </programlisting> - </example> - </para> - <para> - See also <function>max</function> and - <function>count</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + See also <function>max</function> and + <function>count</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/mt-getrandmax.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/math/functions/mt-getrandmax.xml diff -u phpdoc/en/reference/math/functions/mt-getrandmax.xml:1.4 phpdoc/en/reference/math/functions/mt-getrandmax.xml:1.5 --- phpdoc/en/reference/math/functions/mt-getrandmax.xml:1.4 Wed Mar 10 14:39:13 2004 +++ phpdoc/en/reference/math/functions/mt-getrandmax.xml Sat Mar 31 10:43:52 2007 @@ -1,29 +1,29 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.mt-getrandmax"> - <refnamediv> - <refname>mt_getrandmax</refname> - <refpurpose>Show largest possible random value</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>mt_getrandmax</methodname> - <void/> - </methodsynopsis> - <simpara> - 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> - </refentry> +<refentry id="function.mt-getrandmax"> + <refnamediv> + <refname>mt_getrandmax</refname> + <refpurpose>Show largest possible random value</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>mt_getrandmax</methodname> + <void/> + </methodsynopsis> + <simpara> + 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> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/mt-rand.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc/en/reference/math/functions/mt-rand.xml diff -u phpdoc/en/reference/math/functions/mt-rand.xml:1.10 phpdoc/en/reference/math/functions/mt-rand.xml:1.11 --- phpdoc/en/reference/math/functions/mt-rand.xml:1.10 Fri Mar 11 16:11:50 2005 +++ phpdoc/en/reference/math/functions/mt-rand.xml Sat Mar 31 10:43:52 2007 @@ -1,40 +1,40 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> +<!-- $Revision: 1.11 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.mt-rand"> - <refnamediv> - <refname>mt_rand</refname> - <refpurpose>Generate a better random value</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>mt_rand</methodname> - <methodparam choice="opt"><type>int</type><parameter>min</parameter></methodparam> - <methodparam><type>int</type><parameter>max</parameter></methodparam> - </methodsynopsis> - <simpara> - Many random number generators of older libcs have dubious or - unknown characteristics and are slow. By default, PHP uses the - libc random number generator with the <function>rand</function> - function. The <function>mt_rand</function> function is a drop-in - replacement for this. It uses a random number generator with - known characteristics using the <ulink url="&url.mersenne;"> - Mersenne Twister</ulink>, which will produce random numbers four times - faster than what the average libc rand() provides. - </simpara> - <simpara> - If called without the optional <parameter>min</parameter>, - <parameter>max</parameter> arguments <function>mt_rand</function> - returns a pseudo-random value between 0 and - <constant>RAND_MAX</constant>. If you want a random number - between 5 and 15 (inclusive), for example, use <literal>mt_rand - (5, 15)</literal>. - </simpara> - <para> - <example> - <title><function>mt_rand</function> example</title> - <programlisting role="php"> +<refentry id="function.mt-rand"> + <refnamediv> + <refname>mt_rand</refname> + <refpurpose>Generate a better random value</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>mt_rand</methodname> + <methodparam choice="opt"><type>int</type><parameter>min</parameter></methodparam> + <methodparam><type>int</type><parameter>max</parameter></methodparam> + </methodsynopsis> + <simpara> + Many random number generators of older libcs have dubious or + unknown characteristics and are slow. By default, PHP uses the + libc random number generator with the <function>rand</function> + function. The <function>mt_rand</function> function is a drop-in + replacement for this. It uses a random number generator with + known characteristics using the <ulink url="&url.mersenne;"> + Mersenne Twister</ulink>, which will produce random numbers four times + faster than what the average libc rand() provides. + </simpara> + <simpara> + If called without the optional <parameter>min</parameter>, + <parameter>max</parameter> arguments <function>mt_rand</function> + returns a pseudo-random value between 0 and + <constant>RAND_MAX</constant>. If you want a random number + between 5 and 15 (inclusive), for example, use <literal>mt_rand + (5, 15)</literal>. + </simpara> + <para> + <example> + <title><function>mt_rand</function> example</title> + <programlisting role="php"> <![CDATA[ <?php echo mt_rand() . "\n"; @@ -43,36 +43,36 @@ echo mt_rand(5, 15); ?> ]]> - </programlisting> - &example.outputs.similar; - <screen> + </programlisting> + &example.outputs.similar; + <screen> <![CDATA[ 1604716014 1478613278 6 ]]> - </screen> - </example> - </para> - &note.randomseed; + </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> - </refentry> + <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> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/mt-srand.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/math/functions/mt-srand.xml diff -u phpdoc/en/reference/math/functions/mt-srand.xml:1.8 phpdoc/en/reference/math/functions/mt-srand.xml:1.9 --- phpdoc/en/reference/math/functions/mt-srand.xml:1.8 Wed Mar 10 14:39:13 2004 +++ phpdoc/en/reference/math/functions/mt-srand.xml Sat Mar 31 10:43:52 2007 @@ -1,53 +1,53 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.mt-srand"> - <refnamediv> - <refname>mt_srand</refname> - <refpurpose>Seed the better random number generator</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>void</type><methodname>mt_srand</methodname> - <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>mt_srand</function> example</title> - <programlisting role="php"> +<refentry id="function.mt-srand"> + <refnamediv> + <refname>mt_srand</refname> + <refpurpose>Seed the better random number generator</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>void</type><methodname>mt_srand</methodname> + <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>mt_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); + list($usec, $sec) = explode(' ', microtime()); + return (float) $sec + ((float) $usec * 100000); } mt_srand(make_seed()); $randval = mt_rand(); ?> ]]> - </programlisting> - </example> - </para> + </programlisting> + </example> + </para> - &note.randomseed; + &note.randomseed; - <simpara> - See also: - <function>mt_rand</function>, - <function>mt_getrandmax</function>, and - <function>srand</function>. - </simpara> - </refsect1> - </refentry> + <simpara> + See also: + <function>mt_rand</function>, + <function>mt_getrandmax</function>, and + <function>srand</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/octdec.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/math/functions/octdec.xml diff -u phpdoc/en/reference/math/functions/octdec.xml:1.8 phpdoc/en/reference/math/functions/octdec.xml:1.9 --- phpdoc/en/reference/math/functions/octdec.xml:1.8 Fri Mar 11 16:11:50 2005 +++ phpdoc/en/reference/math/functions/octdec.xml Sat Mar 31 10:43:52 2007 @@ -1,54 +1,54 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.octdec"> - <refnamediv> - <refname>octdec</refname> - <refpurpose>Octal to decimal</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>number</type><methodname>octdec</methodname> - <methodparam><type>string</type><parameter>octal_string</parameter></methodparam> - </methodsynopsis> - <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> - <para> - <example> - <title><function>octdec</function> example</title> - <programlisting role="php"> +<refentry id="function.octdec"> + <refnamediv> + <refname>octdec</refname> + <refpurpose>Octal to decimal</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>number</type><methodname>octdec</methodname> + <methodparam><type>string</type><parameter>octal_string</parameter></methodparam> + </methodsynopsis> + <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> + <para> + <example> + <title><function>octdec</function> example</title> + <programlisting role="php"> <![CDATA[ <?php echo octdec('77') . "\n"; echo octdec(decoct(45)); ?> ]]> - </programlisting> - &example.outputs; - <screen> + </programlisting> + &example.outputs; + <screen> <![CDATA[ 63 45 ]]> - </screen> - </example> - </para> - <para> - See also: - <function>decoct</function>, - <function>bindec</function>, - <function>hexdec</function>, and - <function>base_convert</function>. - </para> - </refsect1> - </refentry> + </screen> + </example> + </para> + <para> + See also: + <function>decoct</function>, + <function>bindec</function>, + <function>hexdec</function>, and + <function>base_convert</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/pi.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/math/functions/pi.xml diff -u phpdoc/en/reference/math/functions/pi.xml:1.5 phpdoc/en/reference/math/functions/pi.xml:1.6 --- phpdoc/en/reference/math/functions/pi.xml:1.5 Wed Mar 10 14:39:13 2004 +++ phpdoc/en/reference/math/functions/pi.xml Sat Mar 31 10:43:52 2007 @@ -1,40 +1,40 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.pi"> - <refnamediv> - <refname>pi</refname> - <refpurpose>Get value of pi</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>pi</methodname> - <void/> - </methodsynopsis> - <simpara> - Returns an approximation of pi. The returned <type>float</type> - has a precision based on the - <link linkend="ini.precision">precision</link> directive in - &php.ini;, which defaults to <literal>14</literal>. - Also, you can use the <constant>M_PI</constant> constant which yields - identical results to <function>pi</function>. - </simpara> - <para> - <example> - <title><function>pi</function> example</title> - <programlisting role="php"> +<refentry id="function.pi"> + <refnamediv> + <refname>pi</refname> + <refpurpose>Get value of pi</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>pi</methodname> + <void/> + </methodsynopsis> + <simpara> + Returns an approximation of pi. The returned <type>float</type> + has a precision based on the + <link linkend="ini.precision">precision</link> directive in + &php.ini;, which defaults to <literal>14</literal>. + Also, you can use the <constant>M_PI</constant> constant which yields + identical results to <function>pi</function>. + </simpara> + <para> + <example> + <title><function>pi</function> example</title> + <programlisting role="php"> <![CDATA[ <?php echo pi(); // 3.1415926535898 echo M_PI; // 3.1415926535898 ?> ]]> - </programlisting> - </example> - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/pow.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/math/functions/pow.xml diff -u phpdoc/en/reference/math/functions/pow.xml:1.8 phpdoc/en/reference/math/functions/pow.xml:1.9 --- phpdoc/en/reference/math/functions/pow.xml:1.8 Fri Mar 23 15:13:40 2007 +++ phpdoc/en/reference/math/functions/pow.xml Sat Mar 31 10:43:52 2007 @@ -1,36 +1,36 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.pow"> - <refnamediv> - <refname>pow</refname> - <refpurpose>Exponential expression</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>number</type><methodname>pow</methodname> - <methodparam><type>number</type><parameter>base</parameter></methodparam> - <methodparam><type>number</type><parameter>exp</parameter></methodparam> - </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. - </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"> +<refentry id="function.pow"> + <refnamediv> + <refname>pow</refname> + <refpurpose>Exponential expression</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>number</type><methodname>pow</methodname> + <methodparam><type>number</type><parameter>base</parameter></methodparam> + <methodparam><type>number</type><parameter>exp</parameter></methodparam> + </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. + </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"> <![CDATA[ <?php @@ -42,23 +42,23 @@ ?> ]]> - </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> - </refentry> + </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> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/rad2deg.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/math/functions/rad2deg.xml diff -u phpdoc/en/reference/math/functions/rad2deg.xml:1.3 phpdoc/en/reference/math/functions/rad2deg.xml:1.4 --- phpdoc/en/reference/math/functions/rad2deg.xml:1.3 Tue Oct 21 11:48:57 2003 +++ phpdoc/en/reference/math/functions/rad2deg.xml Sat Mar 31 10:43:52 2007 @@ -1,27 +1,27 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.8 --> - <refentry id="function.rad2deg"> - <refnamediv> - <refname>rad2deg</refname> - <refpurpose> - Converts the radian number to the equivalent number in degrees - </refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>rad2deg</methodname> - <methodparam><type>float</type><parameter>number</parameter></methodparam> - </methodsynopsis> - <para> - This function converts <parameter>number</parameter> from radian - to degrees. - </para> - <para> - <example> - <title><function>rad2deg</function> example</title> - <programlisting role="php"> +<refentry id="function.rad2deg"> + <refnamediv> + <refname>rad2deg</refname> + <refpurpose> + Converts the radian number to the equivalent number in degrees + </refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>rad2deg</methodname> + <methodparam><type>float</type><parameter>number</parameter></methodparam> + </methodsynopsis> + <para> + This function converts <parameter>number</parameter> from radian + to degrees. + </para> + <para> + <example> + <title><function>rad2deg</function> example</title> + <programlisting role="php"> <![CDATA[ <?php @@ -29,14 +29,14 @@ ?> ]]> - </programlisting> - </example> - </para> - <para> - See also <function>deg2rad</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + See also <function>deg2rad</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/rand.xml?r1=1.15&r2=1.16&diff_format=u Index: phpdoc/en/reference/math/functions/rand.xml diff -u phpdoc/en/reference/math/functions/rand.xml:1.15 phpdoc/en/reference/math/functions/rand.xml:1.16 --- phpdoc/en/reference/math/functions/rand.xml:1.15 Fri Mar 11 16:11:50 2005 +++ phpdoc/en/reference/math/functions/rand.xml Sat Mar 31 10:43:52 2007 @@ -1,30 +1,30 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.15 $ --> +<!-- $Revision: 1.16 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.rand"> - <refnamediv> - <refname>rand</refname> - <refpurpose>Generate a random integer</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>int</type><methodname>rand</methodname> - <methodparam choice="opt"><type>int</type><parameter>min</parameter></methodparam> - <methodparam><type>int</type><parameter>max</parameter></methodparam> - </methodsynopsis> - <simpara> - If called without the optional <parameter>min</parameter>, - <parameter>max</parameter> arguments <function>rand</function> - returns a pseudo-random integer between 0 and - <constant>RAND_MAX</constant>. If you want a random number - between 5 and 15 (inclusive), for example, use <literal>rand (5, - 15)</literal>. - </simpara> - <para> - <example> - <title><function>rand</function> example</title> - <programlisting role="php"> +<refentry id="function.rand"> + <refnamediv> + <refname>rand</refname> + <refpurpose>Generate a random integer</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>int</type><methodname>rand</methodname> + <methodparam choice="opt"><type>int</type><parameter>min</parameter></methodparam> + <methodparam><type>int</type><parameter>max</parameter></methodparam> + </methodsynopsis> + <simpara> + If called without the optional <parameter>min</parameter>, + <parameter>max</parameter> arguments <function>rand</function> + returns a pseudo-random integer between 0 and + <constant>RAND_MAX</constant>. If you want a random number + between 5 and 15 (inclusive), for example, use <literal>rand (5, + 15)</literal>. + </simpara> + <para> + <example> + <title><function>rand</function> example</title> + <programlisting role="php"> <![CDATA[ <?php echo rand() . "\n"; @@ -33,46 +33,46 @@ echo rand(5, 15); ?> ]]> - </programlisting> - &example.outputs.similar; - <screen> + </programlisting> + &example.outputs.similar; + <screen> <![CDATA[ 7771 22264 11 ]]> - </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> + </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.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> - </refentry> + <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> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/round.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/math/functions/round.xml diff -u phpdoc/en/reference/math/functions/round.xml:1.9 phpdoc/en/reference/math/functions/round.xml:1.10 --- phpdoc/en/reference/math/functions/round.xml:1.9 Fri Jul 23 00:18:22 2004 +++ phpdoc/en/reference/math/functions/round.xml Sat Mar 31 10:43:52 2007 @@ -1,28 +1,28 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> +<!-- $Revision: 1.10 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.round"> - <refnamediv> - <refname>round</refname> - <refpurpose>Rounds a float</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>round</methodname> - <methodparam><type>float</type><parameter>val</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>precision</parameter></methodparam> - </methodsynopsis> - <para> - Returns the rounded value of <parameter>val</parameter> to - specified <parameter>precision</parameter> - (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"> +<refentry id="function.round"> + <refnamediv> + <refname>round</refname> + <refpurpose>Rounds a float</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>round</methodname> + <methodparam><type>float</type><parameter>val</parameter></methodparam> + <methodparam choice="opt"><type>int</type><parameter>precision</parameter></methodparam> + </methodsynopsis> + <para> + Returns the rounded value of <parameter>val</parameter> to + specified <parameter>precision</parameter> + (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 @@ -35,50 +35,50 @@ echo round(5.055, 2); // 5.06 ?> ]]> - </programlisting> - </example> - </para> - <!-- It's not true - <para> - <caution> - <simpara> - When rounding on exact halves <function>round</function> rounds down on - evens and up on odds. If you want to always force it in one direction - on a .5 (or .05 in your case) add or substract a tiny fuzz factor. The - reason behind rounding half the values down and the other half up is to - avoid the classical banking problem where if you always rounded down - you would be stealing money from your customers, or if you always - rounded up you would end up over time losing money. By averaging it - out through evens and odds you statistically break even. - </simpara> - </caution> - </para> - --> - <para> - <note> - <simpara> - PHP doesn't handle strings like <literal>"12,300.2"</literal> correctly - by default. See <link linkend="language.types.string.conversion" - >converting from strings</link>. - </simpara> - </note> - </para> - <para> - <note> - <simpara> - The <parameter>precision</parameter> parameter was introduced - in PHP 4. - </simpara> - </note> - </para> + </programlisting> + </example> + </para> + <!-- It's not true + <para> + <caution> <simpara> - See also: - <function>ceil</function>, - <function>floor</function>, and - <function>number_format</function>. + When rounding on exact halves <function>round</function> rounds down on + evens and up on odds. If you want to always force it in one direction + on a .5 (or .05 in your case) add or substract a tiny fuzz factor. The + reason behind rounding half the values down and the other half up is to + avoid the classical banking problem where if you always rounded down + you would be stealing money from your customers, or if you always + rounded up you would end up over time losing money. By averaging it + out through evens and odds you statistically break even. </simpara> - </refsect1> - </refentry> + </caution> + </para> + --> + <para> + <note> + <simpara> + PHP doesn't handle strings like <literal>"12,300.2"</literal> correctly + by default. See <link linkend="language.types.string.conversion" + >converting from strings</link>. + </simpara> + </note> + </para> + <para> + <note> + <simpara> + The <parameter>precision</parameter> parameter was introduced + in PHP 4. + </simpara> + </note> + </para> + <simpara> + See also: + <function>ceil</function>, + <function>floor</function>, and + <function>number_format</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/sin.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/math/functions/sin.xml diff -u phpdoc/en/reference/math/functions/sin.xml:1.7 phpdoc/en/reference/math/functions/sin.xml:1.8 --- phpdoc/en/reference/math/functions/sin.xml:1.7 Wed Mar 10 14:39:13 2004 +++ phpdoc/en/reference/math/functions/sin.xml Sat Mar 31 10:43:52 2007 @@ -1,25 +1,25 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> +<!-- $Revision: 1.8 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.sin"> - <refnamediv> - <refname>sin</refname> - <refpurpose>Sine</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>sin</methodname> - <methodparam><type>float</type><parameter>arg</parameter></methodparam> - </methodsynopsis> - <para> - <function>sin</function> returns the sine of the <parameter>arg</parameter> - parameter. The <parameter>arg</parameter> parameter is in radians. - </para> - <para> - <example> - <title><function>sin</function> example</title> - <programlisting role="php"> +<refentry id="function.sin"> + <refnamediv> + <refname>sin</refname> + <refpurpose>Sine</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>sin</methodname> + <methodparam><type>float</type><parameter>arg</parameter></methodparam> + </methodsynopsis> + <para> + <function>sin</function> returns the sine of the <parameter>arg</parameter> + parameter. The <parameter>arg</parameter> parameter is in radians. + </para> + <para> + <example> + <title><function>sin</function> example</title> + <programlisting role="php"> <![CDATA[ <?php @@ -29,18 +29,18 @@ ?> ]]> - </programlisting> - </example> - </para> - <para> - See also: - <function>asin</function>, - <function>cos</function>, - <function>tan</function>, and - <function>deg2rad</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + See also: + <function>asin</function>, + <function>cos</function>, + <function>tan</function>, and + <function>deg2rad</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/sinh.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/math/functions/sinh.xml diff -u phpdoc/en/reference/math/functions/sinh.xml:1.3 phpdoc/en/reference/math/functions/sinh.xml:1.4 --- phpdoc/en/reference/math/functions/sinh.xml:1.3 Wed Mar 10 14:39:13 2004 +++ phpdoc/en/reference/math/functions/sinh.xml Sat Mar 31 10:43:52 2007 @@ -1,30 +1,30 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.57 --> - <refentry id="function.sinh"> - <refnamediv> - <refname>sinh</refname> - <refpurpose>Hyperbolic sine</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>sinh</methodname> - <methodparam><type>float</type><parameter>arg</parameter></methodparam> - </methodsynopsis> - <para> - 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> - </refentry> +<refentry id="function.sinh"> + <refnamediv> + <refname>sinh</refname> + <refpurpose>Hyperbolic sine</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>sinh</methodname> + <methodparam><type>float</type><parameter>arg</parameter></methodparam> + </methodsynopsis> + <para> + 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> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/sqrt.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/math/functions/sqrt.xml diff -u phpdoc/en/reference/math/functions/sqrt.xml:1.5 phpdoc/en/reference/math/functions/sqrt.xml:1.6 --- phpdoc/en/reference/math/functions/sqrt.xml:1.5 Wed Mar 10 14:39:13 2004 +++ phpdoc/en/reference/math/functions/sqrt.xml Sat Mar 31 10:43:52 2007 @@ -1,24 +1,24 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.sqrt"> - <refnamediv> - <refname>sqrt</refname> - <refpurpose>Square root</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>sqrt</methodname> - <methodparam><type>float</type><parameter>arg</parameter></methodparam> - </methodsynopsis> - <para> - Returns the square root of <parameter>arg</parameter>. - </para> - <para> - <example> - <title><function>sqrt</function> example</title> - <programlisting role="php"> +<refentry id="function.sqrt"> + <refnamediv> + <refname>sqrt</refname> + <refpurpose>Square root</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>sqrt</methodname> + <methodparam><type>float</type><parameter>arg</parameter></methodparam> + </methodsynopsis> + <para> + Returns the square root of <parameter>arg</parameter>. + </para> + <para> + <example> + <title><function>sqrt</function> example</title> + <programlisting role="php"> <![CDATA[ <?php // Precision depends on your precision directive @@ -26,14 +26,14 @@ echo sqrt(10); // 3.16227766 ... ?> ]]> - </programlisting> - </example> - </para> - <para> - See also <function>pow</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + See also <function>pow</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/srand.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/math/functions/srand.xml diff -u phpdoc/en/reference/math/functions/srand.xml:1.8 phpdoc/en/reference/math/functions/srand.xml:1.9 --- phpdoc/en/reference/math/functions/srand.xml:1.8 Wed Mar 10 14:39:13 2004 +++ phpdoc/en/reference/math/functions/srand.xml Sat Mar 31 10:43:52 2007 @@ -1,52 +1,52 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.srand"> - <refnamediv> - <refname>srand</refname> - <refpurpose>Seed the random number generator</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>void</type><methodname>srand</methodname> - <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"> +<refentry id="function.srand"> + <refnamediv> + <refname>srand</refname> + <refpurpose>Seed the random number generator</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>void</type><methodname>srand</methodname> + <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); + list($usec, $sec) = explode(' ', microtime()); + return (float) $sec + ((float) $usec * 100000); } srand(make_seed()); $randval = rand(); ?> ]]> - </programlisting> - </example> - </para> + </programlisting> + </example> + </para> - &note.randomseed; + &note.randomseed; - <simpara> - See also: - <function>rand</function>, - <function>getrandmax</function>, and - <function>mt_srand</function>. - </simpara> - </refsect1> - </refentry> + <simpara> + See also: + <function>rand</function>, + <function>getrandmax</function>, and + <function>mt_srand</function>. + </simpara> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/tan.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/math/functions/tan.xml diff -u phpdoc/en/reference/math/functions/tan.xml:1.6 phpdoc/en/reference/math/functions/tan.xml:1.7 --- phpdoc/en/reference/math/functions/tan.xml:1.6 Wed Dec 22 01:16:39 2004 +++ phpdoc/en/reference/math/functions/tan.xml Sat Mar 31 10:43:52 2007 @@ -1,25 +1,25 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.57 --> - <refentry id="function.tan"> - <refnamediv> - <refname>tan</refname> - <refpurpose>Tangent</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>tan</methodname> - <methodparam><type>float</type><parameter>arg</parameter></methodparam> - </methodsynopsis> - <para> - <function>tan</function> returns the tangent of the <parameter>arg</parameter> - parameter. The <parameter>arg</parameter> parameter is in radians. - </para> - <para> - <example> - <title><function>tan</function> example</title> - <programlisting role="php"> +<refentry id="function.tan"> + <refnamediv> + <refname>tan</refname> + <refpurpose>Tangent</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>tan</methodname> + <methodparam><type>float</type><parameter>arg</parameter></methodparam> + </methodsynopsis> + <para> + <function>tan</function> returns the tangent of the <parameter>arg</parameter> + parameter. The <parameter>arg</parameter> parameter is in radians. + </para> + <para> + <example> + <title><function>tan</function> example</title> + <programlisting role="php"> <![CDATA[ <?php @@ -27,18 +27,18 @@ ?> ]]> - </programlisting> - </example> - </para> - <para> - See also: - <function>atan</function>, - <function>sin</function>, - <function>cos</function>, and - <function>deg2rad</function>. - </para> - </refsect1> - </refentry> + </programlisting> + </example> + </para> + <para> + See also: + <function>atan</function>, + <function>sin</function>, + <function>cos</function>, and + <function>deg2rad</function>. + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/tanh.xml?r1=1.3&r2=1.4&diff_format=u Index: phpdoc/en/reference/math/functions/tanh.xml diff -u phpdoc/en/reference/math/functions/tanh.xml:1.3 phpdoc/en/reference/math/functions/tanh.xml:1.4 --- phpdoc/en/reference/math/functions/tanh.xml:1.3 Wed Mar 10 14:39:13 2004 +++ phpdoc/en/reference/math/functions/tanh.xml Sat Mar 31 10:43:52 2007 @@ -1,30 +1,30 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.3 $ --> +<!-- $Revision: 1.4 $ --> <!-- splitted from ./en/functions/math.xml, last change in rev 1.2 --> - <refentry id="function.tanh"> - <refnamediv> - <refname>tanh</refname> - <refpurpose>Hyperbolic tangent</refpurpose> - </refnamediv> - <refsect1> - <title>Description</title> - <methodsynopsis> - <type>float</type><methodname>tanh</methodname> - <methodparam><type>float</type><parameter>arg</parameter></methodparam> - </methodsynopsis> - <para> - 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> - </refentry> +<refentry id="function.tanh"> + <refnamediv> + <refname>tanh</refname> + <refpurpose>Hyperbolic tangent</refpurpose> + </refnamediv> + <refsect1> + <title>Description</title> + <methodsynopsis> + <type>float</type><methodname>tanh</methodname> + <methodparam><type>float</type><parameter>arg</parameter></methodparam> + </methodsynopsis> + <para> + 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> +</refentry> <!-- Keep this comment at the end of the file Local variables: