IntlChar::digit

(PHP 7, PHP 8)

IntlChar::digitПолучает десятичное значение цифры кодовой точки в заданной системе счисления

Описание

public static IntlChar::digit(int|string $codepoint, int $base = 10): int|false|null

Метод возвращает десятичное значение цифры — символа, которым записывают числа и который присвоили кодовой точке Юникода, в заданной системе счисления.

Метод возвращает false, если основание системы счисления не входит в диапазон 2 <= radix <= 36 или если символ, который кодируется кодовой точкой codepoint, — недопустимая цифра для заданного основания. Метод признаёт символ корректной цифрой, если выполняется хотя бы одно условие:

  • Символ — цифра, которая несёт значение числа десятичной системы счисления. Такие символы входят в общую категорию — "Nd" (десятичные числа) и содержат в свойстве Numeric_Type значение "Decimal". Значением такого символа будет десятичное число, значение которого несёт цифра десятичной системы счисления.
  • Символ — заглавная латинская буква в диапазоне от "A" до "Z". Метод вычисляет значение возврата по формуле: номер заданного символа в таблице - номер кодовой точки символа 'A' + 10.
  • Символ — строчная латинская буква в диапазоне от 'a' до 'z'. Метод вычисляет значение возврата по формуле: номер заданного символа в таблице - номер кодовой точки символа 'a' + 10.
  • Метод распознал латинские буквы из диапазонов 0041..005A (a..z) и 0061..007A (A..Z) стандартного набора ASCII-символов или из диапазонов FF41..FF5A (a..z) и FF21..FF3A (A..Z) расширенного набора символов кодировки ASCII.

Список параметров

codepoint

Целочисленное (int) значение кодовой точки (например, 0x2603 для символа U+2603 СНЕГОВИК) или символ в виде строки (string) в кодировке UTF-8 (например "\u{2603}").

base

Основание (значение по умолчанию равно 10).

Возвращаемые значения

Метод возвращает числовое значение символа в заданной системе счисления, или false, если символ не обозначает число с заданным основанием или выходит за рамки основания. Метод возвращает null, если возникла ошибка.

Внимание

Функция возвращает как логическое значение false, так и нелогическое значение, которое приводится к false. Прочитайте раздел «Логический тип», чтобы получить дополнительную информацию. Используйте оператор === для проверки значения, которое возвращает функция.

Примеры

Пример #1 Пример проверки кодовых точек

<?php

var_dump
(IntlChar::digit("0"));
var_dump(IntlChar::digit("3"));
var_dump(IntlChar::digit("A"));
var_dump(IntlChar::digit("A", 16));

?>

Результат выполнения приведённого примера:

int(0)
int(3)
bool(false)
int(10)

Смотрите также

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top