summaryrefslogtreecommitdiffstats
path: root/tde-i18n-es/docs/tdebase/kate/regular-expressions.docbook
diff options
context:
space:
mode:
authorTimothy Pearson <[email protected]>2011-12-03 11:05:10 -0600
committerTimothy Pearson <[email protected]>2011-12-03 11:05:10 -0600
commitf7e7a923aca8be643f9ae6f7252f9fb27b3d2c3b (patch)
tree1f78ef53b206c6b4e4efc88c4849aa9f686a094d /tde-i18n-es/docs/tdebase/kate/regular-expressions.docbook
parent85ca18776aa487b06b9d5ab7459b8f837ba637f3 (diff)
downloadtde-i18n-f7e7a923aca8be643f9ae6f7252f9fb27b3d2c3b.tar.gz
tde-i18n-f7e7a923aca8be643f9ae6f7252f9fb27b3d2c3b.zip
Second part of prior commit
Diffstat (limited to 'tde-i18n-es/docs/tdebase/kate/regular-expressions.docbook')
-rw-r--r--tde-i18n-es/docs/tdebase/kate/regular-expressions.docbook1042
1 files changed, 1042 insertions, 0 deletions
diff --git a/tde-i18n-es/docs/tdebase/kate/regular-expressions.docbook b/tde-i18n-es/docs/tdebase/kate/regular-expressions.docbook
new file mode 100644
index 00000000000..72af563969c
--- /dev/null
+++ b/tde-i18n-es/docs/tdebase/kate/regular-expressions.docbook
@@ -0,0 +1,1042 @@
+<appendix id="regular-expressions">
+<appendixinfo>
+<authorgroup>
+<author
+>&Anders.Lund; &Anders.Lund.mail;</author>
+<othercredit role="translator"
+> <firstname
+>Marcos</firstname
+> <surname
+>Fouces Lago</surname
+> <affiliation
+><address
+><email
+></address
+></affiliation
+> <contrib
+>Traductor</contrib
+> </othercredit
+>
+</authorgroup>
+</appendixinfo>
+
+<title
+>Expresiones regulares</title>
+
+<synopsis
+>Este apéndice contiene una breve pero probablemente suficiente
+y completa introducción al mundo de las <emphasis
+>expresiones
+regulares</emphasis
+>. Documenta las expresiones regulares tal
+y como aparecen en &kate;, que no son compatibles con las expresiones
+regulares de perl, ni de <command
+>grep</command
+>, entre otros.</synopsis>
+
+<sect1>
+
+<title
+>Introducción</title>
+
+<para
+>Las <emphasis
+>expresiones regulares</emphasis
+> no proporcionan un método para describir el posible contenido de una cadena de texto de forma que pueda ser interpretada por un pequeño módulo de software, y se pueda investigar si un texto corresponde con el buscado y, en el caso de aplicaciones avanzadas, se pongan los medios para recuperar partes del texto coincidente.</para>
+
+<para
+>Por ejemplo: pongamos que quiere buscar un texto que es el comienzo de un párrafo e incluye los nombres «Henrik» o «Pernille», seguidos de alguna forma del verbo «hablar».</para>
+
+<para
+>En una búsqueda normal, debería comenzar a buscar por el primer nombre, «Henrik» quizá seguido de «hab», de esta manera: <userinput
+>Henrik hab</userinput
+>, y mientras busca coincidencias, debe descartar aquellas que no estén al principio de un párrafo, así como aquellas en las que la palabra que comience por «hab» no pertenezca al verbo «hablar». Y después volver a repetir todo el proceso con el otro nombre...</para>
+
+<para
+>Con las expresiones regulares, esta taréa se puede acometer en una sóla búsqueda, y con una gran precisión.</para>
+
+<para
+>Para conseguirlo, las expresiones regulares definen reglas para expresar detalladamente una generalización de la cadena a buscar. Nuestro ejemplo, que podríamos expresar literalmente como: «una línea que comienza por «Henrik» o por «Pernille» (posiblemente depués de 4 espacios en blanco o tabuladores) seguido de un espacio en blanco seguido de «hab» y después «laba» o «ló»», se podría expresar con la siguiente expresión regular:</para
+> <para
+><userinput
+>^[ \t]{0,4}(Henrik|Pernille) hab(laba|ló)</userinput
+></para>
+
+<para
+>El ejemplo anterior muestra los cuatro conceptos principales de las expresiones regulares modernas, veamos:</para>
+
+<itemizedlist>
+<listitem
+><para
+>Patrones.</para
+></listitem>
+<listitem
+><para
+>Declaraciones.</para
+></listitem>
+<listitem
+><para
+>Cuantificadores.</para
+></listitem>
+<listitem
+><para
+>Retroreferencias.</para
+></listitem>
+</itemizedlist>
+
+<para
+>El circunflejo (<literal
+>^</literal
+>) que se encuentra al principio de la expresión es una declaración, que sólo es cierta si el resto de la cadena de búsqueda se encuentra al principio de una línea.</para>
+
+<para
+>Las cadenas <literal
+>[ \t]</literal
+> y <literal
+>(Henrik|Pernille) hab(laba|ló)</literal
+> son patrones. El primero es una <emphasis
+>clase de caracteres</emphasis
+> que coincide con un espacio en blanco o con un tabulador (horizontal); el otro patrón contiene un primer subpatrón que coincide con <literal
+>Henrik</literal
+> <emphasis
+>o con</emphasis
+> <literal
+>Pernille</literal
+>, después una parte de coincidencia exacta <literal
+> hab</literal
+> y por último otro subpatrón que coincide con <literal
+>laba</literal
+> <emphasis
+>o con</emphasis
+> <literal
+>ló</literal
+>.</para>
+
+<para
+>La cadena <literal
+>{0,4}</literal
+> es un cuantificador que dice «en cualquier lugar desde 0 a 4 caracteres anteriores».</para>
+
+<para
+>Como el software de expresiones regulares que cuenta con el concepto de <emphasis
+>retroreferencias</emphasis
+> guarda toda la parte coincidente de la cadena así como los subpatrones encerrados entre paréntesis, proporcionando medios para acceder a esas referencias, podemos poner nuestras manos tanto en la cadena coincidente completa (cuando se busca en un texto de un editor por medio de una expresión regular, que normalmente aparece marcada como seleccionada) como en el nombre encontrado o en la última parte del verbo.</para>
+
+<para
+>Uniendo todo, la expresión coincidirá donde nosotros queramos, y únicamente ahí.</para>
+
+<para
+>Las siguientes secciones describirán con detalle cómo construir y utilizar patrones, clases de caracteres, declaraciones, cuantificadores y retroreferencias, y la última sección presentará una serie de ejemplo útiles.</para>
+
+</sect1>
+
+<sect1 id="regex-patterns">
+
+<title
+>Patrones</title>
+
+<para
+>Los patrones constan de cadenas literales y clases de caracteres. Los patrones pueden contener subpatrones, que son patrones colocados entre paréntesis.</para>
+
+<sect2>
+<title
+>Escape de caracteres</title>
+
+<para
+>En los patrones, así como en las clases de caracteres, algunos caracteres tienen un significado especial. Para conseguir una coincidencia literal con alguno de esos caracteres, es necesario marcarlos como <emphasis
+>escapados</emphasis
+> para permitir al intérprete de expresiones regulares comprender que esos caracteres deben ser incluídos con su significado literal.</para>
+
+<para
+>Esto se hace precendiendo el caracter de una barra invertida (<literal
+>\</literal
+>).</para>
+
+
+<para
+>El software de expresiones regulares ignorará el escapado de cualquier caracter que no tenga ningún significado especial en el contexto, así que escapar, por ejemplo, «j» (<userinput
+>\j</userinput
+>) no tiene por qué causar problemas. Si tiene dudas sobre cuando un caracter puede tener un significado especial, escápelo con seguridad.</para>
+
+<para
+>El escapado incluye el propio caracter de la barra invertida. Para poder presentarla de forma literal, debe escribir <userinput
+>\\</userinput
+>.</para>
+
+</sect2>
+
+<sect2>
+<title
+>Clases de caracteres y abreviaturas</title>
+
+<para
+>Una <emphasis
+>clase de caracteres</emphasis
+> es una expresión que coincide con un conjunto de caracteres definido. En las expresiones regulares, las clases de caracteres se definen colocando los caracteres válidos de la clase entre corchetes <literal
+>[]</literal
+>, o utilizando una de las clases abreviadas que se describen a continuación.</para>
+
+<para
+>Las clases de caracteres sencillas únicamente contienen uno o más caracteres literales, por ejemplo <userinput
+>[abc]</userinput
+> (que coincidirá con las letras «a», «b» o «c») o <userinput
+>[0123456789]</userinput
+> (que coincidirá con cualquiera de los dígitos).</para>
+
+<para
+>Como las letras y los números tienen un orden lógico, puede abreviarlo utilizando rangos: <userinput
+>[a-c]</userinput
+> es igual a <userinput
+>[abc]</userinput
+> y <userinput
+>[0-9]</userinput
+> es igual a <userinput
+>[0123456789]</userinput
+>. Combinando estas formaciones, por ejemplo <userinput
+>[a-fynot1-38]</userinput
+> resulta completamente válido (esta última debería coincidir con cualquier de los caracteres o dígitos «a»,«b»,«c»,«d», «e»,«f»,«y»,«n»,«o»,«t», «1»,«2»,«3» o «8»).</para>
+
+<para
+>Como las letras mayúsculas son diferentes caracteres que sus equivalentes minúsculas, para crear una clase de caracteres que sea independiente del formato de las letras, deberá escribir <userinput
+>[aAbB]</userinput
+>.</para>
+
+<para
+>También es posible crea una clase «negativa» para que se haga coincidir «todo menos». Para hacerlo incluya un circunflejo (<literal
+>^</literal
+>) al principio de la clase: </para>
+
+<para
+><userinput
+>[^abc]</userinput
+> coincidirá con cualquier caracter <emphasis
+>salvo con</emphasis
+> «a», «b» o «c».</para>
+
+<para
+>Además de los caracteres literales, hay algunas abreviaturas definidas, para facilitar un poco las cosas: <variablelist>
+
+<varlistentry>
+<term
+><userinput
+>\a</userinput
+></term>
+<listitem
+><para
+>Coincide con el caracter <acronym
+>ASCII</acronym
+> de la campanilla (BEL, 0x07).</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>\f</userinput
+></term>
+<listitem
+><para
+>Coincide con el caracter <acronym
+>ASCII</acronym
+> del salto de página (FF, 0x0C).</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>\n</userinput
+></term>
+<listitem
+><para
+>Coincide con el caracter <acronym
+>ASCII</acronym
+> de salto de línea (LF, 0x0A, nueva línea en Unix).</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>\r</userinput
+></term>
+<listitem
+><para
+>Coincide con el caracter <acronym
+>ASCII</acronym
+> de retorno de carro (CR, 0x0D).</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>\t</userinput
+></term>
+<listitem
+><para
+>Coincide con el caracter <acronym
+>ASCII</acronym
+> del tabulador horizontal (HT, 0x09).</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>\v</userinput
+></term>
+<listitem
+><para
+>Coincide con el caracter <acronym
+>ASCII</acronym
+> del tabulador vertical (VT, 0x0B).</para
+></listitem>
+</varlistentry>
+<varlistentry>
+<term
+><userinput
+>\xhhhh</userinput
+></term>
+
+<listitem
+><para
+>Coincide con el caracter Unicode correspondiente al número hexadecimal hhhh (entre 0x0000 y 0xFFFF). \0ooo (&ie;, \cero ooo) coincide con el caracter <acronym
+>ASCII</acronym
+>/Latin-1 correspondiente al número octal ooo (entre 0 y 0377).</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>.</userinput
+> (punto)</term>
+<listitem
+><para
+>Coincide con cualquier caracter (incluyendo nueva línea).</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>\d</userinput
+></term>
+<listitem
+><para
+>Coincide con un dígito. Es igual que <literal
+>[0-9]</literal
+>.</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>\D</userinput
+></term>
+<listitem
+><para
+>Coincide con un no dígito. Es igual que <literal
+>[^0-9]</literal
+> o <literal
+>[^\d]</literal
+></para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>\s</userinput
+></term>
+<listitem
+><para
+>Coincide con un caracter de espacio en blanco. Prácticamente igual que <literal
+>[\t\n\r]</literal
+></para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>\S</userinput
+></term>
+<listitem
+><para
+>Coincide con un no espacio en blanco. Prácticamente igual que <literal
+>[^\t\r\n]</literal
+>, e igual que <literal
+>[^\s]</literal
+>.</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>\w</userinput
+></term>
+<listitem
+><para
+>Coincide con cualquier «caracter de una palabra», en este caso cualquier letra o número. Tenga en cuenta que el subrayado (<literal
+>_</literal
+>) no está incluido, a diferencia de las expresiones regulares de perl. Es igual que <literal
+>[a-zA-Z0-9]</literal
+>.</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>\W</userinput
+></term>
+<listitem
+><para
+>Coincide con cualquier caracter que no sea de una palabra, cualquier cosa menos letras o números. Es igual que <literal
+>[^a-zA-Z0-9]</literal
+> o <literal
+>[^\w]</literal
+>.</para
+></listitem>
+</varlistentry>
+
+
+</variablelist>
+
+</para>
+
+<para
+>Las clases abreviadas se puede colocar dentro de una clase propia, por ejemplo para hacer coincidir un caracter de una palabra, un espacio en blanco o un punto, puede escribir <userinput
+>[\w \.]</userinput
+>.</para
+>
+
+<note
+> <para
+>Las notación POSIX de las clases, <userinput
+>[:&lt;class name&gt;:]</userinput
+> no está de momento implementada.</para
+> </note>
+
+<sect3>
+<title
+>Caracteres con significado especial dentro de las clases de caracteres</title>
+
+<para
+>Los siguientes caracteres tienen un significado especial dentro de la construcción de clases de caracteres «[]», y es necesario escaparlos para que sean incluídos literalmente en la clase:</para>
+
+<variablelist>
+<varlistentry>
+<term
+><userinput
+>]</userinput
+></term>
+<listitem
+><para
+>Finaliza la clase de caracteres. Debe estar escapado salvo que sea el primer caracter de la clase (puede seguir a un circunflejo no escapado).</para
+></listitem>
+</varlistentry>
+<varlistentry>
+<term
+><userinput
+>^</userinput
+> (circunflejo)</term>
+<listitem
+><para
+>Indica que se trata de una clase negativa, si es el primer caracter. Debe estar escapado para buscar una coincidencia literal en el caso de que sea el primer caracter de la clase.</para
+></listitem
+>
+</varlistentry>
+<varlistentry>
+<term
+><userinput
+>-</userinput
+> (guión)</term>
+<listitem
+><para
+>Indica un rango lógico. Debe estar escapado siempre que se busque la coincidencia literal.</para
+></listitem>
+</varlistentry>
+<varlistentry>
+<term
+><userinput
+>\</userinput
+> (barra invertida)</term>
+<listitem
+><para
+>El caracter de escape. Debe estar siempre escapado.</para
+></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect3>
+
+</sect2>
+
+<sect2>
+
+<title
+>Alternativas: coincidencias con «uno de»</title>
+
+<para
+>Si desea que la coincidencia sea de uno de una serie de patrones, puede separarlos con <literal
+>|</literal
+> (caracter de barra vertical).</para>
+
+<para
+>Por ejemplo, para encontrar «John» o «Harry», debería utilizar una expresión de la forma <userinput
+>John|Harry</userinput
+>.</para>
+
+</sect2>
+
+<sect2>
+
+<title
+>Subpatrones</title>
+
+<para
+>Los <emphasis
+>subpatrones</emphasis
+> son patrones colocados entre paréntesis, y tienen varios usos en el mundo de las expresiones regulares.</para>
+
+<sect3>
+
+<title
+>Especificación de alternativas</title>
+
+<para
+>Puede utilizar un subpatrón para agrupar un conjunto de alternativas dentro de un patrón más grande. Las alternativas se separan con el caracter «|» (barra vertical).</para>
+
+<para
+>Por ejemplo, para buscar la coincidencia de las palabras «int», «float» o «double», se podría utilizar el patrón <userinput
+>int|float|double</userinput
+>. Si únicamente desea encontrar una de ellas en el caso de que vaya seguida de algún tipo de espacio en blanco y después algunas letras, ponga las alternativas dentro de un subpatrón: <userinput
+>(int|float|double)\s+\w+</userinput
+>.</para>
+
+</sect3>
+
+<sect3>
+
+<title
+>Captura del texto coincidente (retroreferencias)</title>
+
+<para
+>Si desea utilizar una retroreferencia, utilice un subpatrón para que se recuerde la parte deseada del patrón.</para>
+
+<para
+>Por ejemplo, si desea encontrar dos apariciones de la misma palabra separadas por una coma y posiblemente algún espacio en blanco, puede escribir <userinput
+>(\w+),\s*\1</userinput
+>. El subpatrón <literal
+>\w+</literal
+> localizará un conjunto de caracteres de una palabra, y la expresión entera coincidirá si ese conjunto va seguido de una coma, 0 o más espacios en blanco y después un conjunto de caracteres de una palabra igual al primero. (La cadena <literal
+>\1</literal
+> hace referencia al <emphasis
+>primer subpatrón delimitado por paréntesis</emphasis
+>).</para>
+
+<!-- <para
+>See also <link linkend="backreferences"
+>Back references</link
+>.</para
+> -->
+
+</sect3>
+
+<sect3 id="lookahead-assertions">
+<title
+>Declaraciones de anticipación</title>
+
+<para
+>Una declaración de anticipación es un subpatrón, que comienza por <literal
+>?=</literal
+> o por <literal
+>?!</literal
+>.</para>
+
+<para
+>Por ejemplo, si quiere buscar la cadena literal «Bill», pero únicamente si no va seguida de « Gates», puede utilizar la expresión: <userinput
+>Bill(?! Gates)</userinput
+>. (Esto coincidiría con «Bill Clinton» y con «Billy el niño», pero ignoraría en silencio las otras coincidencias).</para>
+
+<para
+>Los subpatrones utilizados en las declaraciones no se capturan.</para>
+
+<para
+>Consulte también <link linkend="assertions"
+>Declaraciones</link
+>.</para>
+
+</sect3>
+
+</sect2>
+
+<sect2 id="special-characters-in-patterns">
+<title
+>Caracteres con un significado especial dentro de los patrones.</title>
+
+<para
+>Los siguientes caracteres tienen significado dentro de los patrones, y es necesario escaparlos para una coincidencia literal: <variablelist>
+
+<varlistentry>
+<term
+><userinput
+>\</userinput
+> (barra invertida)</term>
+<listitem
+><para
+>El caracter de escape.</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>^</userinput
+> (circunflejo)</term>
+<listitem
+><para
+>Declara el comienzo de la cadena.</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>$</userinput
+></term>
+<listitem
+><para
+>Declara el fin de la cadena.</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>()</userinput
+> (paréntesis derecho e izquierdo)</term>
+<listitem
+><para
+>Denotan subpatrones.</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>{}</userinput
+> (llaves derecha e izquierda)</term>
+<listitem
+><para
+>Denotan cuantificadores numéricos.</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>[]</userinput
+> (corchetes derecho e izquierdo)</term>
+<listitem
+><para
+>Denotan clases de caracteres.</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>|</userinput
+> (barra vertical)</term>
+<listitem
+><para
+>O lógico. Separa alternativas.</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>+</userinput
+> (signo más)</term>
+<listitem
+><para
+>Cuantificador, 1 o más.</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>*</userinput
+> (asterisco)</term>
+<listitem
+><para
+>Cuantificador, 0 o más.</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>?</userinput
+> (signo de interrogación)</term>
+<listitem
+><para
+>Un caracter opcional. Se puede interpretar como cuantificador, 0 o 1.</para
+></listitem>
+</varlistentry>
+
+</variablelist>
+
+</para>
+
+</sect2>
+
+</sect1>
+
+<sect1 id="quantifiers">
+<title
+>Cuantificadores</title>
+
+<para
+>Los <emphasis
+>cuantificadores</emphasis
+> permiten que una expresión regular coincida con un número o un rango de números de cualquier caracter, una clase de caracteres o un subpatrón.</para>
+
+<para
+>Los cuantificadores se colocan entre llaves (<literal
+>{</literal
+> y <literal
+>}</literal
+>). Tiene la forma general <literal
+>{[apariciones-mínimas][,[apariciones-máximas]]}</literal
+> </para>
+
+<para
+>Su uso se explica mejor en este ejemplo: <variablelist>
+
+<varlistentry>
+<term
+><userinput
+>{1}</userinput
+></term>
+<listitem
+><para
+>Exactamente 1 aparición.</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>{0,1}</userinput
+></term>
+<listitem
+><para
+>Cero o 1 apariciones.</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>{,1}</userinput
+></term>
+<listitem
+><para
+>Lo mismo, pero con menos trabajo ;)</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>{5,10}</userinput
+></term>
+<listitem
+><para
+>Como mínimo 5 y como máximo 10 apariciones.</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>{5,}</userinput
+></term>
+<listitem
+><para
+>Como mínimo 5 apariciones, sin máximo.</para
+></listitem>
+</varlistentry>
+
+</variablelist>
+
+</para>
+
+<para
+>Además, hay algunas abreviaturas: <variablelist>
+
+<varlistentry>
+<term
+><userinput
+>*</userinput
+> (asterisco)</term>
+<listitem
+><para
+>Similar a <literal
+>{0,}</literal
+>, encuentra cualquier número de apariciones.</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>+</userinput
+> (signo más)</term>
+<listitem
+><para
+>Similar a <literal
+>{1,}</literal
+>, al menos 1 aparición.</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>?</userinput
+> (signo de interrogación)</term>
+<listitem
+><para
+>Similar a <literal
+>{0,1}</literal
+>, cero o 1 apariciones.</para
+></listitem>
+</varlistentry>
+
+</variablelist>
+
+</para>
+
+<sect2>
+
+<title
+>Codicia</title>
+
+<para
+>Cuando se utilizan cuantificadores sin máximo, las expresiones regulares tratan de coincidir con la mayor parte posible de la cadena buscada, conociéndose este comportamiento como <emphasis
+>codicioso</emphasis
+>.</para>
+
+<para
+>Los procesadores de expresiones regulares modernos, proporcionan los medios para «desactivar la codicia», aunque en los entornos gráficos depende del interfaz el tener acceso a esta característica. Por ejemplo, un diálogo de búsqueda que permita expresiones regulares, podría tener una casilla de comprobación llamada «Coincidencia mínima». Además podría haber una indicación sobre que el comportamiento predeterminado es el codicioso.</para>
+
+</sect2>
+
+<sect2>
+<title
+>Ejemplos en contexto</title>
+
+<para
+>Estos son algunos ejemplos que utilizan cuantificadores:</para>
+
+<variablelist>
+
+<varlistentry>
+<term
+><userinput
+>^\d{4,5}\s</userinput
+></term>
+<listitem
+><para
+>Coincide con los dígitos en «1234 ya» y «12345 ahora», pero no con los de «567 once» ni los de «223459 algún lugar».</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>\s+</userinput
+></term>
+<listitem
+><para
+>Coincide con uno o más espacios en blanco.</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>(bla){1,}</userinput
+></term>
+<listitem
+><para
+>Coincide con «blablabla» y con el «bla» de «blanco» o «tabla».</para
+></listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>/?&gt;</userinput
+></term>
+<listitem
+><para
+>Coincide con «/&gt;» en «&lt;cerrado/&gt;» así como con «&gt;» en «&lt;abierto&gt;».</para
+></listitem>
+</varlistentry>
+
+</variablelist>
+
+</sect2>
+
+</sect1>
+
+<sect1 id="assertions">
+<title
+>Declaraciones</title>
+
+<para
+>Las <emphasis
+>declaraciones</emphasis
+> permiten que una expresión regular coincida únicamente bajo una serie de condiciones controladas.</para>
+
+<para
+>Una declaración no necesita la coincidencia de un caracter, sino que investiga los alrededores en una busca de una posible coincidencia antes de darla por válida. Por ejemplo, la declaración <emphasis
+>límite de palabra</emphasis
+> no intenta encontrar un caracter que no sea de una palabra en oposición a uno que sí lo sea en su posición, en vez de eso trata de asegurarse de que no es un caracter de una palabra. Esto significa que la declaración puede ser válida en el caso de que no haya ningún caracter, &ie; al final de la cadena buscada.</para>
+
+<para
+>Algunas declaraciones, de hecho, no tienen un patrón con el que coincidir, sino que la parte coincidente de la cadena no será parte del resultado de la coincidencia de la expresión completa.</para>
+
+<para
+>Las expresiones regulares documentadas aquí soportan las siguientes declaraciones: <variablelist>
+
+<varlistentry
+>
+<term
+><userinput
+>^</userinput
+> (circunflejo: el principio de una cadena)</term
+>
+<listitem
+><para
+>Concuerda con el comienzo de la cadena buscada.</para
+> <para
+>La expresión <userinput
+>^Peter</userinput
+> coincidirá con «Peter» en la cadena «Peter, ¡hola!» pero no en «¡Hola Peter!» </para
+> </listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>$</userinput
+> (final de la cadena)</term>
+<listitem
+><para
+>Coincide con el final de la cadena buscada.</para>
+
+<para
+>La espresión <userinput
+>tú\?$</userinput
+> coincidirá con el final de la cadena «¿No lo has hecho tú?», pero con ninguna parte de «¿Tú no lo has hecho?»</para>
+
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>\b</userinput
+> (límite de palabra</term>
+<listitem
+><para
+>Coincide si hay un caracter de una palabra a un lado y otro que no sea de una palabra al otro.</para>
+<para
+>Esto es muy útil para encontrar el final de las palabras, o ambos extremos para delimitar la palabra entera. La expresión <userinput
+>\ben\b</userinput
+> coincidirá con el «en» separado en la cadena «Estamos en el borde de la ventana», pero no con el «en» de «ventana».</para
+></listitem>
+
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>\B</userinput
+> (límite de no palabra)</term>
+<listitem
+><para
+>Coincide con todo lo que «\b» no coincide.</para>
+<para
+>Eso significa que coincidirá, por ejemplo, dentro de las palabras: La expresión <userinput
+>\Ben\B</userinput
+> coincidirá en «ventana» pero no en «entero» o en «estoy en mi casa».</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>(?=PATRÓN)</userinput
+> (Anticipación positiva)</term>
+<listitem
+><para
+>Una declaración de anticipación busca la parte de la cadena seguida de una posible coincidencia. La antipación positiva previene la coincidencia de la cadena si el texto que sigue no corresponde al <emphasis
+>PATRÓN</emphasis
+> de la declaración, y el texto que coincide con eso no será incluido en el resultado.</para>
+<para
+>La expresión <userinput
+>util(?=\w)</userinput
+> coincidirá con «util» en «utilitario» pero no en «Eso es de gran utilidad».</para>
+</listitem>
+</varlistentry>
+
+<varlistentry>
+<term
+><userinput
+>(?!PATRÓN)</userinput
+> (Anticipación negativa)</term>
+
+<listitem
+><para
+>La anticipación negativa previene una posible coincidencia si la parte siguiente de la cadena coincide con el <emphasis
+>PATRÓN</emphasis
+>.</para>
+<para
+>La expresión <userinput
+>const \w+\b(?!\s*&amp;)</userinput
+> coincidirá con «const char» en la cadena «const char* foo», mientras que no coincidirá con «const QString» en «const QString&amp; bar», ya que el «&amp;» coincide con el patrón de la declaración de anticipación negativa.</para>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</para>
+
+</sect1>
+
+<!-- TODO sect1 id="backreferences">
+
+<title
+>Back References</title>
+
+<para
+></para>
+
+</sect1 -->
+
+</appendix>