<?xml version="1.0" encoding="utf-8"?>

<refentry xml:id="function.strripos" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>strripos</refname>

<refpurpose>文字列中で、特定の(大文字小文字を区別しない)文字列が最後に現れた位置を探す</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type class="union"><type>int</type><type>false</type></type><methodname>strripos</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>

</methodsynopsis>

<para>

文字列 <parameter>haystack</parameter> の中で、

<parameter>needle</parameter> が最後に現れる位置を探します。

</para>

<para>

<function>strrpos</function> と異なり、<function>strripos</function>

は大文字小文字を区別しません。

</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>

&strings.parameter.needle.non-string;

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>offset</parameter></term>

<listitem>

<para>

ゼロまたは正の値の場合、

<parameter>haystack</parameter> の

最初の <parameter>offset</parameter> バイトをスキップし、

左から右に検索が行われます。

</para>

<para>

負の値の場合、

<parameter>haystack</parameter> の

最後の <parameter>offset</parameter> バイトをスキップし、

右から左に検索が行われ、

<parameter>needle</parameter> が最初に現れる場所を探します。

<note>

<para>

この方が、最後の <parameter>offset</parameter> バイトより前にある、

最後の <parameter>needle</parameter>

を効率的に探せます。

</para>

</note>

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

<parameter>needle</parameter> が見つかった位置を、

<parameter>haystack</parameter> 文字列の先頭

(<parameter>offset</parameter> の値とは無関係) からの相対位置で返します。

<note>

<simpara>

文字列の開始位置は 0 であり、1 ではありません。

</simpara>

</note>

</para>

<para>

<parameter>needle</parameter> が見つからない場合は &false; を返します。

</para>

&return.falseproblem;

</refsect1>

<refsect1 role="errors">

&reftitle.errors;

<itemizedlist>

<listitem>

<simpara>

<parameter>offset</parameter> が <parameter>haystack</parameter>

の長さより大きい場合、

<classname>ValueError</classname> がスローされます。

</simpara>

</listitem>

</itemizedlist>

</refsect1>

<refsect1 role="changelog">

&reftitle.changelog;

<informaltable>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

&strings.changelog.needle-empty;

&strings.changelog.ascii-case-folding;

<row>

<entry>8.0.0</entry>

<entry>

<parameter>needle</parameter> に数値を渡すことはサポートされなくなりました。

</entry>

</row>

<row>

<entry>7.3.0</entry>

<entry>

<parameter>needle</parameter> に数値を渡すことは非推奨になりました。

</entry>

</row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title>単純な <function>strripos</function> の例</title>

<programlisting role="php">

</programlisting>

&example.outputs;

<screen>

</screen>

</example>

</para>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>strpos</function></member>

<member><function>stripos</function></member>

<member><function>strrpos</function></member>

<member><function>strrchr</function></member>

<member><function>stristr</function></member>

<member><function>substr</function></member>

</simplelist>

</para>

</refsect1>

</refentry>