git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@121806 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Moriyoshi Koizumi 2003-03-31 20:25:57 +00:00
parent ea09039617
commit cbf94b8d1c
3 changed files with 27 additions and 19 deletions

View file

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.2 $ -->
<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/imap.xml, last change in rev 1.16 -->
<refentry id="function.imap-utf7-decode">
<refnamediv>
@ -15,14 +15,18 @@
<methodparam><type>string</type><parameter>text</parameter></methodparam>
</methodsynopsis>
<para>
Decodes modified UTF-7 <parameter>text</parameter> into 8bit data.
Decodes modified UTF-7 <parameter>text</parameter> into ISO-8859-1 string.
</para>
<para>
Returns the decoded 8bit data, or &false; if the input string was
not valid modified UTF-7. This function is needed to decode
mailbox names that contain international characters outside of
the printable ASCII range. The modified UTF-7 encoding is defined
in <ulink url="&url.rfc;rfc2060.html">RFC 2060</ulink>, section
Returns a string that is encoded in ISO-8859-1 and consists of the same
sequence of characters in <parameter>text</parameter>, or &false;
if <parameter>text</parameter> contains invalid modified UTF-7 sequence
or <parameter>text</parameter> contains a character that is not part of
ISO-8859-1 character set.
This function is needed to decode mailbox names that contain certain
characters which are not in range of printable ASCII characters.
The modified UTF-7 encoding is defined in
<ulink url="&url.rfc;rfc2060.html">RFC 2060</ulink>, section
5.1.3 (original UTF-7 was defned in <ulink
url="&url.rfc;rfc1642.html">RFC1642</ulink>).
</para>

View file

@ -1,11 +1,11 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.2 $ -->
<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/imap.xml, last change in rev 1.9 -->
<refentry id="function.imap-utf7-encode">
<refnamediv>
<refname>imap_utf7_encode</refname>
<refpurpose>
Converts 8bit data to modified UTF-7 text.
Converts ISO-8859-1 string to modified UTF-7 text.
</refpurpose>
</refnamediv>
<refsect1>
@ -15,10 +15,11 @@
<methodparam><type>string</type><parameter>data</parameter></methodparam>
</methodsynopsis>
<para>
Converts 8bit <parameter>data</parameter> to modified UTF-7
text. This is needed to encode mailbox names that contain
international characters outside of the printable ASCII
range. The modified UTF-7 encoding is defined in <ulink
Converts <parameter>data</parameter> to modified UTF-7
text. This is needed to encode mailbox names that contain certain
characters which are not in range of printable ASCII characters.
Note that <parameter>data</parameter> is expected to be
encoded in ISO-8859-1. The modified UTF-7 encoding is defined in <ulink
url="&url.rfc;rfc2060.html">RFC 2060</ulink>, section 5.1.3
(original UTF-7 was defned in <ulink
url="&url.rfc;rfc1642.html">RFC1642</ulink>).

View file

@ -1,23 +1,26 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.2 $ -->
<!-- $Revision: 1.3 $ -->
<!-- splitted from ./en/functions/imap.xml, last change in rev 1.7 -->
<refentry id="function.imap-utf8">
<refnamediv>
<refname>imap_utf8</refname>
<refpurpose>
Converts text to UTF8
Converts MIME-encoded text to UTF-8
</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>string</type><methodname>imap_utf8</methodname>
<methodparam><type>string</type><parameter>text</parameter></methodparam>
<methodparam>
<type>string</type><parameter>mime_encoded_text</parameter>
</methodparam>
</methodsynopsis>
<para>
Converts the given <parameter>text</parameter> to
UTF8 (as defined in
<ulink url="&url.rfc;rfc2044.html">RFC2044</ulink>).
Converts the given <parameter>mime_encoded_text</parameter> to
UTF-8. MIME encoding method and the UTF-8 specification are described in
<ulink url="&url.rfc;rfc2047.html">RFC2047</ulink> and
<ulink url="&url.rfc;rfc2044.html">RFC2044</ulink> respectively.
</para>
</refsect1>
</refentry>