-
Notifications
You must be signed in to change notification settings - Fork 58
/
iconv.xml
160 lines (151 loc) · 5.01 KB
/
iconv.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: a223531900823441f82d178ca4e94c0444f24576 Maintainer: hirokawa Status: ready -->
<!-- CREDITS: takagi,mumumu -->
<refentry xml:id="function.iconv" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>iconv</refname>
<refpurpose>ある文字エンコーディングの文字列を、別の文字エンコーディングに変換する</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>string</type><type>false</type></type><methodname>iconv</methodname>
<methodparam><type>string</type><parameter>from_encoding</parameter></methodparam>
<methodparam><type>string</type><parameter>to_encoding</parameter></methodparam>
<methodparam><type>string</type><parameter>string</parameter></methodparam>
</methodsynopsis>
<para>
文字列 <parameter>string</parameter>
の文字セットを <parameter>from_encoding</parameter>
から <parameter>to_encoding</parameter> に変換します。
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>from_encoding</parameter></term>
<listitem>
<para>
<parameter>string</parameter> の解釈に使われる文字セット。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>to_encoding</parameter></term>
<listitem>
<para>
変換したいエンコーディング。
</para>
<para>
文字列 <literal>//TRANSLIT</literal> を <parameter>to_encoding</parameter>
に追加すると、翻字機能が有効になります。これは、指定された文字集合で
表せない文字を、見た目の似ている別の文字に置き換える機能です。
文字列 <literal>//IGNORE</literal> を追加すると、指定された文字集合で
表せない文字は黙って切り捨てられます。
それ以外の場合は <constant>E_NOTICE</constant> が発生し、この関数は &false; を返します。
</para>
<caution>
<para>
<literal>//TRANSLIT</literal> が機能したとしたら、
どう動くかはシステムの iconv() の実装
(<constant>ICONV_IMPL</constant> を参照) に依存します。
実装によっては、<literal>//TRANSLIT</literal> を無視することが知られています。
よって、<parameter>to_encoding</parameter> において無効な文字に対しては、
変換処理は失敗するかもしれません。
</para>
</caution>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>string</parameter></term>
<listitem>
<para>
変換する文字列。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
変換された文字列を返します。
&return.falseforfailure;。
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>iconv</function> の例</title>
<programlisting role="php">
<![CDATA[
<?php
$text = "This is the Euro symbol '?'.";
echo 'Original : ', $text, PHP_EOL;
echo 'TRANSLIT : ', iconv("UTF-8", "ISO-8859-1//TRANSLIT", $text), PHP_EOL;
echo 'IGNORE : ', iconv("UTF-8", "ISO-8859-1//IGNORE", $text), PHP_EOL;
echo 'Plain : ', iconv("UTF-8", "ISO-8859-1", $text), PHP_EOL;
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
Original : This is the Euro symbol '?'.
TRANSLIT : This is the Euro symbol 'EUR'.
IGNORE : This is the Euro symbol ''.
Plain :
Notice: iconv(): Detected an illegal character in input string in .\iconv-example.php on line 7
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<para>
文字エンコーディングと、指定できるオプションは、
インストールされている iconv の実装に依存します。
<parameter>from_encoding</parameter>
や <parameter>to_encoding</parameter>
が現在のシステムでサポートされていない場合は、
&false; を返します。
</para>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>mb_convert_encoding</function></member>
<member><methodname>UConverter::transcode</methodname></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
-->