<?xml version="1.0" encoding="utf-8"?>

<refentry xml:id="function.base-convert" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>base_convert</refname>

<refpurpose>Преобразовывает числа между произвольными системами счисления</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type>string</type><methodname>base_convert</methodname>

<methodparam><type>string</type><parameter>num</parameter></methodparam>

<methodparam><type>int</type><parameter>from_base</parameter></methodparam>

<methodparam><type>int</type><parameter>to_base</parameter></methodparam>

</methodsynopsis>

<para>

Возвращает в виде строки число <parameter>num</parameter>,

которое функция переведёт в систему счисления <parameter>to_base</parameter>. Систему счисления

числа <parameter>num</parameter> указывают в параметре <parameter>from_base</parameter>.

Значения <parameter>from_base</parameter> и <parameter>to_base</parameter>

должны быть между 2 и 36 включительно. Цифры в числах с основанием системы счисления

выше 10 функция представит буквами a-z, где «a» означает 10,

«b» означает 11, а «z» — 35. Регистр букв не важен, значение параметра <parameter>num</parameter>

интерпретируется регистронезависимо.

</para>

<warning>

<simpara>

Функция <function>base_convert</function> может потерять точность представления больших чисел

из-за свойств, связанных с внутренним представлением чисел с плавающей точкой (<type>float</type>).

Подробнее о специфике данных типов и их

ограничениях рассказано в разделе «<link linkend="language.types.float">Числа с плавающей точкой</link>».

</simpara>

</warning>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>num</parameter></term>

<listitem>

<para>

Число для преобразования. Любой недопустимый символ в значении параметра <parameter>num</parameter>

будет проигнорирован без предупреждения.

С PHP 7.4.0 предоставление любых недопустимых символов устарело.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>from_base</parameter></term>

<listitem>

<para>

Основание системы счисления числа <parameter>num</parameter>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>to_base</parameter></term>

<listitem>

<para>

Основание системы счисления, в которую будет преобразовано число <parameter>num</parameter>.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Возвращает число <parameter>num</parameter>,

преобразованное в систему счисления <parameter>to_base</parameter>.

</para>

</refsect1>

<refsect1 role="changelog">

&reftitle.changelog;

<informaltable>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

<row>

<entry>7.4.0</entry>

<entry>

Передача недопустимых символов будет генерировать уведомление об устаревании.

Результат будет вычислен так, как если бы недопустимые символы не существовали.

</entry>

</row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title>Пример использования функции <function>base_convert</function></title>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>intval</function></member>

</simplelist>

</para>

</refsect1>

</refentry>