mb-regex-set-options.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1a025802f7201d353c1c1c4dccc7d9d6fdf563d4 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.mb-regex-set-options" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>mb_regex_set_options</refname>
  <refpurpose>Lit et modifie les options des fonctions d'expression rationnelle à support de caractères multioctets</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>string</type><methodname>mb_regex_set_options</methodname>
   <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>options</parameter><initializer>&null;</initializer></methodparam>
  </methodsynopsis>
  <simpara>
   Configure les options par défaut avec les nouvelles valeurs contenues dans
   <parameter>options</parameter>, pour les fonctions d'expression
   rationnelle à support de caractères multioctets.
  </simpara>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>options</parameter></term>
     <listitem>
      <para>
       Les options à définir, sous la forme d'une chaîne
       dont chaque caractère est une option. Pour définir un
       mode, vous devez placer le caractère représentant ce mode
       en dernier, le reste des caractères sera les options.
       Vous ne pouvez définir qu'un seul mode, alors que vous
       pouvez définir plusieurs options.
      </para>

      <table>
       <title>Options pour l'expression</title>
       <tgroup cols="3">
        <thead>
         <row>
          <entry>Option</entry>
          <entry>Signification</entry>
          <entry>&Changelog;</entry>
         </row>
        </thead>
        <tbody>
         <row>
          <entry>i</entry>
          <entry>Active l'ambiguïté</entry>
          <entry></entry>
         </row>
         <row>
          <entry>x</entry>
          <entry>Active les masques étendus</entry>
          <entry></entry>
         </row>
         <row>
          <entry>m</entry>
          <entry>Le caractère <literal>'.'</literal> correspond également à de
           nouvelles lignes</entry>
          <entry></entry>
         </row>
         <row>
          <entry>s</entry>
          <entry><literal>'^'</literal> -> <literal>'\A'</literal>, <literal>'$'</literal> -> <literal>'\Z'</literal></entry>
          <entry></entry>
         </row>
         <row>
          <entry>p</entry>
          <entry>Identique aux options <literal>m</literal> et <literal>s</literal></entry>
          <entry></entry>
         </row>
         <row>
          <entry>l</entry>
          <entry>Trouve la plus longue correspondance</entry>
          <entry></entry>
         </row>
         <row>
          <entry>n</entry>
          <entry>Ignore les correspondances vides</entry>
          <entry></entry>
         </row>
         <row>
          <entry>e</entry>
          <entry>Utilise la fonction <function>eval</function> sur le résultat</entry>
          <entry>Obsolète à partir de PHP 7.1.0 et supprimée à partir de PHP 8.0.0</entry>
         </row>
        </tbody>
       </tgroup>
      </table>
      <note>
       <para>
        L'option <literal>"e"</literal> n'a pas d'effet lorsqu'elle est définie par la <function>mb_regex_set_options</function>.
        Utilisez-la avec <function>mb_ereg_replace</function> ou <function>mb_eregi_replace</function>.
       </para>
      </note>
      <table>
       <title>Modes de syntaxe de l'expression rationnelle (un seul peut être défini)</title>
       <tgroup cols="2">
        <thead>
         <row>
          <entry>Mode</entry>
          <entry>Signification</entry>
         </row>
        </thead>
        <tbody>
         <row>
          <entry>j</entry>
          <entry>Java (Sun java.util.regex)</entry>
         </row>
         <row>
          <entry>u</entry>
          <entry>GNU regex</entry>
         </row>
         <row>
          <entry>g</entry>
          <entry>grep</entry>
         </row>
         <row>
          <entry>c</entry>
          <entry>Emacs</entry>
         </row>
         <row>
          <entry>r</entry>
          <entry>Ruby</entry>
         </row>
         <row>
          <entry>z</entry>
          <entry>Perl</entry>
         </row>
         <row>
          <entry>b</entry>
          <entry>POSIX Basic regex</entry>
         </row>
         <row>
          <entry>d</entry>
          <entry>POSIX Extended regex</entry>
         </row>
        </tbody>
       </tgroup>
      </table>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Les options précédentes. Si le paramètre <parameter>options</parameter>
   est omis ou &null;, une chaîne de caractères décrivant les options courantes
   sera retourné.
  </para>
 </refsect1>

 <refsect1 role="changelog">
  &reftitle.changelog;
  <informaltable>
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Si le paramètre <parameter>options</parameter> est fourni et non &null;,
       les options <emphasis>précédentes</emphasis> sont retournées.
       Auparavant, les options <emphasis>courantes</emphasis> étaient retournées.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       <parameter>options</parameter> est désormais nullable.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       L'option <literal>"e"</literal> lance désormais une <classname>ValueError</classname>.
      </entry>
     </row>
     <row>
      <entry>7.1.0</entry>
      <entry>
       L'option <literal>"e"</literal> émet désormais une <constant>E_DEPRECATED</constant>.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>mb_split</function></member>
    <member><function>mb_ereg</function></member>
    <member><function>mb_eregi</function></member>
   </simplelist>
  </para>
 </refsect1>

</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->