<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/class.intlchar.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'ru',
  ),
  'this' => 
  array (
    0 => 'intlchar.digit.php',
    1 => 'IntlChar::digit',
    2 => 'Получает десятичное значение цифры кодовой точки в заданной системе счисления',
  ),
  'up' => 
  array (
    0 => 'class.intlchar.php',
    1 => 'IntlChar',
  ),
  'prev' => 
  array (
    0 => 'intlchar.chr.php',
    1 => 'IntlChar::chr',
  ),
  'next' => 
  array (
    0 => 'intlchar.enumcharnames.php',
    1 => 'IntlChar::enumCharNames',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'ru',
    'path' => 'reference/intl/intlchar/digit.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="intlchar.digit" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">IntlChar::digit</h1>
  <p class="verinfo">(PHP 7, PHP 8)</p><p class="refpurpose"><span class="refname">IntlChar::digit</span> &mdash; <span class="dc-title">Получает десятичное значение цифры кодовой точки в заданной системе счисления</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-intlchar.digit-description">
  <h3 class="title">Описание</h3>
  <div class="methodsynopsis dc-description">
   <span class="modifier">public</span> <span class="modifier">static</span> <span class="methodname"><strong>IntlChar::digit</strong></span>(<span class="methodparam"><span class="type"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span>|<span class="type"><a href="language.types.string.php" class="type string">string</a></span></span> <code class="parameter">$codepoint</code></span>, <span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$base</code><span class="initializer"> = 10</span></span>): <span class="type"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span>|<span class="type"><a href="language.types.singleton.php" class="type false">false</a></span>|<span class="type"><a href="language.types.null.php" class="type null">null</a></span></span></div>

  <p class="para rdfs-comment">
   Метод возвращает десятичное значение цифры — символа, которым записывают числа
   и который присвоили кодовой точке Юникода,
   в заданной системе счисления.
  </p>
  <p class="para">
   Метод возвращает <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>, если основание системы счисления не входит
   в диапазон <code class="literal">2 &lt;= radix &lt;= 36</code>
   или если символ, который кодируется кодовой точкой <code class="parameter">codepoint</code>, —
   недопустимая цифра для заданного основания.
   Метод признаёт символ корректной цифрой, если выполняется хотя бы одно условие:
   <ul class="simplelist">
    <li>
     Символ — цифра, которая несёт значение числа десятичной системы счисления.
     Такие символы входят в общую категорию — "Nd" (десятичные числа)
     и содержат в свойстве Numeric_Type значение "Decimal".
     Значением такого символа будет десятичное число, значение которого несёт цифра десятичной системы счисления.
    </li>
    <li>
     Символ — заглавная латинская буква в диапазоне от "A" до "Z".
     Метод вычисляет значение возврата по формуле:
     номер заданного символа в таблице - номер кодовой точки символа 'A' + 10.
    </li>
    <li>
     Символ — строчная латинская буква в диапазоне от 'a' до 'z'.
     Метод вычисляет значение возврата по формуле:
     номер заданного символа в таблице - номер кодовой точки символа 'a' + 10.
    </li>
    <li>
     Метод распознал латинские буквы из диапазонов 0041..005A (a..z) и 0061..007A (A..Z)
     стандартного набора ASCII-символов или из диапазонов
     FF41..FF5A (a..z) и FF21..FF3A (A..Z) расширенного набора символов кодировки ASCII.
    </li>
   </ul>
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-intlchar.digit-parameters">
  <h3 class="title">Список параметров</h3>
  <dl>
   
    <dt><code class="parameter">codepoint</code></dt>
    <dd>
     <p class="para">
Целочисленное (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>) значение кодовой точки (например, <code class="literal">0x2603</code>
для символа <em>U+2603 СНЕГОВИК</em>) или символ в виде
строки (<span class="type"><a href="language.types.string.php" class="type string">string</a></span>) в кодировке UTF-8 (например <code class="literal">&quot;\u{2603}&quot;</code>).
</p>

    </dd>
   
   
    <dt><code class="parameter">base</code></dt>
    <dd>
     <p class="para">
      Основание (значение по умолчанию равно <code class="literal">10</code>).
     </p>
    </dd>
   
  </dl>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-intlchar.digit-returnvalues">
  <h3 class="title">Возвращаемые значения</h3>
  <p class="para">
   Метод возвращает числовое значение символа в заданной системе счисления,
   или <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>, если символ не обозначает число с заданным основанием или выходит за рамки основания.
   Метод возвращает <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong>, если возникла ошибка.
  </p>
  <div class="warning"><strong class="warning">Внимание</strong><p class="simpara">Функция
возвращает как логическое значение <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>,
так и нелогическое значение, которое приводится к <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>.
Прочитайте раздел
«<a href="language.types.boolean.php" class="link">Логический тип</a>»,
чтобы получить дополнительную информацию.
Используйте <a href="language.operators.comparison.php" class="link">оператор ===</a>
для проверки значения, которое возвращает функция.</p></div>

 </div>


 <div class="refsect1 examples" id="refsect1-intlchar.digit-examples">
  <h3 class="title">Примеры</h3>
  <div class="example" id="example-1">
   <p><strong>Пример #1 Пример проверки кодовых точек</strong></p>
   <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br />var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">IntlChar</span><span style="color: #007700">::</span><span style="color: #0000BB">digit</span><span style="color: #007700">(</span><span style="color: #DD0000">"0"</span><span style="color: #007700">));<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">IntlChar</span><span style="color: #007700">::</span><span style="color: #0000BB">digit</span><span style="color: #007700">(</span><span style="color: #DD0000">"3"</span><span style="color: #007700">));<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">IntlChar</span><span style="color: #007700">::</span><span style="color: #0000BB">digit</span><span style="color: #007700">(</span><span style="color: #DD0000">"A"</span><span style="color: #007700">));<br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">IntlChar</span><span style="color: #007700">::</span><span style="color: #0000BB">digit</span><span style="color: #007700">(</span><span style="color: #DD0000">"A"</span><span style="color: #007700">, </span><span style="color: #0000BB">16</span><span style="color: #007700">));<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
   </div>

   
<div class="example-contents"><p>
 Результат выполнения приведённого примера:
</p></div>

   <div class="example-contents screen">
<div class="examplescode"><pre class="examplescode">int(0)
int(3)
bool(false)
int(10)</pre>
</div>
   </div>
  </div>
 </div>


 <div class="refsect1 seealso" id="refsect1-intlchar.digit-seealso">
  <h3 class="title">Смотрите также</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="function"><a href="intlchar.fordigit.php" class="function" rel="rdfs-seeAlso">IntlChar::forDigit()</a> - Получает кодовую точку символьного представления числа в заданной системе счисления</span></li>
    <li><span class="function"><a href="intlchar.chardigitvalue.php" class="function" rel="rdfs-seeAlso">IntlChar::charDigitValue()</a> - Получает десятичное значение десятичного символа</span></li>
    <li><span class="function"><a href="intlchar.isdigit.php" class="function" rel="rdfs-seeAlso">IntlChar::isdigit()</a> - Проверяет, относится ли кодовая точка к символам цифр</span></li>
    <li><strong><code><a href="class.intlchar.php#intlchar.constants.property-numeric-type">IntlChar::PROPERTY_NUMERIC_TYPE</a></code></strong></li>
   </ul>
  </p>
 </div>


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