Files
php-doc-ru/reference/xml/functions/utf8-decode.xml
2021-01-05 20:16:26 +03:00

123 lines
4.6 KiB
XML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 0c9c2dd669fe9395eaa73d487fbd160f9057429a Maintainer: tmn Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.utf8-decode">
<refnamediv>
<refname>utf8_decode</refname>
<refpurpose>
Преобразует строку с символами ISO-8859-1, кодированную в UTF-8,
в однобайтную ISO-8859-1
</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>string</type><methodname>utf8_decode</methodname>
<methodparam><type>string</type><parameter>string</parameter></methodparam>
</methodsynopsis>
<para>
Эта функция декодирует <parameter>string</parameter>, закодированные в
<literal>UTF-8</literal>, в <literal>ISO-8859-1</literal>. Байты строки, не корректные
для <literal>UTF-8</literal> и символы <literal>UTF-8</literal>, отсутствующие в
<literal>ISO-8859-1</literal> (то есть, символы выше <literal>U+00FF</literal>),
заменятся символом <literal>?</literal>.
</para>
<note>
<para>
Многие веб-страницы, отмеченные как использующие кодировку
<literal>ISO-8859-1</literal>, на самом деле используют схожую кодировку
<literal>Windows-1252</literal>, и веб-браузеры интерпретируют
страницы <literal>ISO-8859-1</literal> как <literal>Windows-1252</literal>.
Однако <literal>Windows-1252</literal> содержит дополнительные печатные
символы, такие как знак Евро (<literal></literal>) и фигурные кавычки
(<literal></literal> <literal></literal>) вместо управляющих кодов
<literal>ISO-8859-1</literal>. Эта функция не конвертирует такие символы
<literal>Windows-1252</literal> корректно. Используйте другую функцию,
если нужна конвертация в <literal>Windows-1252</literal>.
</para>
</note>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>string</parameter></term>
<listitem>
<para>
Строка, закодированная в UTF-8.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает данные <parameter>string</parameter>, переведённые в ISO-8859-1.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>7.2.0</entry>
<entry>
Эта функция была перенесена в ядро PHP, таким образом отменив требование расширения XML для использования этой функции.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>utf8_encode</function> (содержит описание UTF-8)</member>
<member><function>mb_convert_encoding</function> - Конвертирует между множеством различных кодировок, включая UTF-8, ISO-8859-1 and Windows-1252</member>
<member><function>iconv</function> - Конвертирует между множеством различных кодировок</member>
<member><function>recode_string</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
-->