<?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>Convierte un número entre bases arbitrarias</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>

Devuelve un string que contiene el argumento <parameter>num</parameter>

representado en la base <parameter>to_base</parameter>. La base de

representación de <parameter>number</parameter> es dada por

<parameter>from_base</parameter>. <parameter>from_base</parameter> y

<parameter>to_base</parameter> deben estar comprendidos entre 2 y 36 inclusive.

Los dígitos superiores a 10 de las bases superiores a 10 serán representados

por las letras de A a Z, con A = 10 y Z = 35.

El caso de las letras no tiene importancia, es decir

<parameter>num</parameter> es interpretado de forma insensible al caso.

</para>

<warning>

<simpara>

<function>base_convert</function> perderá la precisión sobre los grandes números,

debido a las propiedades internas del tipo <type>float</type> utilizado.

Leer la sección sobre los

<link linkend="language.types.float">números decimales</link> de

este manual para más información.

</simpara>

</warning>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

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

<listitem>

<para>

El número a convertir.

Cualquier carácter inválido en <parameter>num</parameter> es

ignorado silenciosamente.

A partir de PHP 7.4.0 proporcionar caracteres inválidos es obsoleto.

</para>

</listitem>

</varlistentry>

<varlistentry>

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

<listitem>

<para>

La base <parameter>num</parameter> en la que está

</para>

</listitem>

</varlistentry>

<varlistentry>

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

<listitem>

<para>

La base en la que se debe convertir el número

<parameter>num</parameter>

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

El número <parameter>num</parameter> convertido en la base <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>

Pasar caracteres inválidos generará ahora una advertencia obsoleta.

El resultado siempre será calculado como si los caracteres inválidos

no existieran.

</entry>

</row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title>Ejemplo con <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>