cvs: phpdoc /en/reference/math/functions abs.xml acos.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 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 19:18:23 2007 UTC Modified files: /phpdoc/en/reference/math/functions abs.xml acos.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 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: conversion to new format finished

http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/abs.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/math/functions/abs.xml diff -u phpdoc/en/reference/math/functions/abs.xml:1.7 phpdoc/en/reference/math/functions/abs.xml:1.8 --- phpdoc/en/reference/math/functions/abs.xml:1.7 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/abs.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> +<!-- $Revision: 1.8 $ --> <refentry id="function.abs"> <refnamediv> <refname>abs</refname> @@ -12,11 +12,7 @@ <methodparam><type>mixed</type><parameter>number</parameter></methodparam> </methodsynopsis> <para> - Returns the absolute value of <parameter>number</parameter>. If the - argument <parameter>number</parameter> is - of type <type>float</type>, the return type is also <type>float</type>, - otherwise it is <type>integer</type> (as <type>float</type> usually has a - bigger value range than <type>integer</type>). + Returns the absolute value of <parameter>number</parameter>. </para> </refsect1> <refsect1 role="parameters"> @@ -37,7 +33,11 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - The absoulte value of <parameter>number</parameter> + The absoulte value of <parameter>number</parameter>. If the + argument <parameter>number</parameter> is + of type <type>float</type>, the return type is also <type>float</type>, + otherwise it is <type>integer</type> (as <type>float</type> usually has a + bigger value range than <type>integer</type>). </para> </refsect1> <refsect1 role="examples"> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/acos.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/math/functions/acos.xml diff -u phpdoc/en/reference/math/functions/acos.xml:1.6 phpdoc/en/reference/math/functions/acos.xml:1.7 --- phpdoc/en/reference/math/functions/acos.xml:1.6 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/acos.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <refentry id="function.acos"> <refnamediv> <refname>acos</refname> @@ -37,7 +37,7 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - The arc consine of <parameter>arg</parameter> + The arc consine of <parameter>arg</parameter> in radians. </para> </refsect1> <refsect1 role="seealso"> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/asin.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/math/functions/asin.xml diff -u phpdoc/en/reference/math/functions/asin.xml:1.6 phpdoc/en/reference/math/functions/asin.xml:1.7 --- phpdoc/en/reference/math/functions/asin.xml:1.6 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/asin.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <refentry id="function.asin"> <refnamediv> <refname>asin</refname> @@ -37,7 +37,7 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - The arc sine of <parameter>arg</parameter> + The arc sine of <parameter>arg</parameter> in radians </para> </refsect1> <refsect1 role="seealso"> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/asinh.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/math/functions/asinh.xml diff -u phpdoc/en/reference/math/functions/asinh.xml:1.6 phpdoc/en/reference/math/functions/asinh.xml:1.7 --- phpdoc/en/reference/math/functions/asinh.xml:1.6 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/asinh.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <refentry id="function.asinh"> <refnamediv> <refname>asinh</refname> @@ -17,22 +17,16 @@ hyperbolic sine is <parameter>arg</parameter>. </para> &note.no-windows; - <para> - See also: - <function>asin</function>, - <function>acosh</function>, and - <function>atanh</function>. - </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>arg</parameter></term> <listitem> <para> - + The argument to process </para> </listitem> </varlistentry> @@ -42,20 +36,17 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - + The inverse hyperbolic sine of <parameter>arg</parameter> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>sinh</function></member> + <member><function>asin</function></member> + <member><function>acosh</function></member> + <member><function>atanh</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/atan.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/math/functions/atan.xml diff -u phpdoc/en/reference/math/functions/atan.xml:1.6 phpdoc/en/reference/math/functions/atan.xml:1.7 --- phpdoc/en/reference/math/functions/atan.xml:1.6 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/atan.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <refentry id="function.atan"> <refnamediv> <refname>atan</refname> @@ -18,22 +18,16 @@ <literal>a==tan(atan(a))</literal> for every value of a that is within <function>atan</function>'s range. </para> - <para> - See also: - <function>atanh</function>, - <function>asin</function>, and - <function>acos</function>. - </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>arg</parameter></term> <listitem> <para> - + The argument to process </para> </listitem> </varlistentry> @@ -43,20 +37,17 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - + The arc tangent of <parameter>arg</parameter> in radians. </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>tan</function></member> + <member><function>atanh</function></member> + <member><function>asin</function></member> + <member><function>acos</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/atan2.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/math/functions/atan2.xml diff -u phpdoc/en/reference/math/functions/atan2.xml:1.5 phpdoc/en/reference/math/functions/atan2.xml:1.6 --- phpdoc/en/reference/math/functions/atan2.xml:1.5 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/atan2.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <refentry id="function.atan2"> <refnamediv> <refname>atan2</refname> @@ -24,19 +24,24 @@ The function returns the result in radians, which is between -PI and PI (inclusive). </simpara> - <para> - See also <function>acos</function> and <function>atan</function>. - </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>x</parameter></term> <listitem> <para> - + Dividend parameter + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>y</parameter></term> + <listitem> + <para> + Divisor parameter </para> </listitem> </varlistentry> @@ -46,20 +51,15 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - + The arg tangent of <parameter>x</parameter>/<parameter>y</parameter> + in radians. </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>atan</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/atanh.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/math/functions/atanh.xml diff -u phpdoc/en/reference/math/functions/atanh.xml:1.6 phpdoc/en/reference/math/functions/atanh.xml:1.7 --- phpdoc/en/reference/math/functions/atanh.xml:1.6 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/atanh.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <refentry id="function.atanh"> <refnamediv> <refname>atanh</refname> @@ -29,10 +29,10 @@ <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>arg</parameter></term> <listitem> <para> - + The argument to process </para> </listitem> </varlistentry> @@ -42,20 +42,17 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - + Inverse hyperbolic tangent of <parameter>arg</parameter> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>tanh</function></member> + <member><function>atan </function></member> + <member><function>asinh</function></member> + <member><function>acosh</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/base-convert.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/math/functions/base-convert.xml diff -u phpdoc/en/reference/math/functions/base-convert.xml:1.8 phpdoc/en/reference/math/functions/base-convert.xml:1.9 --- phpdoc/en/reference/math/functions/base-convert.xml:1.8 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/base-convert.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <refentry id="function.base-convert"> <refnamediv> <refname>base_convert</refname> @@ -22,25 +22,6 @@ 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> -<![CDATA[ -101000110111001100110100 -]]> - </screen> - </example> </para> <warning> <simpara> @@ -50,19 +31,32 @@ section in the manual for more specific information and limitations. </simpara> </warning> - <para> - See also: <function>intval</function>. - </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>number</parameter></term> <listitem> <para> - + The number to convert + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>frombase</parameter></term> + <listitem> + <para> + The base <parameter>number</parameter> is in + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>tobase</parameter></term> + <listitem> + <para> + The base to convert <parameter>number</parameter> to </para> </listitem> </varlistentry> @@ -72,20 +66,38 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - + <parameter>number</parameter> converted to base <parameter>tobase</parameter> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> - + <example> + <title><function>base_convert</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php +$hexadecimal = 'A37334'; +echo base_convert($hexadecimal, 16, 2); +?> +]]> + </programlisting> + <para> + Outputs: + </para> + <screen> +<![CDATA[ +101000110111001100110100 +]]> + </screen> + </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>intval</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/bindec.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc/en/reference/math/functions/bindec.xml diff -u phpdoc/en/reference/math/functions/bindec.xml:1.10 phpdoc/en/reference/math/functions/bindec.xml:1.11 --- phpdoc/en/reference/math/functions/bindec.xml:1.10 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/bindec.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> +<!-- $Revision: 1.11 $ --> <refentry id="function.bindec"> <refnamediv> <refname>bindec</refname> @@ -17,39 +17,7 @@ </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"; -echo bindec('000110011') . "\n"; - -echo bindec('111'); -?> -]]> - </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>. + <type>integer</type> or, if needed for size reasons, <type>float</type>. </para> </refsect1> <refsect1 role="parameters"> @@ -57,10 +25,10 @@ <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>binary_string</parameter></term> <listitem> <para> - + The binary string to convert </para> </listitem> </varlistentry> @@ -70,20 +38,68 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - + The decimal value of <parameter>binary_string</parameter> + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Since 4.1.0</entry> + <entry> + The function can now convert numbers that are too large to + fit into the platforms <type>integer</type> type, larger values + are returned as <type>float</type> in that case. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> + <example> + <title><function>bindec</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo bindec('110011') . "\n"; +echo bindec('000110011') . "\n"; +echo bindec('111'); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +51 +51 +7 +]]> + </screen> + </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>decbin</function></member> + <member><function>octdec</function></member> + <member><function>hexdec</function></member> + <member><function>base_convert</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/ceil.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/math/functions/ceil.xml diff -u phpdoc/en/reference/math/functions/ceil.xml:1.8 phpdoc/en/reference/math/functions/ceil.xml:1.9 --- phpdoc/en/reference/math/functions/ceil.xml:1.8 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/ceil.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <refentry id="function.ceil"> <refnamediv> <refname>ceil</refname> @@ -14,9 +14,6 @@ <simpara> Returns the next highest integer value by rounding up <parameter>value</parameter> if necessary. - The return value of <function>ceil</function> is still of type - <type>float</type> as the value range of <type>float</type> is - usually bigger than that of <type>integer</type>. </simpara> <para> <example> @@ -32,20 +29,16 @@ </programlisting> </example> </para> - <simpara> - See also <function>floor</function> and - <function>round</function>. - </simpara> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>value</parameter></term> <listitem> <para> - + The value to round </para> </listitem> </varlistentry> @@ -55,7 +48,11 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - + <parameter>value</parameter> rounded up to the next highest + integer. + The return value of <function>ceil</function> is still of type + <type>float</type> as the value range of <type>float</type> is + usually bigger than that of <type>integer</type>. </para> </refsect1> <refsect1 role="examples"> @@ -68,7 +65,8 @@ &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>floor</function></member> + <member><function>round</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/cos.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/math/functions/cos.xml diff -u phpdoc/en/reference/math/functions/cos.xml:1.7 phpdoc/en/reference/math/functions/cos.xml:1.8 --- phpdoc/en/reference/math/functions/cos.xml:1.7 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/cos.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> +<!-- $Revision: 1.8 $ --> <refentry id="function.cos"> <refnamediv> <refname>cos</refname> @@ -15,37 +15,16 @@ <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 - -echo cos(M_PI); // -1 - -?> -]]> - </programlisting> - </example> - </para> - <para> - See also: - <function>acos</function>, - <function>sin</function>, - <function>tan</function>, and - <function>deg2rad</function>. - </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>arg</parameter></term> <listitem> <para> - + An angle in radians </para> </listitem> </varlistentry> @@ -55,20 +34,34 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - + The cosine of <parameter>arg</parameter> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> + <example> + <title><function>cos</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php + +echo cos(M_PI); // -1 +?> +]]> + </programlisting> + </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>acos</function></member> + <member><function>sin</function></member> + <member><function>tan</function></member> + <member><function>deg2rad</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/cosh.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/math/functions/cosh.xml diff -u phpdoc/en/reference/math/functions/cosh.xml:1.5 phpdoc/en/reference/math/functions/cosh.xml:1.6 --- phpdoc/en/reference/math/functions/cosh.xml:1.5 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/cosh.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <refentry id="function.cosh"> <refnamediv> <refname>cosh</refname> @@ -15,23 +15,16 @@ Returns the hyperbolic cosine of <parameter>arg</parameter>, defined as <literal>(exp(arg) + exp(-arg))/2</literal>. </para> - <para> - See also: - <function>cos</function>, - <function>acosh</function>, - <function>sin</function>, and - <function>tan</function>. - </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>arg</parameter></term> <listitem> <para> - + The argument to process </para> </listitem> </varlistentry> @@ -41,20 +34,17 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - + The hyperbolic cosine of <parameter>arg</parameter> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>cos</function></member> + <member><function>acosh</function></member> + <member><function>sinh</function></member> + <member><function>cosh</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/decbin.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc/en/reference/math/functions/decbin.xml diff -u phpdoc/en/reference/math/functions/decbin.xml:1.10 phpdoc/en/reference/math/functions/decbin.xml:1.11 --- phpdoc/en/reference/math/functions/decbin.xml:1.10 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/decbin.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> +<!-- $Revision: 1.11 $ --> <refentry id="function.decbin"> <refnamediv> <refname>decbin</refname> @@ -16,42 +16,16 @@ <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> -<![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> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>number</parameter></term> <listitem> <para> - + Decimal value to convert </para> </listitem> </varlistentry> @@ -61,20 +35,40 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - + Binary string representation of <parameter>number</parameter> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> - + <example> + <title><function>decbin</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo decbin(12) . "\n"; +echo decbin(26); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +1100 +11010 +]]> + </screen> + </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>bindec</function></member> + <member><function>decoct</function></member> + <member><function>dechex</function></member> + <member><function>base_convert</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/dechex.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/math/functions/dechex.xml diff -u phpdoc/en/reference/math/functions/dechex.xml:1.9 phpdoc/en/reference/math/functions/dechex.xml:1.10 --- phpdoc/en/reference/math/functions/dechex.xml:1.9 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/dechex.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> +<!-- $Revision: 1.10 $ --> <refentry id="function.dechex"> <refnamediv> <refname>dechex</refname> @@ -16,42 +16,16 @@ 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> -<![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> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>number</parameter></term> <listitem> <para> - + Decimal value to convert </para> </listitem> </varlistentry> @@ -61,20 +35,40 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - + Hexadecimal string representation of <parameter>number</parameter> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> - + <example> + <title><function>dechex</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo dechex(10) . "\n"; +echo dechex(47); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +a +2f +]]> + </screen> + </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>hexdec</function></member> + <member><function>decbin</function></member> + <member><function>decoct</function></member> + <member><function>base_convert</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/decoct.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/math/functions/decoct.xml diff -u phpdoc/en/reference/math/functions/decoct.xml:1.9 phpdoc/en/reference/math/functions/decoct.xml:1.10 --- phpdoc/en/reference/math/functions/decoct.xml:1.9 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/decoct.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> +<!-- $Revision: 1.10 $ --> <refentry id="function.decoct"> <refnamediv> <refname>decoct</refname> @@ -16,42 +16,16 @@ <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> -<![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> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter></parameter></term> <listitem> <para> - + Decimal value to convert </para> </listitem> </varlistentry> @@ -61,20 +35,40 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - + Octal string representation of <parameter>number</parameter> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> - + <example> + <title><function>decoct</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo decoct(15) . "\n"; +echo decoct(264); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +17 +410 +]]> + </screen> + </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>octdec</function></member> + <member><function>decbin</function></member> + <member><function>dechex</function></member> + <member><function>base_convert</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/deg2rad.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/math/functions/deg2rad.xml diff -u phpdoc/en/reference/math/functions/deg2rad.xml:1.5 phpdoc/en/reference/math/functions/deg2rad.xml:1.6 --- phpdoc/en/reference/math/functions/deg2rad.xml:1.5 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/deg2rad.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <refentry id="function.deg2rad"> <refnamediv> <refname>deg2rad</refname> @@ -17,34 +17,16 @@ 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 - -echo deg2rad(45); // 0.785398163397 -var_dump(deg2rad(45) === M_PI_4); // bool(true) - -?> -]]> - </programlisting> - </example> - </para> - <para> - See also <function>rad2deg</function>. - </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>number</parameter></term> <listitem> <para> - + Angular value in degrees </para> </listitem> </varlistentry> @@ -54,20 +36,32 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - + The radian equivalent of <parameter>number</parameter> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> + <example> + <title><function>deg2rad</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo deg2rad(45); // 0.785398163397 +var_dump(deg2rad(45) === M_PI_4); // bool(true) + +?> +]]> + </programlisting> + </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>rad2deg</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/exp.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc/en/reference/math/functions/exp.xml diff -u phpdoc/en/reference/math/functions/exp.xml:1.11 phpdoc/en/reference/math/functions/exp.xml:1.12 --- phpdoc/en/reference/math/functions/exp.xml:1.11 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/exp.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> +<!-- $Revision: 1.12 $ --> <refentry id="function.exp"> <refnamediv> <refname>exp</refname> @@ -20,41 +20,16 @@ 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> -<![CDATA[ -1.6275E+005 -298.87 -]]> - </screen> - </example> - </para> - <para> - See also - <function>log</function> and - <function>pow</function>. - </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>arg</parameter></term> <listitem> <para> - + The argument to process </para> </listitem> </varlistentry> @@ -64,20 +39,38 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - + 'e' raised to the power of <parameter>arg</parameter> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> - + <example> + <title><function>exp</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo exp(12) . "\n"; +echo exp(5.7); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +1.6275E+005 +298.87 +]]> + </screen> + </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>log</function></member> + <member><function>pow</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/expm1.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/math/functions/expm1.xml diff -u phpdoc/en/reference/math/functions/expm1.xml:1.7 phpdoc/en/reference/math/functions/expm1.xml:1.8 --- phpdoc/en/reference/math/functions/expm1.xml:1.7 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/expm1.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> +<!-- $Revision: 1.8 $ --> <refentry id='function.expm1'> <refnamediv> <refname>expm1</refname> @@ -12,31 +12,27 @@ &reftitle.description; <methodsynopsis> <type>float</type><methodname>expm1</methodname> - <methodparam><type>float</type><parameter>number</parameter></methodparam> + <methodparam><type>float</type><parameter>arg</parameter></methodparam> </methodsynopsis> &warn.experimental.func; <para> <function>expm1</function> returns the equivalent to - 'exp(<parameter>number</parameter>) - 1' computed in a way that is - accurate even if the value of <parameter>number</parameter> is near zero, - a case where 'exp (<parameter>number</parameter>) - 1' would be + 'exp(<parameter>arg</parameter>) - 1' computed in a way that is + accurate even if the value of <parameter>arg</parameter> is near zero, + a case where 'exp (<parameter>arg</parameter>) - 1' would be inaccurate due to subtraction of two numbers that are nearly equal. </para> &note.no-windows; - <para> - See also <function>log1p</function> and - <function>exp</function>. - </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>arg</parameter></term> <listitem> <para> - + The argument to process </para> </listitem> </varlistentry> @@ -46,20 +42,15 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - + 'e' to the power of <parameter>arg</parameter> minus one </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>log1p</function></member> + <member><function>exp</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/floor.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/math/functions/floor.xml diff -u phpdoc/en/reference/math/functions/floor.xml:1.8 phpdoc/en/reference/math/functions/floor.xml:1.9 --- phpdoc/en/reference/math/functions/floor.xml:1.8 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/floor.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <refentry id="function.floor"> <refnamediv> <refname>floor</refname> @@ -14,27 +14,6 @@ <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 -echo floor(9.999); // 9 -echo floor(-3.14); // -4 -?> -]]> - </programlisting> - </example> - </para> - <simpara> - See also <function>ceil</function> and - <function>round</function>. </simpara> </refsect1> <refsect1 role="parameters"> @@ -42,10 +21,10 @@ <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>number</parameter></term> <listitem> <para> - + The numeric value to round </para> </listitem> </varlistentry> @@ -55,20 +34,35 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - + <parameter>arg</parameter> rounded to the next lowest integer. + The return value of <function>floor</function> is still of type + <type>float</type> because the value range of <type>float</type> is + usually bigger than that of <type>integer</type>. </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> - + <example> + <title><function>floor</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo floor(4.3); // 4 +echo floor(9.999); // 9 +echo floor(-3.14); // -4 +?> +]]> + </programlisting> + </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>ceil</function></member> + <member><function>round</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/fmod.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/math/functions/fmod.xml diff -u phpdoc/en/reference/math/functions/fmod.xml:1.7 phpdoc/en/reference/math/functions/fmod.xml:1.8 --- phpdoc/en/reference/math/functions/fmod.xml:1.7 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/fmod.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> +<!-- $Revision: 1.8 $ --> <refentry id="function.fmod"> <refnamediv> <refname>fmod</refname> @@ -22,31 +22,24 @@ <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; -$y = 1.3; -$r = fmod($x, $y); -// $r equals 0.5, because 4 * 1.3 + 0.5 = 5.7 -?> -]]> - </programlisting> - </example> - </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>x</parameter></term> <listitem> <para> - + The dividend + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>y</parameter></term> + <listitem> + <para> + The divisor </para> </listitem> </varlistentry> @@ -56,21 +49,26 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - + The floating point remainder of + <parameter>x</parameter>/<parameter>y</parameter> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> - - </para> - </refsect1> - <refsect1 role="seealso"> - &reftitle.seealso; - <para> - <simplelist> - <member><function> </function></member> - </simplelist> + <example> + <title>Using <function>fmod</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +$x = 5.7; +$y = 1.3; +$r = fmod($x, $y); +// $r equals 0.5, because 4 * 1.3 + 0.5 = 5.7 +?> +]]> + </programlisting> + </example> </para> </refsect1> </refentry> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/getrandmax.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/math/functions/getrandmax.xml diff -u phpdoc/en/reference/math/functions/getrandmax.xml:1.5 phpdoc/en/reference/math/functions/getrandmax.xml:1.6 --- phpdoc/en/reference/math/functions/getrandmax.xml:1.5 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/getrandmax.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <refentry id="function.getrandmax"> <refnamediv> <refname>getrandmax</refname> @@ -15,43 +15,20 @@ Returns the maximum value that can be returned by a call to <function>rand</function>. </simpara> - <simpara> - See also <function>rand</function>, <function>srand</function> - and <function>mt_getrandmax</function>. - </simpara> - </refsect1> - <refsect1 role="parameters"> - &reftitle.parameters; - <para> - <variablelist> - <varlistentry> - <term><parameter> </parameter></term> - <listitem> - <para> - - </para> - </listitem> - </varlistentry> - </variablelist> - </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - + The largest possible random value returned by <function>rand</function> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>rand</function></member> + <member><function>srand</function></member> + <member><function>mt_getrandmax</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/hexdec.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc/en/reference/math/functions/hexdec.xml diff -u phpdoc/en/reference/math/functions/hexdec.xml:1.11 phpdoc/en/reference/math/functions/hexdec.xml:1.12 --- phpdoc/en/reference/math/functions/hexdec.xml:1.11 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/hexdec.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> +<!-- $Revision: 1.12 $ --> <refentry id="function.hexdec"> <refnamediv> <refname>hexdec</refname> @@ -15,35 +15,11 @@ Returns the decimal equivalent of the hexadecimal number represented by the <parameter>hex_string</parameter> argument. <function>hexdec</function> converts a hexadecimal string to a - decimal number. The largest number that can be converted is - 7fffffff or 2147483647 in decimal. - As of PHP 4.1.0, this function can also convert larger numbers. It returns - <type>float</type> in that case. + decimal number. </para> <para> <function>hexdec</function> will ignore any non-hexadecimal characters it encounters. - <example> - <title><function>hexdec</function> example</title> - <programlisting role="php"> -<![CDATA[ -<?php -var_dump(hexdec("See")); -var_dump(hexdec("ee")); -// both print "int(238)" - -var_dump(hexdec("that")); // print "int(10)" -var_dump(hexdec("a0")); // print "int(160)" -?> -]]> - </programlisting> - </example> - </para> - <para> - See also <function>dechex</function>, - <function>bindec</function>, - <function>octdec</function> and - <function>base_convert</function>. </para> </refsect1> <refsect1 role="parameters"> @@ -51,10 +27,10 @@ <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>hex_string</parameter></term> <listitem> <para> - + The hexadezimal string to convert </para> </listitem> </varlistentry> @@ -64,25 +40,66 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - + The decimal representation of <parameter>hex_string</parameter> + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Since 4.1.0</entry> + <entry> + The function can now convert values that are to big for + the platforms <type>integer</type> type, it will return + the value as <type>float</type> instead in that case. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> + <example> + <title><function>hexdec</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php +var_dump(hexdec("See")); +var_dump(hexdec("ee")); +// both print "int(238)" +var_dump(hexdec("that")); // print "int(10)" +var_dump(hexdec("a0")); // print "int(160)" +?> +]]> + </programlisting> + </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>dechex</function></member> + <member><function>bindec</function></member> + <member><function>octdec</function></member> + <member><function>base_convert</function></member> </simplelist> </para> </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/hypot.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/math/functions/hypot.xml diff -u phpdoc/en/reference/math/functions/hypot.xml:1.7 phpdoc/en/reference/math/functions/hypot.xml:1.8 --- phpdoc/en/reference/math/functions/hypot.xml:1.7 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/hypot.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> +<!-- $Revision: 1.8 $ --> <refentry id='function.hypot'> <refnamediv> <refname>hypot</refname> @@ -27,10 +27,18 @@ <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>x</parameter></term> <listitem> <para> - + Length of first side + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>y</parameter></term> + <listitem> + <para> + Length of second side </para> </listitem> </varlistentry> @@ -40,21 +48,7 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - - </para> - </refsect1> - <refsect1 role="seealso"> - &reftitle.seealso; - <para> - <simplelist> - <member><function> </function></member> - </simplelist> + Calculated length of the hyptenuse </para> </refsect1> </refentry> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/is-finite.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/math/functions/is-finite.xml diff -u phpdoc/en/reference/math/functions/is-finite.xml:1.6 phpdoc/en/reference/math/functions/is-finite.xml:1.7 --- phpdoc/en/reference/math/functions/is-finite.xml:1.6 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/is-finite.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <refentry id='function.is-finite'> <refnamediv> <refname>is_finite</refname> @@ -12,12 +12,8 @@ <methodparam><type>float</type><parameter>val</parameter></methodparam> </methodsynopsis> <para> - Returns &true; if <parameter>val</parameter> is a legal finite - number within the allowed range for a PHP float on this platform. - </para> - <para> - See also <function>is_infinite</function> and - <function>is_nan</function>. + Checks whether <parameter>val</parameter> is a lecal finite + on this platform. </para> </refsect1> <refsect1 role="parameters"> @@ -25,10 +21,10 @@ <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>val</parameter></term> <listitem> <para> - + The value to check </para> </listitem> </varlistentry> @@ -38,20 +34,17 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - + &true; if <parameter>val</parameter> is a legal finite + number within the allowed range for a PHP float on this platform, + else &false;. </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>is_infinite</function></member> + <member><function>is_nan</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/is-infinite.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/math/functions/is-infinite.xml diff -u phpdoc/en/reference/math/functions/is-infinite.xml:1.6 phpdoc/en/reference/math/functions/is-infinite.xml:1.7 --- phpdoc/en/reference/math/functions/is-infinite.xml:1.6 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/is-infinite.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <refentry id='function.is-infinite'> <refnamediv> <refname>is_infinite</refname> @@ -16,20 +16,16 @@ negative), like the result of <literal>log(0)</literal> or any value too big to fit into a float on this platform. </para> - <para> - See also <function>is_finite</function> and - <function>is_nan</function>. - </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>val</parameter></term> <listitem> <para> - + The value to check </para> </listitem> </varlistentry> @@ -39,20 +35,15 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - + &true; if <parameter>val</parameter> is infinite, else &false;. </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>is_finite</function></member> + <member><function>is_nan</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/is-nan.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/math/functions/is-nan.xml diff -u phpdoc/en/reference/math/functions/is-nan.xml:1.6 phpdoc/en/reference/math/functions/is-nan.xml:1.7 --- phpdoc/en/reference/math/functions/is-nan.xml:1.6 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/is-nan.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <refentry id='function.is-nan'> <refnamediv> <refname>is_nan</refname> @@ -12,23 +12,19 @@ <methodparam><type>float</type><parameter>val</parameter></methodparam> </methodsynopsis> <para> - Returns &true; if <parameter>val</parameter> is 'not a number', + Checks whether <parameter>val</parameter> is 'not a number', like the result of <literal>acos(1.01)</literal>. </para> - <para> - See also <function>is_finite</function> and - <function>is_infinite</function>. - </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>val</parameter></term> <listitem> <para> - + The value to check </para> </listitem> </varlistentry> @@ -38,20 +34,16 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - + Returns &true; if <parameter>val</parameter> is 'not a number', + else &false;. </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>is_finite</function></member> + <member><function>is_infinite</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/lcg-value.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc/en/reference/math/functions/lcg-value.xml diff -u phpdoc/en/reference/math/functions/lcg-value.xml:1.4 phpdoc/en/reference/math/functions/lcg-value.xml:1.5 --- phpdoc/en/reference/math/functions/lcg-value.xml:1.4 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/lcg-value.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> <refentry id="function.lcg-value"> <refnamediv> <refname>lcg_value</refname> @@ -18,38 +18,18 @@ to the product of both primes. </para> </refsect1> - <refsect1 role="parameters"> - &reftitle.parameters; - <para> - <variablelist> - <varlistentry> - <term><parameter> </parameter></term> - <listitem> - <para> - - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - + A pseudo random float value in the range of (0, 1) </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>rand</function></member> + <member><function>mt_rand</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/log.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc/en/reference/math/functions/log.xml diff -u phpdoc/en/reference/math/functions/log.xml:1.11 phpdoc/en/reference/math/functions/log.xml:1.12 --- phpdoc/en/reference/math/functions/log.xml:1.11 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/log.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> +<!-- $Revision: 1.12 $ --> <refentry id="function.log"> <refnamediv> <refname>log</refname> @@ -18,31 +18,25 @@ <parameter>arg</parameter>, otherwise <function>log</function> returns the natural logarithm of <parameter>arg</parameter>. </para> - <note> - <para> - The <parameter>base</parameter> parameter became available - with PHP 4.3.0. - </para> - <para> - As always you can calculate the logarithm in base <literal>b</literal> - of a number <literal>n</literal>, but using the mathematical identity: - log<subscript>b</subscript>(n) = log(n)/log(b), where log is the - neperian (or natural) logarithm. - </para> - </note> - <para> - See also <function>exp</function>. - </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>arg</parameter></term> <listitem> <para> - + The value to calculate the logarithm for + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>base</parameter></term> + <listitem> + <para> + The optinal logarithmic base to use + (defaults to 'e' and so to the natural logarithm). </para> </listitem> </varlistentry> @@ -52,20 +46,45 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - + The logarithm of <parameter>arg</parameter> to + <parameter>base</parameter>, if given, or the + natural logarithm. </para> </refsect1> - <refsect1 role="examples"> - &reftitle.examples; +<refsect1 role="changelog"> + &reftitle.changelog; <para> - + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Since 4.3.0</entry> + <entry> + The optinal parameter <parameter>base</parameter> became available. + For older versions you can calculate the logarithm in base <literal>b</literal> + of a number <literal>n</literal>, but using the mathematical identity: + log<subscript>b</subscript>(n) = log(n)/log(b), where log is the + neperian (or natural) logarithm. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>log10</function></member> + <member><function>exp</function></member> + <member><function>pow</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/log10.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/math/functions/log10.xml diff -u phpdoc/en/reference/math/functions/log10.xml:1.5 phpdoc/en/reference/math/functions/log10.xml:1.6 --- phpdoc/en/reference/math/functions/log10.xml:1.5 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/log10.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <refentry id="function.log10"> <refnamediv> <refname>log10</refname> @@ -24,10 +24,10 @@ <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>arg</parameter></term> <listitem> <para> - + The argument to process </para> </listitem> </varlistentry> @@ -37,20 +37,14 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - + The base-10 logaritm of <parameter>arg</parameter> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>log</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/log1p.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/math/functions/log1p.xml diff -u phpdoc/en/reference/math/functions/log1p.xml:1.8 phpdoc/en/reference/math/functions/log1p.xml:1.9 --- phpdoc/en/reference/math/functions/log1p.xml:1.8 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/log1p.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <refentry id='function.log1p'> <refnamediv> <refname>log1p</refname> @@ -21,20 +21,16 @@ when the value of <parameter>number</parameter> is close to zero. </para> &note.no-windows; - <para> - See also <function>expm1</function> and - <function>log</function>. - </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>number</parameter></term> <listitem> <para> - + The argument to process </para> </listitem> </varlistentry> @@ -44,20 +40,16 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - + log(1 + <parameter>number</parameter>) </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>expm1</function></member> + <member><function>log</function></member> + <member><function>log10</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/mt-getrandmax.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc/en/reference/math/functions/mt-getrandmax.xml diff -u phpdoc/en/reference/math/functions/mt-getrandmax.xml:1.6 phpdoc/en/reference/math/functions/mt-getrandmax.xml:1.7 --- phpdoc/en/reference/math/functions/mt-getrandmax.xml:1.6 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/mt-getrandmax.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <refentry id="function.mt-getrandmax"> <refnamediv> <refname>mt_getrandmax</refname> @@ -15,45 +15,20 @@ Returns the maximum value that can be returned by a call to <function>mt_rand</function>. </simpara> - <simpara> - See also: - <function>mt_rand</function>, - <function>mt_srand</function>, and - <function>getrandmax</function>. - </simpara> - </refsect1> - <refsect1 role="parameters"> - &reftitle.parameters; - <para> - <variablelist> - <varlistentry> - <term><parameter> </parameter></term> - <listitem> - <para> - - </para> - </listitem> - </varlistentry> - </variablelist> - </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - + Returns the maximum random value returned by <function>mt_rand</function> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>mt_rand</function></member> + <member><function>mt_srand</function></member> + <member><function>getrandmax</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/mt-rand.xml?r1=1.12&r2=1.13&diff_format=u Index: phpdoc/en/reference/math/functions/mt-rand.xml diff -u phpdoc/en/reference/math/functions/mt-rand.xml:1.12 phpdoc/en/reference/math/functions/mt-rand.xml:1.13 --- phpdoc/en/reference/math/functions/mt-rand.xml:1.12 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/mt-rand.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> +<!-- $Revision: 1.13 $ --> <refentry id="function.mt-rand"> <refnamediv> <refname>mt_rand</refname> @@ -30,56 +30,26 @@ 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"; -echo mt_rand() . "\n"; - -echo mt_rand(5, 15); -?> -]]> - </programlisting> - &example.outputs.similar; - <screen> -<![CDATA[ -1604716014 -1478613278 -6 -]]> - </screen> - </example> - </para> &note.randomseed; - <note> - <para> - In versions before 3.0.7 the meaning of - <parameter>max</parameter> was <parameter>range</parameter>. To - get the same results in these versions the short example should - be <literal>mt_rand (5, 11)</literal> to get a random number - between 5 and 15. - </para> - </note> - <simpara> - See also: - <function>mt_srand</function>, - <function>mt_getrandmax</function>, and - <function>rand</function>. - </simpara> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>min</parameter></term> <listitem> <para> - + Optional lowest value to be returned (default: 0) + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>man</parameter></term> + <listitem> + <para> + Optional highest value to be returned (default: RAND_MAX) </para> </listitem> </varlistentry> @@ -89,20 +59,70 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - + A random integer value between <parameter>min</parameter> (or 0) + and <parameter>max</parameter> (or RAND_MAX, inclusive) + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Since 3.0.7</entry> + <entry> + In versions before 3.0.7 the meaning of + <parameter>max</parameter> was <parameter>range</parameter>. To + get the same results in these versions the short example should + be <literal>rand (5, 11)</literal> to get a random number + between 5 and 15. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> + <example> + <title><function>mt_rand</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo mt_rand() . "\n"; +echo mt_rand() . "\n"; +echo mt_rand(5, 15); +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +1604716014 +1478613278 +6 +]]> + </screen> + </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>mt_srand</function></member> + <member><function>mt_getrandmax</function></member> + <member><function>rand</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/mt-srand.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc/en/reference/math/functions/mt-srand.xml diff -u phpdoc/en/reference/math/functions/mt-srand.xml:1.10 phpdoc/en/reference/math/functions/mt-srand.xml:1.11 --- phpdoc/en/reference/math/functions/mt-srand.xml:1.10 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/mt-srand.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> +<!-- $Revision: 1.11 $ --> <refentry id="function.mt-srand"> <refnamediv> <refname>mt_srand</refname> @@ -13,71 +13,81 @@ </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); -} -mt_srand(make_seed()); -$randval = mt_rand(); -?> -]]> - </programlisting> - </example> + <parameter>seed</parameter> or with a random value + if no <parameter>seed</parameter> is given. </para> &note.randomseed; - <simpara> - See also: - <function>mt_rand</function>, - <function>mt_getrandmax</function>, and - <function>srand</function>. - </simpara> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>seed</parameter></term> <listitem> <para> - + An optional seed value </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> - <refsect1 role="returnvalues"> - &reftitle.returnvalues; + <refsect1 role="changelog"> + &reftitle.changelog; <para> - + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Since 4.2.0</entry> + <entry> + The <parameter>seed</parameter> becomes optional + and defaults to a random value if omitted. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> - + <example> + <title><function>mt_srand</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php +// seed with microseconds +function make_seed() +{ + list($usec, $sec) = explode(' ', microtime()); + return (float) $sec + ((float) $usec * 100000); +} +mt_srand(make_seed()); +$randval = mt_rand(); +?> +]]> + </programlisting> + </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>mt_rand</function></member> + <member><function>mt_getrandmax</function></member> + <member><function>srand</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/octdec.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc/en/reference/math/functions/octdec.xml diff -u phpdoc/en/reference/math/functions/octdec.xml:1.10 phpdoc/en/reference/math/functions/octdec.xml:1.11 --- phpdoc/en/reference/math/functions/octdec.xml:1.10 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/octdec.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> +<!-- $Revision: 1.11 $ --> <refentry id="function.octdec"> <refnamediv> <refname>octdec</refname> @@ -14,37 +14,6 @@ <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> -<![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> <refsect1 role="parameters"> @@ -52,10 +21,10 @@ <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>octal_string</parameter></term> <listitem> <para> - + The octal string to convert </para> </listitem> </varlistentry> @@ -65,20 +34,65 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - + The decimal representation of <parameter>octal_string</parameter> + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Since 4.1.0</entry> + <entry> + The function can now convert numbers that are too large to + fit into the platforms <type>integer</type> type, larger values + are returned as <type>float</type> in that case. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> - + <example> + <title><function>octdec</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo octdec('77') . "\n"; +echo octdec(decoct(45)); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +63 +45 +]]> + </screen> + </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>decoct</function></member> + <member><function>bindec</function></member> + <member><function>hexdec</function></member> + <member><function>base_convert</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/pi.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/math/functions/pi.xml diff -u phpdoc/en/reference/math/functions/pi.xml:1.7 phpdoc/en/reference/math/functions/pi.xml:1.8 --- phpdoc/en/reference/math/functions/pi.xml:1.7 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/pi.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> +<!-- $Revision: 1.8 $ --> <refentry id="function.pi"> <refnamediv> <refname>pi</refname> @@ -19,6 +19,15 @@ Also, you can use the <constant>M_PI</constant> constant which yields identical results to <function>pi</function>. </simpara> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + The value of pi as float. + </para> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; <para> <example> <title><function>pi</function> example</title> @@ -33,41 +42,6 @@ </example> </para> </refsect1> - <refsect1 role="parameters"> - &reftitle.parameters; - <para> - <variablelist> - <varlistentry> - <term><parameter> </parameter></term> - <listitem> - <para> - - </para> - </listitem> - </varlistentry> - </variablelist> - </para> - </refsect1> - <refsect1 role="returnvalues"> - &reftitle.returnvalues; - <para> - - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - - </para> - </refsect1> - <refsect1 role="seealso"> - &reftitle.seealso; - <para> - <simplelist> - <member><function> </function></member> - </simplelist> - </para> - </refsect1> </refentry> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/pow.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc/en/reference/math/functions/pow.xml diff -u phpdoc/en/reference/math/functions/pow.xml:1.10 phpdoc/en/reference/math/functions/pow.xml:1.11 --- phpdoc/en/reference/math/functions/pow.xml:1.10 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/pow.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> +<!-- $Revision: 1.11 $ --> <refentry id="function.pow"> <refnamediv> <refname>pow</refname> @@ -14,58 +14,37 @@ </methodsynopsis> <para> Returns <parameter>base</parameter> raised to the power of - <parameter>exp</parameter>. If possible, this function will - return an <type>integer</type>. - </para> - <para> - If the power cannot be computed, a warning will be issued, - and <function>pow</function> will return &false;. Since PHP 4.2.0 - <function>pow</function> doesn't issue any warning. + <parameter>exp</parameter>. </para> <note> <para> PHP cannot handle negative <parameter>exp</parameter>s. </para> </note> - <example> - <title>Some examples of <function>pow</function></title> - <programlisting role="php"> -<![CDATA[ -<?php - -var_dump(pow(2, 8)); // int(256) -echo pow(-1, 20); // 1 -echo pow(0, 0); // 1 - -echo pow(-1, 5.5); // error - -?> -]]> - </programlisting> - </example> <warning> <para> In PHP 4.0.6 and earlier <function>pow</function> always returned a <type>float</type>, and did not issue warnings. </para> </warning> - <para> - See also: - <function>exp</function>, - <function>sqrt</function>, - <function>bcpow</function>, and - <function>gmp_pow</function>, - </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>base</parameter></term> <listitem> <para> - + The base to use + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>exp</parameter></term> + <listitem> + <para> + The exponent </para> </listitem> </varlistentry> @@ -75,20 +54,72 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - + <parameter>base</parameter> raised to the power of <parameter>exp</parameter>. + If the result can be represented as integer it will be returned as type + <type>integer</type>, else it will be returned as type <type>float</type>. + If the power cannot be computed &false; will be returned instead. + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Since 4.0.6</entry> + <entry> + The function will now return <type>integer</type> results if possible, + before this it always returned a <type>float</type> result. + </entry> + </row> + <row> + <entry>Since 4.2.0</entry> + <entry> + PHP stops to emit a warning if the value can't be computed, + it will now silently return &false; only. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> + <example> + <title>Some examples of <function>pow</function></title> + <programlisting role="php"> +<![CDATA[ +<?php + +var_dump(pow(2, 8)); // int(256) +echo pow(-1, 20); // 1 +echo pow(0, 0); // 1 +echo pow(-1, 5.5); // error + +?> +]]> + </programlisting> + </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>exp</function></member> + <member><function>sqrt</function></member> + <member><function>bcpow</function></member> + <member><function>gmp_pow</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/rad2deg.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/math/functions/rad2deg.xml diff -u phpdoc/en/reference/math/functions/rad2deg.xml:1.5 phpdoc/en/reference/math/functions/rad2deg.xml:1.6 --- phpdoc/en/reference/math/functions/rad2deg.xml:1.5 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/rad2deg.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <refentry id="function.rad2deg"> <refnamediv> <refname>rad2deg</refname> @@ -17,33 +17,16 @@ This function converts <parameter>number</parameter> from radian to degrees. </para> - <para> - <example> - <title><function>rad2deg</function> example</title> - <programlisting role="php"> -<![CDATA[ -<?php - -echo rad2deg(M_PI_4); // 45 - -?> -]]> - </programlisting> - </example> - </para> - <para> - See also <function>deg2rad</function>. - </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>number</parameter></term> <listitem> <para> - + A radian value </para> </listitem> </varlistentry> @@ -53,20 +36,31 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - + The equivalent of <parameter>number</parameter> in degrees </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> + <example> + <title><function>rad2deg</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php + +echo rad2deg(M_PI_4); // 45 +?> +]]> + </programlisting> + </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>deg2rad</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/rand.xml?r1=1.17&r2=1.18&diff_format=u Index: phpdoc/en/reference/math/functions/rand.xml diff -u phpdoc/en/reference/math/functions/rand.xml:1.17 phpdoc/en/reference/math/functions/rand.xml:1.18 --- phpdoc/en/reference/math/functions/rand.xml:1.17 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/rand.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.17 $ --> +<!-- $Revision: 1.18 $ --> <refentry id="function.rand"> <refnamediv> <refname>rand</refname> @@ -20,29 +20,6 @@ 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"; -echo rand() . "\n"; - -echo rand(5, 15); -?> -]]> - </programlisting> - &example.outputs.similar; - <screen> -<![CDATA[ -7771 -22264 -11 -]]> - </screen> - </example> - </para> <note> <simpara> On some platforms (such as Windows) <constant>RAND_MAX</constant> @@ -55,31 +32,24 @@ &note.randomseed; - <note> - <para> - In versions before 3.0.7 the meaning of - <parameter>max</parameter> was <parameter>range</parameter>. To - get the same results in these versions the short example should - be <literal>rand (5, 11)</literal> to get a random number - between 5 and 15. - </para> - </note> - <simpara> - See also: - <function>srand</function>, - <function>getrandmax</function>, and - <function>mt_rand</function>. - </simpara> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>min</parameter></term> <listitem> <para> - + The lowest value to return (default: 0) + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>max</parameter></term> + <listitem> + <para> + The highest value to return (default: RAND_MAX) </para> </listitem> </varlistentry> @@ -89,20 +59,70 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - + A pseudo random value between <parameter>min</parameter> + (or 0) and <parameter>max</parameter> (or RAND_MAX, inclusive). + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Since 3.0.7</entry> + <entry> + In versions before 3.0.7 the meaning of + <parameter>max</parameter> was <parameter>range</parameter>. To + get the same results in these versions the short example should + be <literal>rand (5, 11)</literal> to get a random number + between 5 and 15. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> + <example> + <title><function>rand</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo rand() . "\n"; +echo rand() . "\n"; +echo rand(5, 15); +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +7771 +22264 +11 +]]> + </screen> + </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>srand</function></member> + <member><function>getrandmax</function></member> + <member><function>mt_rand</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/round.xml?r1=1.11&r2=1.12&diff_format=u Index: phpdoc/en/reference/math/functions/round.xml diff -u phpdoc/en/reference/math/functions/round.xml:1.11 phpdoc/en/reference/math/functions/round.xml:1.12 --- phpdoc/en/reference/math/functions/round.xml:1.11 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/round.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.11 $ --> +<!-- $Revision: 1.12 $ --> <refentry id="function.round"> <refnamediv> <refname>round</refname> @@ -18,25 +18,6 @@ (number of digits after the decimal point). <parameter>precision</parameter> can also be negative or zero (default). </para> - <para> - <example> - <title><function>round</function> examples</title> - <programlisting role="php"> -<![CDATA[ -<?php -echo round(3.4); // 3 -echo round(3.5); // 4 -echo round(3.6); // 4 -echo round(3.6, 0); // 4 -echo round(1.95583, 2); // 1.96 -echo round(1241757, -3); // 1242000 -echo round(5.045, 2); // 5.05 -echo round(5.055, 2); // 5.06 -?> -]]> - </programlisting> - </example> - </para> <!-- It's not true <para> <caution> @@ -70,22 +51,24 @@ </simpara> </note> </para> - <simpara> - See also: - <function>ceil</function>, - <function>floor</function>, and - <function>number_format</function>. - </simpara> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>val</parameter></term> <listitem> <para> - + The value to round + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>precision</parameter></term> + <listitem> + <para> + The optional number of decimal digits to round to, defaults to 0 </para> </listitem> </varlistentry> @@ -95,20 +78,38 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - + The rounded value </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> - + <example> + <title><function>round</function> examples</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo round(3.4); // 3 +echo round(3.5); // 4 +echo round(3.6); // 4 +echo round(3.6, 0); // 4 +echo round(1.95583, 2); // 1.96 +echo round(1241757, -3); // 1242000 +echo round(5.045, 2); // 5.05 +echo round(5.055, 2); // 5.06 +?> +]]> + </programlisting> + </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>ceil</function></member> + <member><function>floor</function></member> + <member><function>number_format</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/sin.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc/en/reference/math/functions/sin.xml diff -u phpdoc/en/reference/math/functions/sin.xml:1.9 phpdoc/en/reference/math/functions/sin.xml:1.10 --- phpdoc/en/reference/math/functions/sin.xml:1.9 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/sin.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> +<!-- $Revision: 1.10 $ --> <refentry id="function.sin"> <refnamediv> <refname>sin</refname> @@ -15,39 +15,16 @@ <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 - -// Precision depends on your precision directive -echo sin(deg2rad(60)); // 0.866025403 ... -echo sin(60); // -0.304810621 ... - -?> -]]> - </programlisting> - </example> - </para> - <para> - See also: - <function>asin</function>, - <function>cos</function>, - <function>tan</function>, and - <function>deg2rad</function>. - </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>arg</parameter></term> <listitem> <para> - + A value in radians </para> </listitem> </varlistentry> @@ -57,20 +34,37 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - + The sine of <parameter>arg</parameter> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> + <example> + <title><function>sin</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Precision depends on your precision directive +echo sin(deg2rad(60)); // 0.866025403 ... +echo sin(60); // -0.304810621 ... + +?> +]]> + </programlisting> + </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>asin</function></member> + <member><function>sinh</function></member> + <member><function>cos</function></member> + <member><function>tan</function></member> + <member><function>deg2rad</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/sinh.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/math/functions/sinh.xml diff -u phpdoc/en/reference/math/functions/sinh.xml:1.5 phpdoc/en/reference/math/functions/sinh.xml:1.6 --- phpdoc/en/reference/math/functions/sinh.xml:1.5 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/sinh.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <refentry id="function.sinh"> <refnamediv> <refname>sinh</refname> @@ -15,23 +15,16 @@ Returns the hyperbolic sine of <parameter>arg</parameter>, defined as <literal>(exp(arg) - exp(-arg))/2</literal>. </para> - <para> - See also: - <function>sin</function>, - <function>asinh</function>, - <function>cos</function>, and - <function>tan</function>. - </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>arg</parameter></term> <listitem> <para> - + The argument to process </para> </listitem> </varlistentry> @@ -41,20 +34,17 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - + The hyperbolic sine of <parameter>arg</parameter> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>sin</function></member> + <member><function>asinh</function></member> + <member><function>cosh</function></member> + <member><function>tanh</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/sqrt.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc/en/reference/math/functions/sqrt.xml diff -u phpdoc/en/reference/math/functions/sqrt.xml:1.7 phpdoc/en/reference/math/functions/sqrt.xml:1.8 --- phpdoc/en/reference/math/functions/sqrt.xml:1.7 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/sqrt.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.7 $ --> +<!-- $Revision: 1.8 $ --> <refentry id="function.sqrt"> <refnamediv> <refname>sqrt</refname> @@ -14,33 +14,16 @@ <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 -echo sqrt(9); // 3 -echo sqrt(10); // 3.16227766 ... -?> -]]> - </programlisting> - </example> - </para> - <para> - See also <function>pow</function>. - </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>arg</parameter></term> <listitem> <para> - + The argument to process </para> </listitem> </varlistentry> @@ -50,20 +33,31 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - + The square root of <parameter>arg</parameter> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> - + <example> + <title><function>sqrt</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php +// Precision depends on your precision directive +echo sqrt(9); // 3 +echo sqrt(10); // 3.16227766 ... +?> +]]> + </programlisting> + </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>pow</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/srand.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc/en/reference/math/functions/srand.xml diff -u phpdoc/en/reference/math/functions/srand.xml:1.10 phpdoc/en/reference/math/functions/srand.xml:1.11 --- phpdoc/en/reference/math/functions/srand.xml:1.10 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/srand.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> +<!-- $Revision: 1.11 $ --> <refentry id="function.srand"> <refnamediv> <refname>srand</refname> @@ -12,71 +12,59 @@ <methodparam choice="opt"><type>int</type><parameter>seed</parameter></methodparam> </methodsynopsis> <para> - Seeds the random number generator with <parameter>seed</parameter>. - Since PHP 4.2.0, the <parameter>seed</parameter> - becomes optional and defaults to a random value if omitted. - </para> - <para> - <example> - <title><function>srand</function> example</title> - <programlisting role="php"> -<![CDATA[ -<?php -// seed with microseconds -function make_seed() -{ - list($usec, $sec) = explode(' ', microtime()); - return (float) $sec + ((float) $usec * 100000); -} -srand(make_seed()); -$randval = rand(); -?> -]]> - </programlisting> - </example> + Seeds the random number generator with <parameter>seed</parameter> + or with a random value if no <parameter>seed</parameter> is given. </para> &note.randomseed; - <simpara> - See also: - <function>rand</function>, - <function>getrandmax</function>, and - <function>mt_srand</function>. - </simpara> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>seed</parameter></term> <listitem> <para> - + Optional seed value </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> - <refsect1 role="returnvalues"> - &reftitle.returnvalues; - <para> - - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; + <refsect1 role="changelog"> + &reftitle.changelog; <para> - + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>Since 4.2.0</entry> + <entry> + The <parameter>seed</parameter> becomes optional + and defaults to a random value if omitted. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>rand</function></member> + <member><function>getrandmax</function></member> + <member><function>mt_srand</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/tan.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc/en/reference/math/functions/tan.xml diff -u phpdoc/en/reference/math/functions/tan.xml:1.8 phpdoc/en/reference/math/functions/tan.xml:1.9 --- phpdoc/en/reference/math/functions/tan.xml:1.8 Sat Mar 31 11:20:54 2007 +++ phpdoc/en/reference/math/functions/tan.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> +<!-- $Revision: 1.9 $ --> <refentry id="function.tan"> <refnamediv> <refname>tan</refname> @@ -29,23 +29,16 @@ </programlisting> </example> </para> - <para> - See also: - <function>atan</function>, - <function>sin</function>, - <function>cos</function>, and - <function>deg2rad</function>. - </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>arg</parameter></term> <listitem> <para> - + The argument to process in radians </para> </listitem> </varlistentry> @@ -55,20 +48,41 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - + The tangent of <parameter>arg</parameter> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> - + <example> + <title><function>srand</function> example</title> + <programlisting role="php"> +<![CDATA[ +<?php +// seed with microseconds +function make_seed() +{ + list($usec, $sec) = explode(' ', microtime()); + return (float) $sec + ((float) $usec * 100000); +} +srand(make_seed()); +$randval = rand(); +?> +]]> + </programlisting> + </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>atan</function></member> + <member><function>atan2</function></member> + <member><function>sin</function></member> + <member><function>cos</function></member> + <member><function>tanh</function></member> + <member><function>deg2rad</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/math/functions/tanh.xml?r1=1.5&r2=1.6&diff_format=u Index: phpdoc/en/reference/math/functions/tanh.xml diff -u phpdoc/en/reference/math/functions/tanh.xml:1.5 phpdoc/en/reference/math/functions/tanh.xml:1.6 --- phpdoc/en/reference/math/functions/tanh.xml:1.5 Sat Mar 31 11:20:55 2007 +++ phpdoc/en/reference/math/functions/tanh.xml Sat Mar 31 19:18:23 2007 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.5 $ --> +<!-- $Revision: 1.6 $ --> <refentry id="function.tanh"> <refnamediv> <refname>tanh</refname> @@ -15,23 +15,16 @@ Returns the hyperbolic tangent of <parameter>arg</parameter>, defined as <literal>sinh(arg)/cosh(arg)</literal>. </para> - <para> - See also: - <function>tan</function>, - <function>atanh</function>, - <function>sin</function>, and - <function>cos</function>. - </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> - <term><parameter> </parameter></term> + <term><parameter>arg</parameter></term> <listitem> <para> - + The argument to process </para> </listitem> </varlistentry> @@ -41,20 +34,17 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - - </para> - </refsect1> - <refsect1 role="examples"> - &reftitle.examples; - <para> - + The hyperbolic tangent of <parameter>arg</parameter> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> - <member><function> </function></member> + <member><function>tan</function></member> + <member><function>atanh</function></member> + <member><function>sinh</function></member> + <member><function>cosh</function></member> </simplelist> </para> </refsect1>