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

<!-- $Revision$ -->

<!-- EN-Revision: 5b3fc18be040c1d552da1497415b20296163012f Maintainer: PhilDaiguille Status: ready -->

<!-- Reviewed: yes Maintainer: Marqitos -->

<refentry xml:id="function.mb-internal-encoding" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

<refnamediv>

<refname>mb_internal_encoding</refname>

<refpurpose>Lee/modifica la codificación interna</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type class="union"><type>string</type><type>bool</type></type><methodname>mb_internal_encoding</methodname>

<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>

</methodsynopsis>

<para>

Lee/modifica la codificación interna.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>encoding</parameter></term>

<listitem>

<para>

<parameter>encoding</parameter> se utiliza durante las conversiones de

strings provenientes y dirigidas hacia la web, así como durante la creación de strings con el módulo mbstring. Se debe tener en cuenta que la codificación interna es completamente diferente

de la de las regex multioctetos.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Si <parameter>encoding</parameter> es proporcionado,

&return.success;

En este caso, la codificación de caracteres para las regex multioctetos

no se cambia. Si <parameter>encoding</parameter>

es omitido, <function>mb_internal_encoding</function> devuelve el

nombre de la codificación actual.

</para>

</refsect1>

<refsect1 role="errors">

&reftitle.errors;

<para>

A partir de PHP 8.0.0, se lanza una <classname>ValueError</classname> si el valor

de <parameter>encoding</parameter> es una codificación inválida.

Anterior a PHP 8.0.0, se emitía una <constant>E_WARNING</constant> en su lugar.

</para>

</refsect1>

<refsect1 role="changelog">

&reftitle.changelog;

<informaltable>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

&mbstring.changelog.encoding-nullable;

<row>

<entry>8.0.0</entry>

<entry>

Ahora lanza una <classname>ValueError</classname> si

<parameter>encoding</parameter> es una codificación inválida.

Anteriormente, se emitía una <constant>E_WARNING</constant> en su lugar.

</entry>

</row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title>Ejemplo con <function>mb_internal_encoding</function></title>

<programlisting role="php">

<![CDATA[

<?php

/* Utiliza la codificación interna UTF-8 */

mb_internal_encoding("UTF-8");

/* Muestra la codificación interna actual */

echo mb_internal_encoding();

?>

]]>

</programlisting>

</example>

</para>

</refsect1>

<!--

<refsect1 role="notes">

&reftitle.notes;

</refsect1>

-->

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>mb_http_input</function></member>

<member><function>mb_http_output</function></member>

<member><function>mb_detect_order</function></member>

<member><function>mb_regex_encoding</function></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

-->