<?xml version="1.0" encoding="utf-8"?>

<!-- $Revision$ -->

<!-- EN-Revision: 761d72245071f89a626903c9bcdc6aaff1252d54 Maintainer: YisonZhao Status: ready -->

<!-- CREDITS: mowangjuanzi, Luffy -->

<refentry xml:id="function.intdiv" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

<refnamediv>

<refname>intdiv</refname>

<refpurpose>对除法结果取整</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type>int</type><methodname>intdiv</methodname>

<methodparam><type>int</type><parameter>num1</parameter></methodparam>

<methodparam><type>int</type><parameter>num2</parameter></methodparam>

</methodsynopsis>

<para>

返回 <parameter>num1</parameter> 除以 <parameter>num2</parameter> 商数的整数部分。

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<variablelist>

<varlistentry>

<term><parameter>num1</parameter></term>

<listitem>

<para>

被除数。

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>num2</parameter></term>

<listitem>

<para>

除数。

</para>

</listitem>

</varlistentry>

</variablelist>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

<parameter>num1</parameter> 除以 <parameter>num2</parameter> 的商，对该商取整。

</para>

</refsect1>

<refsect1 role="errors">

&reftitle.errors;

<para>

如果 <parameter>num2</parameter> 是 <literal>0</literal>，将抛出

<classname>DivisionByZeroError</classname> 异常。如果 <parameter>num1</parameter>

是 <constant>PHP_INT_MIN</constant> 并且 <parameter>num2</parameter> 是

<literal>-1</literal>，将抛出 <classname>ArithmeticError</classname> 异常.

</para>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title><function>intdiv</function> 的一些示例</title>

<programlisting role="php">

<![CDATA[

<?php

var_dump(intdiv(3, 2));

var_dump(intdiv(-3, 2));

var_dump(intdiv(3, -2));

var_dump(intdiv(-3, -2));

var_dump(intdiv(PHP_INT_MAX, PHP_INT_MAX));

var_dump(intdiv(PHP_INT_MIN, PHP_INT_MIN));

?>

]]>

</programlisting>

&example.outputs;

<screen>

<![CDATA[

int(1)

int(-1)

int(-1)

int(1)

int(1)

int(1)

]]>

</screen>

</example>

</para>

<para>

<example>

<title><function>intdiv</function> 无效除数的示例</title>

<programlisting role="php">

<![CDATA[

<?php

try {

intdiv(PHP_INT_MIN, -1);

} catch (Error $e) {

echo get_class($e), ': ', $e->getMessage(), PHP_EOL;

}

try {

intdiv(1, 0);

} catch (Error $e) {

echo get_class($e), ': ', $e->getMessage(), PHP_EOL;

}

?>

]]>

</programlisting>

&example.outputs;

<screen>

<![CDATA[

ArithmeticError: Division of PHP_INT_MIN by -1 is not an integer

DivisionByZeroError: Division by zero

]]>

</screen>

</example>

</para>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><link linkend="language.operators.arithmetic"><literal>/</literal></link>——浮点除法</member>

<member><link linkend="language.operators.arithmetic"><literal>%</literal></link>——整数取模</member>

<member><function>fmod</function>——浮点数取模</member>

</simplelist>

</para>

</refsect1>

</refentry>

<!-- Keep this comment at the end of the file

Local variables:

mode: sgml

sgml-omittag:t

sgml-shorttag:t

sgml-minimize-attributes:nil

sgml-always-quote-attributes:t

sgml-indent-step:1

sgml-indent-data:t

indent-tabs-mode:nil

sgml-parent-document:nil

sgml-default-dtd-file:"~/.phpdoc/manual.ced"

sgml-exposed-tags:nil

sgml-local-catalogs:nil

sgml-local-ecat-files:nil

End:

vim600: syn=xml fen fdm=syntax fdl=2 si

vim: et tw=78 syn=sgml

vi: ts=1 sw=1

-->