<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.iconv.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'en',
  ),
  'this' => 
  array (
    0 => 'function.iconv-strrpos.php',
    1 => 'iconv_strrpos',
    2 => 'Finds the last occurrence of a needle within a haystack',
  ),
  'up' => 
  array (
    0 => 'ref.iconv.php',
    1 => 'iconv Functions',
  ),
  'prev' => 
  array (
    0 => 'function.iconv-strpos.php',
    1 => 'iconv_strpos',
  ),
  'next' => 
  array (
    0 => 'function.iconv-substr.php',
    1 => 'iconv_substr',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'en',
    'path' => 'reference/iconv/functions/iconv-strrpos.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.iconv-strrpos" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">iconv_strrpos</h1>
  <p class="verinfo">(PHP 5, PHP 7, PHP 8)</p><p class="refpurpose"><span class="refname">iconv_strrpos</span> &mdash; <span class="dc-title">Finds the last occurrence of a needle within a haystack</span></p>

 </div>
 
 <div class="refsect1 description" id="refsect1-function.iconv-strrpos-description">
  <h3 class="title">Description</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>iconv_strrpos</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$haystack</code></span>, <span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$needle</code></span>, <span class="methodparam"><span class="type"><span class="type"><a href="language.types.null.php" class="type null">?</a></span><span class="type"><a href="language.types.string.php" class="type string">string</a></span></span> <code class="parameter">$encoding</code><span class="initializer"> = <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong></span></span>): <span class="type"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span>|<span class="type"><a href="language.types.singleton.php" class="type false">false</a></span></span></div>

  <p class="para rdfs-comment">
   Finds the last occurrence of a <code class="parameter">needle</code>
   within a <code class="parameter">haystack</code>.
  </p>
  <p class="para">
   In contrast to <span class="function"><a href="function.strrpos.php" class="function">strrpos()</a></span>, the return value of
   <span class="function"><strong>iconv_strrpos()</strong></span> is the number of characters that
   appear before the needle, rather than the offset in bytes to the
   position where the needle has been found. The characters are counted
   on the basis of the specified character set <code class="parameter">encoding</code>.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.iconv-strrpos-parameters">
  <h3 class="title">Parameters</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">haystack</code></dt>
     <dd>
      <p class="para">
       The entire string.
      </p>
     </dd>
    
    
     <dt><code class="parameter">needle</code></dt>
     <dd>
      <p class="para">
       The searched substring.
      </p>
     </dd>
    
    
     <dt><code class="parameter">encoding</code></dt>
     <dd>
      <p class="para">
       If <code class="parameter">encoding</code> parameter is omitted or <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong>,
       <code class="parameter">string</code> are assumed to be encoded in
       <a href="iconv.configuration.php" class="link">iconv.internal_encoding</a>.
      </p>
     </dd>
    
   </dl>
  </p>
  <p class="para">
   If <code class="parameter">haystack</code> or <code class="parameter">needle</code> is
   not a string, it is converted to a string and applied as the ordinal
   value of a character.
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.iconv-strrpos-returnvalues">
  <h3 class="title">Return Values</h3>
  <p class="para">
   Returns the numeric position of the last occurrence of
   <code class="parameter">needle</code> in <code class="parameter">haystack</code>.
  </p>
  <p class="para">
   If <code class="parameter">needle</code> is not found,
   <span class="function"><strong>iconv_strrpos()</strong></span> will return <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>.
  </p>
  <div class="warning"><strong class="warning">Warning</strong><p class="simpara">This function may
return Boolean <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>, but may also return a non-Boolean value which
evaluates to <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>. Please read the section on <a href="language.types.boolean.php" class="link">Booleans</a> for more
information. Use <a href="language.operators.comparison.php" class="link">the ===
operator</a> for testing the return value of this
function.</p></div>
 </div>


 <div class="refsect1 changelog" id="refsect1-function.iconv-strrpos-changelog">
  <h3 class="title">Changelog</h3>
  <table class="doctable informaltable">
   
    <thead>
     <tr>
      <th>Version</th>
      <th>Description</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>8.0.0</td>
      <td>
       <code class="parameter">encoding</code> is nullable now.
      </td>
     </tr>

    </tbody>
   
  </table>

 </div>


 <div class="refsect1 seealso" id="refsect1-function.iconv-strrpos-seealso">
  <h3 class="title">See Also</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="function"><a href="function.strrpos.php" class="function" rel="rdfs-seeAlso">strrpos()</a> - Find the position of the last occurrence of a substring in a string</span></li>
    <li><span class="function"><a href="function.iconv-strpos.php" class="function" rel="rdfs-seeAlso">iconv_strpos()</a> - Finds position of first occurrence of a needle within a haystack</span></li>
    <li><span class="function"><a href="function.mb-strrpos.php" class="function" rel="rdfs-seeAlso">mb_strrpos()</a> - Find position of last occurrence of a string in a string</span></li>
   </ul>
  </p>
 </div>


</div><?php manual_footer($setup); ?>