-
Notifications
You must be signed in to change notification settings - Fork 56
/
iconv-strpos.xml
153 lines (147 loc) · 4.73 KB
/
iconv-strpos.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
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: ab9a7d2e3dfa9224186abcbd7a43b3af08d1bfdb Maintainer: takagi Status: ready -->
<refentry xml:id="function.iconv-strpos" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>iconv_strpos</refname>
<refpurpose>文字列が最初に現れる場所を見つける</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>int</type><type>false</type></type><methodname>iconv_strpos</methodname>
<methodparam><type>string</type><parameter>haystack</parameter></methodparam>
<methodparam><type>string</type><parameter>needle</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>offset</parameter><initializer>0</initializer></methodparam>
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<parameter>needle</parameter> が <parameter>haystack</parameter> の中で最初に現れる位置を探します。
</para>
<para>
<function>strpos</function> の戻り値は needle が見つかった位置の
先頭からのバイト数でしたが、それとは異なり
<function>iconv_strpos</function> の戻り値は needle が見つかった
位置の先頭からの文字数となります。文字数は
<parameter>encoding</parameter> で指定された文字セットに基づいて
数えられます。
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>haystack</parameter></term>
<listitem>
<para>
文字列全体。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>needle</parameter></term>
<listitem>
<para>
検索する文字列。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>offset</parameter></term>
<listitem>
<para>
オプションの <parameter>offset</parameter> パラメータは
検索を開始する位置を指定します。
負のオフセットは、文字列の末尾からのオフセットと解釈されます。
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>encoding</parameter></term>
<listitem>
<para>
<parameter>encoding</parameter> パラメータが指定されなかった場合、もしくは &null; の場合、
<parameter>string</parameter> のエンコードは
<link linkend="iconv.configuration">iconv.internal_encoding</link>
であると判断されます。
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
<para>
<parameter>haystack</parameter> や <parameter>needle</parameter>
が文字列でない場合、文字列に変換され、文字が並んだ値として適用されます。
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<parameter>needle</parameter> が
<parameter>haystack</parameter> の中で最初に現れる位置を探します。
</para>
<para>
もし <parameter>needle</parameter> が見つからなかった場合、
<function>iconv_strpos</function> は &false; を返します。
</para>
&return.falseproblem;
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>encoding</parameter> は、nullable になりました。
</entry>
</row>
<row>
<entry>7.1.0</entry>
<entry>
負の <parameter>offset</parameter> をサポートするようになりました。
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>strpos</function></member>
<member><function>iconv_strrpos</function></member>
<member><function>mb_strpos</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
-->