svn: /phpdoc/en/trunk/reference/math/functions/ intdiv.xml

tpunt Thu, 13 Aug 2015 21:11:24 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=337445 Log: Rectify the intdiv() docs Changed paths: U phpdoc/en/trunk/reference/math/functions/intdiv.xml Modified: phpdoc/en/trunk/reference/math/functions/intdiv.xml =================================================================== --- phpdoc/en/trunk/reference/math/functions/intdiv.xml 2015-08-13 17:16:22 UTC (rev 337444) +++ phpdoc/en/trunk/reference/math/functions/intdiv.xml 2015-08-13 21:11:24 UTC (rev 337445) @@ -9,9 +9,9 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>integer</type><methodname>intdiv</methodname> - <methodparam><type>integer</type><parameter>numerator</parameter></methodparam> - <methodparam><type>integer</type><parameter>divisor</parameter></methodparam> + <type>int</type><methodname>intdiv</methodname> + <methodparam><type>int</type><parameter>numerator</parameter></methodparam> + <methodparam><type>int</type><parameter>divisor</parameter></methodparam> </methodsynopsis> <para> Returns the integer division of <parameter>numerator</parameter> by <parameter>divisor</parameter>. @@ -24,7 +24,7 @@ <term><parameter>numerator</parameter></term> <listitem> <para> - Number to be divide. + Number to be divided. </para> </listitem> </varlistentry> @@ -32,7 +32,7 @@ <term><parameter>divisor</parameter></term> <listitem> <para> - Number which divides the <parameter>numerator</parameter> + Number which divides the <parameter>numerator</parameter>. </para> </listitem> </varlistentry> @@ -42,11 +42,17 @@ &reftitle.returnvalues; <para> The integer division of <parameter>numerator</parameter> by <parameter>divisor</parameter>. - If <parameter>divisor</parameter> is zero, it throws an <constant>E_WARNING</constant> and returns &false;. - If the <parameter>numerator</parameter> is LONG_MIN (-<constant>PHP_INT_MAX</constant> - 1) and the - <parameter>divisor</parameter> is -1, it returns zero. </para> </refsect1> + <refsect1 role="errors"> + &reftitle.errors; + <para> + If <parameter>divisor</parameter> is <literal>0</literal>, a <classname>DivisionByZeroError</classname> + exception is thrown. If the <parameter>numerator</parameter> is <constant>PHP_INT_MIN</constant> + and the <parameter>divisor</parameter> is <literal>-1</literal>, then an + <classname>ArithmeticError</classname> exception is thrown. + </para> + </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> @@ -60,8 +66,8 @@ var_dump(intdiv(3, -2)); var_dump(intdiv(-3, -2)); var_dump(intdiv(PHP_INT_MAX, PHP_INT_MAX)); -var_dump(intdiv(-PHP_INT_MAX - 1, -PHP_INT_MAX - 1)); -var_dump(intdiv(-PHP_INT_MAX - 1, -1)); +var_dump(intdiv(PHP_INT_MIN, PHP_INT_MIN)); +var_dump(intdiv(PHP_INT_MIN, -1)); var_dump(intdiv(1, 0)); ?> ]]> @@ -74,10 +80,9 @@ int(1) int(1) int(1) -int(0) -Warning: intdiv(): Division by zero in %s on line 9 -bool(false) +Fatal error: Uncaught ArithmeticError: Division of PHP_INT_MIN by -1 is not an integer in %s on line 8 +Fatal error: Uncaught DivisionByZeroError: Division by zero in %s on line 9 ]]> </screen> </example>