<?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 之间（包括 2 和 36）。高于十进制的数字用字母 a-z 表示，例如

a 表示 10，b 表示 11 以及 z 表示 35。字母的大小无关紧要，即 <parameter>num</parameter>

不区分大小写。

</para>

<warning>

<simpara>

由于使用内部的 <type>float</type> 类型，<function>base_convert</function>

的操作可能会导致大数值中的精度丢失。请参见本手册的<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>