<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/book.pcre.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'pcre.constants.php',
    1 => 'Constantes predefinidas',
    2 => 'Constantes predefinidas',
  ),
  'up' => 
  array (
    0 => 'book.pcre.php',
    1 => 'PCRE',
  ),
  'prev' => 
  array (
    0 => 'pcre.configuration.php',
    1 => 'Configura&ccedil;&otilde;es em Execu&ccedil;&atilde;o',
  ),
  'next' => 
  array (
    0 => 'pcre.examples.php',
    1 => 'Exemplos',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'pt_BR',
    'path' => 'reference/pcre/constants.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="pcre.constants" class="appendix">
 <h1 class="title">Constantes predefinidas</h1>

 <p class="simpara">
As constantes abaixo são definidas por esta extensão e
só estarão disponíveis quando a extensão tiver sido compilada no PHP
ou tiver sido carregada dinamicamente em tempo de execução.
</p>
 <table class="doctable table">
  <caption><strong>Constantes PREG</strong></caption>
  
   <thead>
    <tr>
     <th>Constantes</th>
     <th>Descrição</th>
     <th>Desde</th>
    </tr>

   </thead>

   <tbody class="tbody">
    <tr id="constant.preg-pattern-order">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-pattern-order">PREG_PATTERN_ORDER</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      Ordena os resultados de modo que <var class="varname">$matches[0]</var> seja um array de todas as
      correspondências da expressão, <var class="varname">$matches[1]</var> seja um array de strings combinadas pela
      primeira sub-expressão, e assim por diante. Esta opção é somente usada com
      <span class="function"><a href="function.preg-match-all.php" class="function">preg_match_all()</a></span>.
     </td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr id="constant.preg-set-order">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-set-order">PREG_SET_ORDER</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      Ordena os resultados de modo que <var class="varname">$matches[0]</var> seja um array do primeiro
      conjunto de correspondências, <var class="varname">$matches[1]</var> seja um array do segundo conjunto de
      correspondências, e assim por diante. Esta opção é somente usada com <span class="function"><a href="function.preg-match-all.php" class="function">preg_match_all()</a></span>.
     </td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr id="constant.preg-offset-capture">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-offset-capture">PREG_OFFSET_CAPTURE</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      Se esta opção for definida, para cada correspondência a posição do byte
      também será retornada. Observe que isto muda os valores de retorno
      para um array onde cada elemento é um array consistindo da string
      correspondida no elemento 0 e sua posição na string de entrada no
      elemento 1.
     </td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr id="constant.preg-split-no-empty">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-split-no-empty">PREG_SPLIT_NO_EMPTY</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      Esta opção configura <span class="function"><a href="function.preg-split.php" class="function">preg_split()</a></span> para retornar apenas pedaços
      não vazios.
     </td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr id="constant.preg-split-delim-capture">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-split-delim-capture">PREG_SPLIT_DELIM_CAPTURE</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      Esta opção configura <span class="function"><a href="function.preg-split.php" class="function">preg_split()</a></span> para capturar
      expressões entre parênteses em expressões delimitadas.
     </td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr id="constant.preg-split-offset-capture">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-split-offset-capture">PREG_SPLIT_OFFSET_CAPTURE</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      Veja a descrição de <strong><code><a href="pcre.constants.php#constant.preg-offset-capture">PREG_OFFSET_CAPTURE</a></code></strong>.
      Esta opção é usada somente para <span class="function"><a href="function.preg-split.php" class="function">preg_split()</a></span>.
     </td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr id="constant.preg-unmatched-as-null">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-unmatched-as-null">PREG_UNMATCHED_AS_NULL</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      Esta opção informa a <span class="function"><a href="function.preg-match.php" class="function">preg_match()</a></span> e
      <span class="function"><a href="function.preg-match-all.php" class="function">preg_match_all()</a></span> para incluir sub-expressões não correspondidas em
      <var class="varname">$matches</var> como <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong>. Sem esta opção, sub-expressões sem
      correspondência são reportadas como strings vazias, como se fossem correspondências vazias.
      Informar esta opção permite diferenciar entre esses dois casos.
     </td>
     <td>7.2.0</td>
    </tr>

    <tr id="constant.preg-no-error">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-no-error">PREG_NO_ERROR</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      Retornada pela <span class="function"><a href="function.preg-last-error.php" class="function">preg_last_error()</a></span> se não houver
      erros.
     </td>
     <td>5.2.0</td>
    </tr>

    <tr id="constant.preg-internal-error">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-internal-error">PREG_INTERNAL_ERROR</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      Retornada pela <span class="function"><a href="function.preg-last-error.php" class="function">preg_last_error()</a></span> se houver um erro
      interno na PCRE.
     </td>
     <td>5.2.0</td>
    </tr>

    <tr id="constant.preg-backtrack-limit-error">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-backtrack-limit-error">PREG_BACKTRACK_LIMIT_ERROR</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      Retornada pela <span class="function"><a href="function.preg-last-error.php" class="function">preg_last_error()</a></span> se o <a href="pcre.configuration.php#ini.pcre.backtrack-limit" class="link">limite de rastreamento retroativo</a> tiver sido ultrapassado.
     </td>
     <td>5.2.0</td>
    </tr>

    <tr id="constant.preg-recursion-limit-error">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-recursion-limit-error">PREG_RECURSION_LIMIT_ERROR</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      Retornada pela <span class="function"><a href="function.preg-last-error.php" class="function">preg_last_error()</a></span> se o <a href="pcre.configuration.php#ini.pcre.recursion-limit" class="link">limite de recursividade</a> tiver sido ultrapassado.
     </td>
     <td>5.2.0</td>
    </tr>

    <tr id="constant.preg-bad-utf8-error">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-bad-utf8-error">PREG_BAD_UTF8_ERROR</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      Retornada pela <span class="function"><a href="function.preg-last-error.php" class="function">preg_last_error()</a></span> se o último erro foi
      causado por dados UTF-8 mal formados (somente ao usar uma expressão regular em <a href="reference.pcre.pattern.modifiers.php" class="link">modo UTF-8</a>).
     </td>
     <td>5.2.0</td>
    </tr>

    <tr id="constant.preg-bad-utf8-offset-error">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-bad-utf8-offset-error">PREG_BAD_UTF8_OFFSET_ERROR</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      Retornada pela <span class="function"><a href="function.preg-last-error.php" class="function">preg_last_error()</a></span> se o deslocamento não
      tiver correspondido ao início de um ponto de código UTF-8 válido (somente ao usar
      uma expressão regular em <a href="reference.pcre.pattern.modifiers.php" class="link">
      modo UTF-8</a>).
     </td>
     <td>5.3.0</td>
    </tr>

    <tr id="constant.preg-jit-stacklimit-error">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-jit-stacklimit-error">PREG_JIT_STACKLIMIT_ERROR</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      Retornada por <span class="function"><a href="function.preg-last-error.php" class="function">preg_last_error()</a></span> se a última função PCRE
      falhou por falta de espaço em pilha do JIT.
     </td>
     <td>7.0.0</td>
    </tr>

    <tr id="constant.pcre-version">
     <td>
      <strong><code><a href="pcre.constants.php#constant.pcre-version">PCRE_VERSION</a></code></strong>
      (<span class="type"><a href="language.types.string.php" class="type string">string</a></span>)
     </td>
     <td>
      Versão da PCRE e data de lançamento (e.g. &quot;<code class="literal">7.0 18-Dec-2006</code>&quot;).
     </td>
     <td>5.2.4</td>
    </tr>

    <tr id="constant.pcre-version-major">
     <td>
      <strong><code><a href="pcre.constants.php#constant.pcre-version-major">PCRE_VERSION_MAJOR</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      Número de versão principal do PCRE.
     </td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr id="constant.pcre-version-minor">
     <td>
      <strong><code><a href="pcre.constants.php#constant.pcre-version-minor">PCRE_VERSION_MINOR</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      Número de versão secundária do PCRE.
     </td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr id="constant.pcre-jit-support">
     <td>
      <strong><code><a href="pcre.constants.php#constant.pcre-jit-support">PCRE_JIT_SUPPORT</a></code></strong>
      (<span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span>)
     </td>
     <td>
      Indica se o suporte PCRE JIT está disponível.
     </td>
     <td class="empty">&nbsp;</td>
    </tr>

    <tr id="constant.preg-grep-invert">
     <td>
      <strong><code><a href="pcre.constants.php#constant.preg-grep-invert">PREG_GREP_INVERT</a></code></strong>
      (<span class="type"><a href="language.types.integer.php" class="type int">int</a></span>)
     </td>
     <td>
      Retorna os elementos que não correspondem à expressão informada.
     </td>
     <td class="empty">&nbsp;</td>
    </tr>

   </tbody>
  
 </table>

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