php8.5
Home/ Manual/ intl / intlchar/ IntlChar::digit

IntlChar::digit

PHP function Edit on GitHub ✎

(PHP 7, PHP 8)

Get the decimal digit value of a code point for a given radix

Description

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

Returns the decimal digit value of the code point in the specified radix.

If the radix is not in the range 2 <= radix <= 36 or if the value of codepoint is not a valid digit in the specified radix, false is returned. A character is a valid digit if at least one of the following is true:

  • The character has a decimal digit value. Such characters have the general category "Nd" (decimal digit numbers) and a Numeric_Type of "Decimal". In this case the value is the character's decimal digit value.
  • The character is one of the uppercase Latin letters 'A' through 'Z'. In this case the value is codepoint - 'A' + 10.
  • The character is one of the lowercase Latin letters 'a' through 'z'. In this case the value is codepoint - 'a' + 10.
  • Latin letters from both the ASCII range (0061..007A, 0041..005A) as well as from the Fullwidth ASCII range (FF41..FF5A, FF21..FF3A) are recognized.

Parameters

codepoint

Parameter

base

The radix (defaults to 10).

Return Values

Returns the numeric value represented by the character in the specified radix, or false if there is no value or if the value exceeds the radix. Returns null on failure.

Falseproblem

Examples

Example

php
<?php

var_dump(IntlChar::digit("0"));
var_dump(IntlChar::digit("3"));

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

?>

The above example will output:

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

See Also

Source: reference/intl/intlchar/digit.xml · from the official PHP manual (php/doc-en)