Skip to content

[Sync-En] pcre: clarify that delimiters must be single-byte characters #1134

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
julionc merged 1 commit into from
Aug 28, 2026
Merged

[Sync-En] pcre: clarify that delimiters must be single-byte characters #1134

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 12 additions & 5 deletions reference/pcre/pattern.syntax.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 3e1cd2462664adb2495cff5887671ba8a9909cf9 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<!-- EN-Revision: b55141fe2d4f601e32555c33fb00e1f9225c4638 Maintainer: PhilDaiguille Status: ready -->
<!-- splitted from ./en/functions/pcre.xml, last change in rev 1.2 -->
<chapter xml:id="reference.pcre.pattern.syntax" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Sintaxis de patrones</title>
Expand Down Expand Up @@ -29,12 +28,20 @@
</section>
<section xml:id="regexp.reference.delimiters">
<title>Delimitadores</title>
<para>
<simpara>
Al usar las funciones PCRE, es obligatorio que el patrón esté encerrado
por <emphasis>delimitadores</emphasis>. Un delimitador puede ser cualquier carácter no alfanumérico,
no barra invertida, no espacio en blanco.
no barra invertida, no espacio en blanco, de un solo byte.
Los espacios en blanco iniciales antes de un delimitador válido se ignoran silenciosamente.
</para>
</simpara>
<note>
<simpara>
Los caracteres multibyte (como los caracteres codificados en UTF-8, por ejemplo <literal>§</literal>)
no pueden ser utilizados como delimitadores. PHP lee exactamente un byte como delimitador;
utilizar un carácter multibyte provocaría que los bytes restantes fueran
interpretados erróneamente como modificadores de patrón desconocidos.
</simpara>
</note>
<para>
Los delimitadores comúnmente utilizados son las barras inclinadas hacia adelante (<literal>/</literal>), signos de número
(<literal>#</literal>) y tildes (<literal>~</literal>). Los siguientes son ejemplos de patrones delimitados válidos.
Expand Down