<!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>Returns position and length of a matched part of the multibyte regular expression for a predefined multibyte string</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.mb-ereg-search-init.html">mb_ereg_search_init</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.mb-ereg-search-regs.html">mb_ereg_search_regs</a></div>
<div class="up"><a href="ref.mbstring.html">Multibyte String Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="function.mb-ereg-search-pos" class="refentry">
<div class="refnamediv">
<h1 class="refname">mb_ereg_search_pos</h1>
<p class="verinfo">(PHP 4 >= 4.2.0, PHP 5)</p><p class="refpurpose"><span class="refname">mb_ereg_search_pos</span> — <span class="dc-title">Returns position and length of a matched part of the multibyte regular expression for a predefined multibyte string</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.mb-ereg-search-pos-description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="type">array</span> <span class="methodname"><strong>mb_ereg_search_pos</strong></span>
([ <span class="methodparam"><span class="type">string</span> <code class="parameter">$pattern</code></span>
[, <span class="methodparam"><span class="type">string</span> <code class="parameter">$option</code><span class="initializer"> = "ms"</span></span>
]] )</div>
<p class="para rdfs-comment">
Returns position and length of a matched part of the multibyte regular expression
for a predefined multibyte string
</p>
<p class="para">
The string for match is specified by
<span class="function"><a href="function.mb-ereg-search-init.html" class="function">mb_ereg_search_init()</a></span>. If it is not specified,
the previous one will be used.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.mb-ereg-search-pos-parameters">
<h3 class="title">Parameters</h3>
<p class="para">
<dl>
<dt>
<span class="term"><em><code class="parameter">pattern</code></em></span>
<dd>
<p class="para">
The search pattern.
</p>
</dd>
</dt>
<dt>
<span class="term"><em><code class="parameter">option</code></em></span>
<dd>
<p class="para">
The search option.
</p>
</dd>
</dt>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.mb-ereg-search-pos-returnvalues">
<h3 class="title">Return Values</h3>
<p class="simpara">
An <span class="type"><a href="language.types.array.html" class="type array">array</a></span> containing two elements. The first element is the
offset, in bytes, where the match begins relative to the start of the
search string, and the second element is the length in bytes of the match.
</p>
<p class="simpara">
If an error occurs, <strong><code>FALSE</code></strong> is returned.
</p>
</div>
<div class="refsect1 notes" id="refsect1-function.mb-ereg-search-pos-notes">
<h3 class="title">Notes</h3>
<blockquote class="note"><p><strong class="note">Note</strong>: <p class="para">The internal encoding or the
character encoding specified by <span class="function"><a href="function.mb-regex-encoding.html" class="function">mb_regex_encoding()</a></span>
will be used as the character encoding for this function.</p></p></blockquote>
</div>
<div class="refsect1 seealso" id="refsect1-function.mb-ereg-search-pos-seealso">
<h3 class="title">See Also</h3>
<p class="para">
<ul class="simplelist">
<li class="member"> <span class="function"><a href="function.mb-regex-encoding.html" class="function" rel="rdfs-seeAlso">mb_regex_encoding()</a> - Set/Get character encoding for multibyte regex</span></li>
<li class="member"> <span class="function"><a href="function.mb-ereg-search-init.html" class="function" rel="rdfs-seeAlso">mb_ereg_search_init()</a> - Setup string and regular expression for a multibyte regular expression match</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.mb-ereg-search-init.html">mb_ereg_search_init</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.mb-ereg-search-regs.html">mb_ereg_search_regs</a></div>
<div class="up"><a href="ref.mbstring.html">Multibyte String Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
