1
0
mirror of https://github.com/php/doc-es.git synced 2026-03-24 07:22:16 +01:00
Files
archived-doc-es/reference/mbstring/functions/mb-internal-encoding.xml
2025-04-01 17:17:30 +02:00

146 lines
4.0 KiB
XML

<?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
-->