<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.mbstring.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'es',
  ),
  'this' => 
  array (
    0 => 'function.mb-regex-set-options.php',
    1 => 'mb_regex_set_options',
    2 => 'Lee y modifica las opciones de las funciones de expresi&oacute;n regular con soporte para caracteres multibyte',
  ),
  'up' => 
  array (
    0 => 'ref.mbstring.php',
    1 => 'Funciones de strings multibyte',
  ),
  'prev' => 
  array (
    0 => 'function.mb-regex-encoding.php',
    1 => 'mb_regex_encoding',
  ),
  'next' => 
  array (
    0 => 'function.mb-rtrim.php',
    1 => 'mb_rtrim',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    'path' => 'reference/mbstring/functions/mb-regex-set-options.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.mb-regex-set-options" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">mb_regex_set_options</h1>
  <p class="verinfo">(PHP 4 &gt;= 4.3.0, PHP 5, PHP 7, PHP 8)</p><p class="refpurpose"><span class="refname">mb_regex_set_options</span> &mdash; <span class="dc-title">Lee y modifica las opciones de las funciones de expresión regular con soporte para caracteres multibyte</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.mb-regex-set-options-description">
  <h3 class="title">Descripción</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>mb_regex_set_options</strong></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">$options</code><span class="initializer"> = <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong></span></span>): <span class="type"><a href="language.types.string.php" class="type string">string</a></span></div>

  <p class="simpara">
   Configura las opciones por omisión con los nuevos valores contenidos en
   <code class="parameter">options</code>, para las funciones de expresión
   regular con soporte para caracteres multibyte.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.mb-regex-set-options-parameters">
  <h3 class="title">Parámetros</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">options</code></dt>
     <dd>
      <p class="para">
       Las opciones a definir, en forma de un string donde cada carácter es una opción. Para definir un modo, se debe colocar el carácter que representa este modo al final, el resto de los caracteres serán las opciones. Solo puede definirse un modo, mientras que pueden definirse múltiples opciones.
      </p>

      <table class="doctable table">
       <caption><strong>Opciones para la expresión</strong></caption>
       
        <thead>
         <tr>
          <th>Opción</th>
          <th>Significado</th>
          <th>Historial de cambios</th>
         </tr>

        </thead>

        <tbody class="tbody">
         <tr>
          <td>i</td>
          <td>Activa la ambigüedad</td>
          <td class="empty">&nbsp;</td>
         </tr>

         <tr>
          <td>x</td>
          <td>Activa los patrones extendidos</td>
          <td class="empty">&nbsp;</td>
         </tr>

         <tr>
          <td>m</td>
          <td>El carácter <code class="literal">&#039;.&#039;</code> también corresponde a nuevas líneas</td>
          <td class="empty">&nbsp;</td>
         </tr>

         <tr>
          <td>s</td>
          <td><code class="literal">&#039;^&#039;</code> -&gt; <code class="literal">&#039;\A&#039;</code>, <code class="literal">&#039;$&#039;</code> -&gt; <code class="literal">&#039;\Z&#039;</code></td>
          <td class="empty">&nbsp;</td>
         </tr>

         <tr>
          <td>p</td>
          <td>Idéntico a las opciones <code class="literal">m</code> y <code class="literal">s</code></td>
          <td class="empty">&nbsp;</td>
         </tr>

         <tr>
          <td>l</td>
          <td>Encuentra la correspondencia más larga</td>
          <td class="empty">&nbsp;</td>
         </tr>

         <tr>
          <td>n</td>
          <td>Ignora las correspondencias vacías</td>
          <td class="empty">&nbsp;</td>
         </tr>

         <tr>
          <td>e</td>
          <td>Utiliza la función <span class="function"><a href="function.eval.php" class="function">eval()</a></span> sobre el resultado</td>
          <td>Deprecado a partir de PHP 7.1.0 y eliminado a partir de PHP 8.0.0</td>
         </tr>

        </tbody>
       
      </table>

      <blockquote class="note"><p><strong class="note">Nota</strong>: 
       <p class="para">
        La opción <code class="literal">&quot;e&quot;</code> no tiene efecto cuando es definida por la <span class="function"><strong>mb_regex_set_options()</strong></span>. Úsese con <span class="function"><a href="function.mb-ereg-replace.php" class="function">mb_ereg_replace()</a></span> o <span class="function"><a href="function.mb-eregi-replace.php" class="function">mb_eregi_replace()</a></span>.
       </p>
      </p></blockquote>
      <table class="doctable table">
       <caption><strong>Modos de sintaxis de la expresión regular (solo uno puede ser definido)</strong></caption>
       
        <thead>
         <tr>
          <th>Modo</th>
          <th>Significado</th>
         </tr>

        </thead>

        <tbody class="tbody">
         <tr>
          <td>j</td>
          <td>Java (Sun java.util.regex)</td>
         </tr>

         <tr>
          <td>u</td>
          <td>GNU regex</td>
         </tr>

         <tr>
          <td>g</td>
          <td>grep</td>
         </tr>

         <tr>
          <td>c</td>
          <td>Emacs</td>
         </tr>

         <tr>
          <td>r</td>
          <td>Ruby</td>
         </tr>

         <tr>
          <td>z</td>
          <td>Perl</td>
         </tr>

         <tr>
          <td>b</td>
          <td>POSIX Basic regex</td>
         </tr>

         <tr>
          <td>d</td>
          <td>POSIX Extended regex</td>
         </tr>

        </tbody>
       
      </table>

     </dd>
    
   </dl>
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.mb-regex-set-options-returnvalues">
  <h3 class="title">Valores devueltos</h3>
  <p class="para">
   Las opciones anteriores. Si el parámetro <code class="parameter">options</code>
   es omitido o <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong>, se retornará un string describiendo las opciones actuales.
  </p>
 </div>


 <div class="refsect1 changelog" id="refsect1-function.mb-regex-set-options-changelog">
  <h3 class="title">Historial de cambios</h3>
  <table class="doctable informaltable">
   
    <thead>
     <tr>
      <th>Versión</th>
      <th>Descripción</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>8.0.0</td>
      <td>
       Si el parámetro <code class="parameter">options</code> es proporcionado y no <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong>,
       se retornan las opciones <em>anteriores</em>.
       Anteriormente, se retornaban las opciones <em>actuales</em>.
      </td>
     </tr>

     <tr>
      <td>8.0.0</td>
      <td>
       <code class="parameter">options</code> ahora es nullable.
      </td>
     </tr>

     <tr>
      <td>8.0.0</td>
      <td>
       La opción <code class="literal">&quot;e&quot;</code> ahora lanza una <span class="classname"><a href="class.valueerror.php" class="classname">ValueError</a></span>.
      </td>
     </tr>

     <tr>
      <td>7.1.0</td>
      <td>
       La opción <code class="literal">&quot;e&quot;</code> ahora emite una <strong><code><a href="errorfunc.constants.php#constant.e-deprecated">E_DEPRECATED</a></code></strong>.
      </td>
     </tr>

    </tbody>
   
  </table>

 </div>


 <div class="refsect1 seealso" id="refsect1-function.mb-regex-set-options-seealso">
  <h3 class="title">Ver también</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="function"><a href="function.mb-split.php" class="function" rel="rdfs-seeAlso">mb_split()</a> - Divide una string en un array utilizando una expresi&oacute;n regular multibyte</span></li>
    <li><span class="function"><a href="function.mb-ereg.php" class="function" rel="rdfs-seeAlso">mb_ereg()</a> - B&uacute;squeda por expresi&oacute;n regular con soporte para caracteres multibyte</span></li>
    <li><span class="function"><a href="function.mb-eregi.php" class="function" rel="rdfs-seeAlso">mb_eregi()</a> - Expresi&oacute;n regular insensible a may&uacute;sculas/min&uacute;sculas con soporte para caracteres multioctetos</span></li>
   </ul>
  </p>
 </div>


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