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

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

<refnamediv>

<refname>mb_strripos</refname>

<refpurpose>Finds position of last occurrence of a string within another, case insensitive</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

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

<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>encoding</parameter><initializer>&null;</initializer></methodparam>

</methodsynopsis>

<para>

<function>mb_strripos</function> performs multi-byte safe

<function>strripos</function> operation based on

number of characters. <parameter>needle</parameter> position is

counted from the beginning of

<parameter>haystack</parameter>. First character's position is

0. Second character position is 1.

Unlike <function>mb_strrpos</function>,

<function>mb_strripos</function> is case-insensitive.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>haystack</parameter></term>

<listitem>

<para>

The string from which to get the position of the last occurrence

of <parameter>needle</parameter>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>needle</parameter></term>

<listitem>

<para>

The string to find in <parameter>haystack</parameter>.

</para>

</listitem>

</varlistentry>

<varlistentry>

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

<listitem>

<para>

May be specified to begin searching an arbitrary number of characters into

the <parameter>haystack</parameter>. Negative values will stop searching at an arbitrary point

prior to the end of the <parameter>haystack</parameter>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>encoding</parameter></term>

<listitem>

&mbstring.encoding.parameter;

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Return the numeric position of

the last occurrence of <parameter>needle</parameter> in the

<parameter>haystack</parameter> string, or &false;

if <parameter>needle</parameter> is not found.

</para>

</refsect1>

<refsect1 role="errors">

&reftitle.errors;

<itemizedlist>

<listitem>

<simpara>

If <parameter>offset</parameter> is greater than the length of

<parameter>haystack</parameter>, a

<classname>ValueError</classname> will be thrown.

</simpara>

</listitem>

</itemizedlist>

</refsect1>

<refsect1 role="changelog">

&reftitle.changelog;

<informaltable>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

&mbstring.changelog.needle-empty;

&mbstring.changelog.encoding-nullable;

</tbody>

</tgroup>

</informaltable>

</refsect1>

<!-- Use when examples exist

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>strripos</function></member>

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

<member><function>mb_strrpos</function></member>

</simplelist>

</para>

</refsect1>

</refentry>