reference/iconv/functions/iconv-mime-decode-headers.xml
16a1bdfd1c36108534b5af08dc4b751c7ac0fdaf
...
...
@@ -9,10 +9,10 @@
9
9
<refsect1 role="description">
10
10
&reftitle.description;
11
11
<methodsynopsis>
12
-
<type>array</type><methodname>iconv_mime_decode_headers</methodname>
13
-
<methodparam><type>string</type><parameter>encoded_headers</parameter></methodparam>
12
+
<type class="union"><type>array</type><type>false</type></type><methodname>iconv_mime_decode_headers</methodname>
13
+
<methodparam><type>string</type><parameter>headers</parameter></methodparam>
14
14
<methodparam choice="opt"><type>int</type><parameter>mode</parameter><initializer>0</initializer></methodparam>
15
-
<methodparam choice="opt"><type>string</type><parameter>charset</parameter><initializer>ini_get("iconv.internal_encoding")</initializer></methodparam>
15
+
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
16
16
</methodsynopsis>
17
17
<para>
18
18
Decodes multiple <literal>MIME</literal> header fields at once.
...
...
@@ -24,7 +24,7 @@
24
24
<para>
25
25
<variablelist>
26
26
<varlistentry>
27
-
<term><parameter>encoded_headers</parameter></term>
27
+
<term><parameter>headers</parameter></term>
28
28
<listitem>
29
29
<para>
30
30
The encoded headers, as a string.
...
...
@@ -77,11 +77,11 @@
77
77
</listitem>
78
78
</varlistentry>
79
79
<varlistentry>
80
-
<term><parameter>charset</parameter></term>
80
+
<term><parameter>encoding</parameter></term>
81
81
<listitem>
82
82
<para>
83
-
The optional <parameter>charset</parameter> parameter specifies the
84
-
character set to represent the result by. If omitted,
83
+
The optional <parameter>encoding</parameter> parameter specifies the
84
+
character set to represent the result by. If omitted or &null;,
85
85
<link linkend="iconv.configuration">iconv.internal_encoding</link>
86
86
will be used.
87
87
</para>
...
...
@@ -96,7 +96,7 @@
96
96
<para>
97
97
Returns an associative array that holds a whole set of
98
98
<literal>MIME</literal> header fields specified by
99
-
<parameter>encoded_headers</parameter> on success, or &false;
99
+
<parameter>headers</parameter> on success, or &false;
100
100
if an error occurs during the decoding.
101
101
</para>
102
102
<para>
...
...
@@ -105,9 +105,32 @@
105
105
If more than one field of the same name are present,
106
106
<function>iconv_mime_decode_headers</function> automatically incorporates
107
107
them into a numerically indexed array in the order of occurrence.
108
+
Note that header names are not <emphasis>case-insensitive</emphasis>.
108
109
</para>
109
110
</refsect1>
110
111

112
+
<refsect1 role="changelog">
113
+
&reftitle.changelog;
114
+
<informaltable>
115
+
<tgroup cols="2">
116
+
<thead>
117
+
<row>
118
+
<entry>&Version;</entry>
119
+
<entry>&Description;</entry>
120
+
</row>
121
+
</thead>
122
+
<tbody>
123
+
<row>
124
+
<entry>8.0.0</entry>
125
+
<entry>
126
+
<parameter>encoding</parameter> is nullable now.
127
+
</entry>
128
+
</row>
129
+
</tbody>
130
+
</tgroup>
131
+
</informaltable>
132
+
</refsect1>
133
+

111
134
<refsect1 role="examples">
112
135
&reftitle.examples;
113
136
<para>
...
...
@@ -170,7 +193,6 @@ Array
170
193
</refsect1>
171
194

172
195
</refentry>
173
-

174
196
<!-- Keep this comment at the end of the file
175
197
Local variables:
176
198
mode: sgml
177
199