<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/language.types.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'language.types.integer.php',
    1 => 'Integer 整型',
    2 => 'Integer 整型',
  ),
  'up' => 
  array (
    0 => 'language.types.php',
    1 => '类型',
  ),
  'prev' => 
  array (
    0 => 'language.types.boolean.php',
    1 => 'Boolean 布尔类型',
  ),
  'next' => 
  array (
    0 => 'language.types.float.php',
    1 => 'Float 浮点型',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'language/types/integer.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="language.types.integer" class="sect1">
 <h2 class="title">Integer 整型</h2>
 
 <p class="simpara">
   <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> 是集合 ℤ = {..., -2, -1, 0, 1, 2, ...} 中的某个数。
 </p>
  
 <div class="sect2">
  <h3 class="title">参见</h3>
  <p class="para">
   <ul class="simplelist">
    <li><a href="language.types.float.php" class="link">浮点数</a></li>
    <li><a href="book.bc.php" class="link">任意精度/BCMath</a></li>
    <li><a href="book.gmp.php" class="link">任意长度整数/GMP</a></li>
   </ul>
  </p>
 </div>

 <div class="sect2" id="language.types.integer.syntax">
  <h3 class="title">语法</h3>

  <p class="simpara">
   <span class="type"><a href="language.types.integer.php" class="type Int">Int</a></span> 可以使用十进制，十六进制，八进制或二进制表示，前面可以加上可选的符号（- 或者 +）。
   可以用<a href="language.operators.arithmetic.php" class="link">负运算符</a>
   来表示一个负的 <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>。
  </p>

  <p class="para">
   要使用八进制表达，数字前必须加上 <code class="literal">0</code>（零）。
   PHP 8.1.0 起，八进制表达也可以在前面加上 <code class="literal">0o</code> 或者 <code class="literal">0O</code> 。
   要使用十六进制表达，数字前必须加上
   <code class="literal">0x</code>。要使用二进制表达，数字前必须加上
   <code class="literal">0b</code>。
  </p>

  <p class="para">
   从 PHP 7.4.0
   开始，整型数值可能会包含下划线 (<code class="literal">_</code>)，为了更好的阅读体验，这些下划线在展示的时候，会被 PHP 过滤掉。
  </p>

  <div class="example" id="example-1">
   <p><strong>示例 #1 整数文字表达</strong></p>
   <div class="example-contents">
<div class="annotation-non-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$a </span><span style="color: #007700">= </span><span style="color: #0000BB">1234</span><span style="color: #007700">; </span><span style="color: #FF8000">// 十进制数<br /></span><span style="color: #0000BB">$a </span><span style="color: #007700">= </span><span style="color: #0000BB">0123</span><span style="color: #007700">; </span><span style="color: #FF8000">// 八进制数 (等于十进制 83)<br /></span><span style="color: #0000BB">$a </span><span style="color: #007700">= </span><span style="color: #0000BB">0o123</span><span style="color: #007700">; </span><span style="color: #FF8000">// 八进制数 (PHP 8.1.0 起)<br /></span><span style="color: #0000BB">$a </span><span style="color: #007700">= </span><span style="color: #0000BB">0x1A</span><span style="color: #007700">; </span><span style="color: #FF8000">// 十六进制数 (等于十进制 26)<br /></span><span style="color: #0000BB">$a </span><span style="color: #007700">= </span><span style="color: #0000BB">0b11111111</span><span style="color: #007700">; </span><span style="color: #FF8000">// 二进制数字 (等于十进制 255)<br /></span><span style="color: #0000BB">$a </span><span style="color: #007700">= </span><span style="color: #0000BB">1_234_567</span><span style="color: #007700">; </span><span style="color: #FF8000">// 整型数值 (PHP 7.4.0 以后)<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>

  <p class="para">
   <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> literal 的结构形式从 PHP 8.1.0 开始是（之前不允许使用 <code class="literal">0o</code> 或
   <code class="literal">0O</code> 八进制前缀，并且 PHP 7.4.0 之前不允许使用下划线）：
  </p>
 
  <div class="informalexample">
   <div class="example-contents">
<div class="annotation-interactive cdata"><pre>
decimal     : [1-9][0-9]*(_[0-9]+)*
            | 0

hexadecimal : 0[xX][0-9a-fA-F]+(_[0-9a-fA-F]+)*

octal       : 0[oO]?[0-7]+(_[0-7]+)*

binary      : 0[bB][01]+(_[01]+)*

integer     : decimal
            | hexadecimal
            | octal
            | binary
</pre></div>
   </div>

  </div>

  <p class="para">
   整型数 <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> 的字长和平台有关，尽管通常最大值是大约二十亿（32 位有符号）。64
   位平台下的最大值通常是大约 9E18。
   
   PHP 不支持无符号的 <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>。<span class="type"><a href="language.types.integer.php" class="type int">int</a></span> 值的字长可以用常量
   <strong><code><a href="reserved.constants.php#constant.php-int-size">PHP_INT_SIZE</a></code></strong>来表示，
   最大值可以用常量 <strong><code><a href="reserved.constants.php#constant.php-int-max">PHP_INT_MAX</a></code></strong> 来表示，
   最小值可以用常量 <strong><code><a href="reserved.constants.php#constant.php-int-min">PHP_INT_MIN</a></code></strong> 表示。
  </p>

 </div>

 <div class="sect2" id="language.types.integer.overflow">
  <h3 class="title">整数溢出</h3>

  <p class="para">
   如果给定的一个数超出了 <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> 的范围，将会被解释为
   <span class="type"><a href="language.types.float.php" class="type float">float</a></span>。同样如果执行的运算结果超出了
   <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> 范围，也会返回 <span class="type"><a href="language.types.float.php" class="type float">float</a></span>。
  </p>

  <div class="example" id="example-2">
   <p><strong>示例 #2 整数溢出</strong></p>
   <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />$large_number </span><span style="color: #007700">= </span><span style="color: #0000BB">50000000000000000000</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">$large_number</span><span style="color: #007700">);         </span><span style="color: #FF8000">// float(5.0E+19)<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">PHP_INT_MAX </span><span style="color: #007700">+ </span><span style="color: #0000BB">1</span><span style="color: #007700">);       </span><span style="color: #FF8000">// 32 位系统：float(2147483648)<br />                                 // 64 位系统：float(9.2233720368548E+18)<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </div>

 <div class="sect2" id="language.types.integer.division">
  <h3 class="title">整数除法</h3>
  <p class="para">
   PHP 没有 <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> 除法取整运算符，要使用 <span class="function"><a href="function.intdiv.php" class="function">intdiv()</a></span> 实现。
   <code class="literal">1/2</code> 产生出 <span class="type"><a href="language.types.float.php" class="type float">float</a></span>
   <code class="literal">0.5</code>。
   值可以舍弃小数部分，强制转换为 <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>，或者使用
   <span class="function"><a href="function.round.php" class="function">round()</a></span> 函数可以更好地进行四舍五入。
  </p>

  <div class="example" id="example-3">
   <p><strong>示例 #3 Divisions</strong></p>
   <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br />var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">25</span><span style="color: #007700">/</span><span style="color: #0000BB">7</span><span style="color: #007700">);         </span><span style="color: #FF8000">// float(3.5714285714286) <br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">((int) (</span><span style="color: #0000BB">25</span><span style="color: #007700">/</span><span style="color: #0000BB">7</span><span style="color: #007700">)); </span><span style="color: #FF8000">// int(3)<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">round</span><span style="color: #007700">(</span><span style="color: #0000BB">25</span><span style="color: #007700">/</span><span style="color: #0000BB">7</span><span style="color: #007700">));  </span><span style="color: #FF8000">// float(4) <br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

  </div>
 </div>

 <div class="sect2" id="language.types.integer.casting">
  <h3 class="title">转换为整型</h3>

  <p class="simpara">
   要明确地将一个值转换为 <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>，用 <code class="literal">(int)</code> 强制转换。
   不过大多数情况下都不需要强制转换，因为当运算符，函数或流程控制需要一个
   <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> 参数时，值会自动转换。还可以通过函数
   <span class="function"><a href="function.intval.php" class="function">intval()</a></span> 来将一个值转换成 <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> 整型。
  </p>

  <p class="simpara">
   将 <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> 转换成 <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> 时，
   结果会是 PHP 运行时为 <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> 分配的唯一资源号。
  </p>

  <p class="simpara">
   参见：<a href="language.types.type-juggling.php" class="link">类型转换的判别</a>。
  </p>
   
  <div class="sect3" id="language.types.integer.casting.from-boolean">
   <h4 class="title">从<a href="language.types.boolean.php" class="link">布尔值</a>转换</h4>

   <p class="simpara">
    <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> 将产生出 <code class="literal">0</code>（零），<strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong> 将产生出
    <code class="literal">1</code>（壹）。
   </p>
  </div>

  <div class="sect3" id="language.types.integer.casting.from-float">
   <h4 class="title">
    从<a href="language.types.float.php" class="link">浮点型</a>转换
   </h4> 

   <p class="simpara">
    当从浮点数 <span class="type"><a href="language.types.float.php" class="type float">float</a></span> 转换成整数 <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>时，将<em>向零</em>取整。自
    PHP 8.1.0 起，当将非整数类型的 <span class="type"><a href="language.types.float.php" class="type float">float</a></span> 转换为失去精度的 <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> 时，会发出弃用通知。
   </p>

   <div class="example" id="example-4">
    <p><strong>示例 #4 从浮点数转换</strong></p>
    <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #007700">function </span><span style="color: #0000BB">foo</span><span style="color: #007700">(</span><span style="color: #0000BB">$value</span><span style="color: #007700">): </span><span style="color: #0000BB">int </span><span style="color: #007700">{<br />  return </span><span style="color: #0000BB">$value</span><span style="color: #007700">; <br />}<br /><br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">foo</span><span style="color: #007700">(</span><span style="color: #0000BB">8.1</span><span style="color: #007700">)); </span><span style="color: #FF8000">// 自 PHP 8.1.0 起：“Deprecated: Implicit conversion from float 8.1 to int loses precision”<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">foo</span><span style="color: #007700">(</span><span style="color: #0000BB">8.1</span><span style="color: #007700">)); </span><span style="color: #FF8000">// PHP 8.1.0 之前为 8<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">foo</span><span style="color: #007700">(</span><span style="color: #0000BB">8.0</span><span style="color: #007700">)); </span><span style="color: #FF8000">// 均为 8<br /><br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">((int) </span><span style="color: #0000BB">8.1</span><span style="color: #007700">); </span><span style="color: #FF8000">// 均为 8<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">intval</span><span style="color: #007700">(</span><span style="color: #0000BB">8.1</span><span style="color: #007700">)); </span><span style="color: #FF8000">// 均为 8<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>

   <p class="para">
    如果浮点数超出了 <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> 范围（32 位平台下通常为
    <code class="literal">+/- 2.15e+9 = 2^31</code>，64 位平台下，通常为
    <code class="literal">+/- 9.22e+18 = 2^63</code>），则结果为未定义，
    因为没有足够的精度给出一个确切的 <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> 结果。
    在此情况下没有警告，甚至没有任何通知！
   </p>

   <blockquote class="note"><p><strong class="note">注意</strong>: 
    <p class="para">
     <code class="literal">NaN</code>、<code class="literal">Inf</code> 和 <code class="literal">-Inf</code> 在转换成 <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> 时是零。
    </p>
   </p></blockquote>
    
   <div class="warning"><strong class="warning">警告</strong>
    <p class="para">
     绝不要将未知的分数强制转换为 <span class="type"><a href="language.types.integer.php" class="type int">int</a></span>，这样有时会导致不可预料的结果。
    </p>

    <div class="informalexample">
     <div class="example-contents">
<div class="annotation-interactive phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">echo (int) ( (</span><span style="color: #0000BB">0.1</span><span style="color: #007700">+</span><span style="color: #0000BB">0.7</span><span style="color: #007700">) * </span><span style="color: #0000BB">10 </span><span style="color: #007700">); </span><span style="color: #FF8000">// 显示 7!<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

    </div>
    
    <p class="para">
     参见<a href="language.types.float.php#warn.float-precision" class="link">关于浮点数精度的警告</a>。
    </p>
   </div>
  </div>
   
  <div class="sect3" id="language.types.integer.casting.from-string">
   <h4 class="title">从字符串转换</h4>

   <p class="simpara">
    如果 string 是 <a href="language.types.numeric-strings.php" class="link">numeric</a> 或者前导数字，
    则将它解析为相应的 int 值，否则将转换为零（<code class="literal">0</code>）。
   </p>
  </div>
   
  <div class="sect3" id="language.types.integer.casting-from-null">
   <h4 class="title">从 <span class="type"><a href="language.types.null.php" class="type NULL">NULL</a></span> 转换</h4>

   <p class="simpara">
    <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong> 会转换为零（<code class="literal">0</code>）。
   </p>
  </div>

  <div class="sect3" id="language.types.integer.casting.from-other">
   <h4 class="title">从其它类型转换</h4>

   <div class="caution"><strong class="caution">警告</strong>
    <p class="simpara">
     没有定义从其它类型转换为 <span class="type"><a href="language.types.integer.php" class="type int">int</a></span> 的行为。
     <em>不要</em>依赖任何现有的行为，因为它会未加通知地改变。
    </p>
   </div>
  </div>

 </div>
</div><?php manual_footer($setup); ?>