Files
doc-fr/reference/pcre/constants.xml
2021-09-24 04:13:47 +01:00

182 lines
6.6 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 508e255fff6c604c31d5617fe9ddf6d776a3b43d Maintainer: jpauli Status: ready -->
<!-- Reviewed: no -->
<appendix xml:id="pcre.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
&extension.constants;
<table>
<title>Constantes PREG</title>
<tgroup cols="2">
<thead>
<row>
<entry>&Constants;</entry>
<entry>&Description;</entry>
<entry>À partir de</entry>
</row>
</thead>
<tbody>
<row xml:id="constant.preg-pattern-order">
<entry><constant>PREG_PATTERN_ORDER</constant></entry>
<entry>
Ordonne les résultats de façon à ce que <varname>$matches[0]</varname> contienne les
résultats qui correspondent au masque entier, <varname>$matches[1]</varname> ceux
qui correspondent à la première parenthèse capturante et ainsi de suite. Cette
constante est utilisée avec <function>preg_match_all</function>.
</entry>
<entry></entry>
</row>
<row xml:id="constant.preg-set-order">
<entry><constant>PREG_SET_ORDER</constant></entry>
<entry>
Les résultats sont classés de telle
façon que <varname>$matches[0]</varname> contient la première
série de résultat, <varname>$matches[1]</varname> la
deuxième, etc.
Cette constante est utilisée avec <function>preg_match_all</function>.
</entry>
<entry></entry>
</row>
<row xml:id="constant.preg-offset-capture">
<entry><constant>PREG_OFFSET_CAPTURE</constant></entry>
<entry>
Voir la description de <constant>PREG_SPLIT_OFFSET_CAPTURE</constant>.
</entry>
<entry></entry>
</row>
<row xml:id="constant.preg-split-no-empty">
<entry><constant>PREG_SPLIT_NO_EMPTY</constant></entry>
<entry>
Si cette option est activée, seules les sous-chaînes non vides
seront retournées par <function>preg_split</function>.
</entry>
<entry></entry>
</row>
<row xml:id="constant.preg-split-delim-capture">
<entry><constant>PREG_SPLIT_DELIM_CAPTURE</constant></entry>
<entry>
Si cette option est activée, les expressions entre parenthèses entre
les délimiteurs de masques seront aussi capturées et retournées.
Cette constante est utilisée avec <function>preg_split</function>.
</entry>
<entry></entry>
</row>
<row xml:id="constant.preg-split-offset-capture">
<entry><constant>PREG_SPLIT_OFFSET_CAPTURE</constant></entry>
<entry>
Si cette constante est utilisée avec <function>preg_split</function>,
l'offset de début de résultat sera retourné, en plus de la chaîne
résultat. Notez que cela change la nature du résultat retourné en
un tableau contenant une chaîne à l'offset &zero; et une chaîne
contenant un offset à l'offset &one;
</entry>
<entry></entry>
</row>
<row xml:id="constant.preg-unmatched-as-null">
<entry><constant>PREG_UNMATCHED_AS_NULL</constant></entry>
<entry>
Cette contante demande à <function>preg_match</function> et
<function>preg_match_all</function>
d'include les sous-masques sans correspondance dans <varname>$matches</varname> avec une valeur à &null;.
Sans cette contante, les sous-masques sans correspondance sont retourné avec une chaîne vide, comme si la correspondance était vide.
Définir cette constante permet de distinguer ces deux cas.
</entry>
<entry>7.2.0</entry>
</row>
<row xml:id="constant.preg-no-error">
<entry><constant>PREG_NO_ERROR</constant></entry>
<entry>
Retourné par la fonction <function>preg_last_error</function>
s'il n'y a pas d'erreur.
</entry>
<entry>5.2.0</entry>
</row>
<row xml:id="constant.preg-internal-error">
<entry><constant>PREG_INTERNAL_ERROR</constant></entry>
<entry>
Retourné par la fonction <function>preg_last_error</function>
s'il y a une erreur interne PCRE.
</entry>
<entry>5.2.0</entry>
</row>
<row xml:id="constant.preg-backtrack-limit-error">
<entry><constant>PREG_BACKTRACK_LIMIT_ERROR</constant></entry>
<entry>
Retourné par la fonction <function>preg_last_error</function> si
<link linkend="ini.pcre.backtrack-limit">backtrack limit</link>
a été atteint.
</entry>
<entry>5.2.0</entry>
</row>
<row xml:id="constant.preg-recursion-limit-error">
<entry><constant>PREG_RECURSION_LIMIT_ERROR</constant></entry>
<entry>
Retourné par la fonction <function>preg_last_error</function> si
<link linkend="ini.pcre.recursion-limit">la limite de récurrence</link>
a été atteint.
</entry>
<entry>5.2.0</entry>
</row>
<row xml:id="constant.preg-bad-utf8-error">
<entry><constant>PREG_BAD_UTF8_ERROR</constant></entry>
<entry>
Retourné par la fonction <function>preg_last_error</function>
si la dernière erreur est du à une malformation des données
UTF-8 (uniquement lors de l'exécution d'une expression en
<link linkend="reference.pcre.pattern.modifiers">mode UTF-8</link>).
</entry>
<entry>5.2.0</entry>
</row>
<row xml:id="constant.preg-bad-utf8-offset-error">
<entry><constant>PREG_BAD_UTF8_OFFSET_ERROR</constant></entry>
<entry>
Retourné par la fonction <function>preg_last_error</function> si l'offset
ne correspond pas au début d'un point valide UTF-8 (uniquement lorsque l'on
exécute une expression en<link linkend="reference.pcre.pattern.modifiers">mode
UTF-8</link>).
</entry>
<entry>5.3.0</entry>
</row>
<row xml:id="constant.preg-jit-stacklimit-error">
<entry><constant>PREG_JIT_STACKLIMIT_ERROR</constant></entry>
<entry>
Retourné par <function>preg_last_error</function> si la dernière fonction
PCRE a échoué en raison de la limite de la pile JIT.
</entry>
<entry>7.0.0</entry>
</row>
<row xml:id="constant.pcre-version">
<entry><constant>PCRE_VERSION</constant></entry>
<entry>
Version PCRE ainsi que la date de publication
(i.e. <literal>"7.0 18-Dec-2006"</literal>).
</entry>
<entry>5.2.4</entry>
</row>
</tbody>
</tgroup>
</table>
</appendix>
<!-- 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
-->