<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Find the position of the last occurrence of a case-insensitive substring in a string</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.strrev.html">strrev</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.strrpos.html">strrpos</a></div>
<div class="up"><a href="ref.strings.html">String Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="function.strripos" class="refentry">
<div class="refnamediv">
<h1 class="refname">strripos</h1>
<p class="verinfo">(PHP 5)</p><p class="refpurpose"><span class="refname">strripos</span> — <span class="dc-title">Find the position of the last occurrence of a case-insensitive substring in a string</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.strripos-description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="type">int</span> <span class="methodname"><strong>strripos</strong></span>
( <span class="methodparam"><span class="type">string</span> <code class="parameter">$haystack</code></span>
, <span class="methodparam"><span class="type">string</span> <code class="parameter">$needle</code></span>
[, <span class="methodparam"><span class="type">int</span> <code class="parameter">$offset</code><span class="initializer"> = 0</span></span>
] )</div>
<p class="para rdfs-comment">
Find the numeric position of the last occurrence of
<em><code class="parameter">needle</code></em> in the <em><code class="parameter">haystack</code></em> string.
</p>
<p class="para">
Unlike the <span class="function"><a href="function.strrpos.html" class="function">strrpos()</a></span>, <span class="function"><strong>strripos()</strong></span> is
case-insensitive.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.strripos-parameters">
<h3 class="title">Parameters</h3>
<p class="para">
<dl>
<dt>
<span class="term"><em><code class="parameter">haystack</code></em></span>
<dd>
<p class="para">
The string to search in.
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">needle</code></em></span>
<dd>
<p class="para">
If <em><code class="parameter">needle</code></em> is not a string, it is converted
to an integer and applied as the ordinal value of a character.
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">offset</code></em></span>
<dd>
<p class="para">
If specified, search will start this number of characters counted from the
beginning of the string. If the value is negative, search will instead start
from that many characters from the end of the string, searching backwards.
</p>
</dd>
</dt>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.strripos-returnvalues">
<h3 class="title">Return Values</h3>
<p class="para">
Returns the position where the needle exists relative to the beginnning of
the <em><code class="parameter">haystack</code></em> string (independent of search direction
or offset).
Also note that string positions start at 0, and not 1.
</p>
<p class="para">
Returns <strong><code>FALSE</code></strong> if the needle was not found.
</p>
<div class="warning"><strong class="warning">Warning</strong><p class="simpara">This function may
return Boolean <strong><code>FALSE</code></strong>, but may also return a non-Boolean value which
evaluates to <strong><code>FALSE</code></strong>. Please read the section on <a href="language.types.boolean.html" class="link">Booleans</a> for more
information. Use <a href="language.operators.comparison.html" class="link">the ===
operator</a> for testing the return value of this
function.</p></div>
</div>
<div class="refsect1 examples" id="refsect1-function.strripos-examples">
<h3 class="title">Examples</h3>
<p class="para">
<div class="example" id="example-4900">
<p><strong>Example #1 A simple <span class="function"><strong>strripos()</strong></span> example</strong></p>
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br />$haystack </span><span style="color: #007700">= </span><span style="color: #DD0000">'ababcd'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">$needle </span><span style="color: #007700">= </span><span style="color: #DD0000">'aB'</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">$pos </span><span style="color: #007700">= </span><span style="color: #0000BB">strripos</span><span style="color: #007700">(</span><span style="color: #0000BB">$haystack</span><span style="color: #007700">, </span><span style="color: #0000BB">$needle</span><span style="color: #007700">);<br /><br />if (</span><span style="color: #0000BB">$pos </span><span style="color: #007700">=== </span><span style="color: #0000BB">false</span><span style="color: #007700">) {<br /> echo </span><span style="color: #DD0000">"Sorry, we did not find (</span><span style="color: #0000BB">$needle</span><span style="color: #DD0000">) in (</span><span style="color: #0000BB">$haystack</span><span style="color: #DD0000">)"</span><span style="color: #007700">;<br />} else {<br /> echo </span><span style="color: #DD0000">"Congratulations!\n"</span><span style="color: #007700">;<br /> echo </span><span style="color: #DD0000">"We found the last (</span><span style="color: #0000BB">$needle</span><span style="color: #DD0000">) in (</span><span style="color: #0000BB">$haystack</span><span style="color: #DD0000">) at position (</span><span style="color: #0000BB">$pos</span><span style="color: #DD0000">)"</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
<div class="example-contents"><p>The above example will output:</p></div>
<div class="example-contents screen">
<div class="cdata"><pre>
Congratulations!
We found the last (aB) in (ababcd) at position (2)
</pre></div>
</div>
</div>
</p>
</div>
<div class="refsect1 seealso" id="refsect1-function.strripos-seealso">
<h3 class="title">See Also</h3>
<p class="para">
<ul class="simplelist">
<li class="member"> <span class="function"><a href="function.strpos.html" class="function" rel="rdfs-seeAlso">strpos()</a> - Find the position of the first occurrence of a substring in a string</span></li>
<li class="member"> <span class="function"><a href="function.stripos.html" class="function" rel="rdfs-seeAlso">stripos()</a> - Find the position of the first occurrence of a case-insensitive substring in a string</span></li>
<li class="member"> <span class="function"><a href="function.strrpos.html" class="function" rel="rdfs-seeAlso">strrpos()</a> - Find the position of the last occurrence of a substring in a string</span></li>
<li class="member"> <span class="function"><a href="function.strrchr.html" class="function" rel="rdfs-seeAlso">strrchr()</a> - Find the last occurrence of a character in a string</span></li>
<li class="member"> <span class="function"><a href="function.stristr.html" class="function" rel="rdfs-seeAlso">stristr()</a> - Case-insensitive strstr</span></li>
<li class="member"> <span class="function"><a href="function.substr.html" class="function" rel="rdfs-seeAlso">substr()</a> - Return part of a string</span></li>
</ul>
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.strrev.html">strrev</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.strrpos.html">strrpos</a></div>
<div class="up"><a href="ref.strings.html">String Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
