Files
php-doc-ru/reference/intl/intlchar/fordigit.xml
2024-07-26 21:04:51 +03:00

133 lines
4.5 KiB
XML
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: a3f969dec396b34305821ae5262788dfc0e1b69d Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="intlchar.fordigit" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>IntlChar::forDigit</refname>
<refpurpose>Получает кодовую точку символьного представления числа в заданной системе счисления</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="IntlChar">
<modifier>public</modifier> <modifier>static</modifier> <type>int</type><methodname>IntlChar::forDigit</methodname>
<methodparam><type>int</type><parameter>digit</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>base</parameter><initializer>10</initializer></methodparam>
</methodsynopsis>
<para>
Метод определяет кодовую точку цифры в заданной системе счисления.
</para>
<para>
Метод возвращает NUL-символ с кодовой точкой <literal>U+0000</literal>,
если значение основания недопустимо или значение цифры недопустимо в заданной системе
счисления.
</para>
<para>
Допустимые значения оснований лежат в диапазоне
от <literal>2</literal> до <literal>36</literal> включительно.
Допустимые значения цифр лежат в диапазоне <literal>0 &lt;= digit &lt; radix</literal>.
</para>
<para>
Метод возвращает значение, которое вычисляет по формуле:
десятичное значение кодовой точки символа 0 + заданное число,
если основание меньше <literal>10</literal>.
В остальных случаях метод возвращает значения по формуле:
десятичное значение кодовой точки символа 'a' + заданное число - 10.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
<term><parameter>digit</parameter></term>
<listitem>
<para>
Число, которое метод преобразует в символ, кодовую точку которого определит.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>base</parameter></term>
<listitem>
<para>
Основание системы счисления (значение по умолчанию равно <literal>10</literal>).
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Метод возвращает порядковый номер (<type>int</type>), который назначили символу — цифре,
которая обозначает заданное число в заданной системе счисления.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>&intl.codepoint.example;</title>
<programlisting role="php">
<![CDATA[
<?php
var_dump(IntlChar::forDigit(0));
var_dump(IntlChar::forDigit(3));
var_dump(IntlChar::forDigit(3, 10));
var_dump(IntlChar::forDigit(10));
var_dump(IntlChar::forDigit(10, 16));
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
int(48)
int(51)
int(51)
int(0)
int(97)
]]>
</screen>
</example>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>IntlChar::digit</function></member>
<member><function>IntlChar::charDigitValue</function></member>
<member><function>IntlChar::isdigit</function></member>
<member><constant>IntlChar::PROPERTY_NUMERIC_TYPE</constant></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- 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
-->