archived-doc-ru/language/types/numeric-strings.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e587d0655e426f97b3fcb431453da5030e743b23 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<sect1 xml:id="language.types.numeric-strings" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>Числовые строки</title>
 <para>
  PHP считает строку (<type>string</type>) числовой, если строку возможно интерпретировать как целое
  число (<type>int</type>) или как число с плавающей точкой (<type>float</type>).
 </para>

 <para>
  Формально с PHP 8.0.0:
 </para>

 <informalexample>
  <programlisting>
<![CDATA[
WHITESPACES      \s*
LNUM             [0-9]+
DNUM             ([0-9]*[\.]{LNUM}) | ({LNUM}[\.][0-9]*)
EXPONENT_DNUM    (({LNUM} | {DNUM}) [eE][+-]? {LNUM})
INT_NUM_STRING   {WHITESPACES} [+-]? {LNUM} {WHITESPACES}
FLOAT_NUM_STRING {WHITESPACES} [+-]? ({DNUM} | {EXPONENT_DNUM}) {WHITESPACES}
NUM_STRING       ({INT_NUM_STRING} | {FLOAT_NUM_STRING})
]]>
  </programlisting>
 </informalexample>

 <para>
  В PHP также поддерживается концепция <emphasis>префиксной</emphasis> числовой строки.
  Это строка, которая начинается как числовая и продолжается любыми другими символами.
 </para>

 <note>
  <para>
   Строка, которая содержит букву <literal>E</literal> (без учёта регистра),
   ограниченную цифрами, воспринимается как число, которое выразили в научной нотации.
   Поведение при сравнении строк с числами в научной нотации иногда кажется неожиданным.
  </para>
  <example>
   <title>Сравнение строк с числами в научной нотации</title>
   <programlisting role="php">
<![CDATA[
<?php

var_dump("0D1" == "000"); // false, "0D1" — не научная нотация
var_dump("0E1" == "000"); // true, "0E1" интерпретируется как выражение 0 * (10 ^ 1), которое равно значению 0
var_dump("2E1" == "020"); // true, "2E1" интерпретируется как выражение 2 * (10 ^ 1), которое равно значению 20

?>
]]>
   </programlisting>
  </example>
 </note>

 <sect2 xml:id="language.types.numeric-string.conversion">
  <title>Строки в числовых контекстах</title>
  <para>
   Когда строку необходимо использовать как число (например арифметические операции, декларация
   целочисленного типа, и т. д.), применяют следующий алгоритм действий:
   <orderedlist>
    <listitem>
     <simpara>
      Строка приводится к типу <type>int</type>, если строка числовая, представляет целое число и не превышает максимально
      допустимого значения для типа <type>int</type>, которое определяет
      константа <constant>PHP_INT_MAX</constant>, иначе строка приводится к типу <type>float</type>.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Тип <type>string</type> приводится к типу <type>int</type>, если контекст разрешает строки,
      которые начинаются с числа, и значение <type>string</type>
      начинается с целочисленной числовой части, которая не превышает значение константы <constant>PHP_INT_MAX</constant>,
      которая определяет в PHP наибольшее значение для типа <type>int</type>,
      иначе строка разрешается
      в тип <type>float</type> и дополнительно выдаёт ошибку
      уровня <constant>E_WARNING</constant>.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Для нечисловых строк выбрасывается ошибка <classname>TypeError</classname>.
     </simpara>
    </listitem>
   </orderedlist>
  </para>
 </sect2>

 <sect2 xml:id="language.types.numeric-string.prior">
  <title>Поведение до PHP 8.0.0</title>
  <para>
   До PHP 8.0.0 строка считалась числовой, только если она
   <emphasis>начиналась</emphasis> с пробельных символов. PHP считал строку префиксной числовой,
   если строка <emphasis>завершалась</emphasis> пробельными символами.
  </para>

  <para>
   До PHP 8.0.0 при работе со строкой как с числом применялся приведённый алгоритм,
   но с рядом отличий:
   <itemizedlist>
    <listitem>
     <simpara>
      Использование префиксной числовой строки вызывало ошибку уровня
      <constant>E_NOTICE</constant>, а не <constant>E_WARNING</constant>.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Нечисловые строки вызывали ошибку уровня <constant>E_WARNING</constant>,
      а сама строка приводилась к числу <literal>0</literal>.
     </simpara>
    </listitem>
   </itemizedlist>
   До PHP 7.1.0 не вызывалась ошибка ни уровня <constant>E_NOTICE</constant>,
   ни уровня <constant>E_WARNING</constant>.
  </para>

  <informalexample>
   <programlisting role="php">
<![CDATA[
<?php

$foo = 1 + "10.5";                // Переменная $foo — число с плавающей точкой (11.5)
$foo = 1 + "-1.3e3";              // Переменная $foo — число с плавающей точкой (-1299)
$foo = 1 + "bob-1.3e3";           // TypeError начиная с PHP 8.0.0. Ранее $foo принималось за целое число (1)
$foo = 1 + "bob3";                // TypeError начиная с PHP 8.0.0, Ранее $foo принималось за целое число (1)
$foo = 1 + "10 Small Pigs";       // Переменная $foo — целое (11). В PHP 8.0.0 выдаётся ошибка уровня E_WARNING, а в более ранних версиях — уровня E_NOTICE
$foo = 4 + "10.2 Little Piggies"; // Переменная $foo — число с плавающей точкой (14.2). В PHP 8.0.0 выдаётся ошибка уровня E_WARNING, а в более ранних версиях — уровня E_NOTICE
$foo = "10.0 pigs " + 1;          // Переменная $foo — число с плавающей точкой (11). В PHP 8.0.0 выдаётся ошибка уровня E_WARNING, а в более ранних версиях — уровня E_NOTICE
$foo = "10.0 pigs " + 1.0;        // Переменная $foo — число с плавающей точкой (11). В PHP 8.0.0 выдаётся ошибка уровня E_WARNING, а в более ранних версиях — уровня E_NOTICE

?>
]]>
   </programlisting>
  </informalexample>
 </sect2>
</sect1><!-- 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
-->