summaryrefslogtreecommitdiffstats
path: root/tde-i18n-pt/docs/tdebase/kate/regular-expressions.docbook
blob: 7c50469ddc2d7c91b309f9d62301b8b21728fb0b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
<appendix id="regular-expressions">
<appendixinfo>
<authorgroup>
<author>&Anders.Lund; &Anders.Lund.mail;</author>
<othercredit role="translator"><firstname>José</firstname><surname>Pires</surname><affiliation><address><email>jncp@netcabo.pt</email></address></affiliation><contrib>Tradução</contrib></othercredit> 
</authorgroup>
</appendixinfo>

<title>Expressões Regulares</title>

<synopsis>Este Apêndice contém uma breve, mas abrangente e suficiente, introdução
ao mundo das <emphasis>expressões regulares</emphasis>. Ela documenta as
expressões regulares na forma que está disponível no &kate;, a qual não é
compatível com as expressões regulares do Perl, nem com as do 
<command>grep</command>, por exemplo.</synopsis>

<sect1>

<title>Introdução</title>

<para>As <emphasis>Expressões Regulares</emphasis> oferecem-nos uma forma de descrever alguns conteúdos possíveis de uma sequência de texto, a qual pode ser compreendida de certa forma por algum 'software', de modo a que este possa investigar se um texto corresponde, e também no caso das aplicações avançadas, com a possibilidade de guardar pedaços do texto correspondente.</para>

<para>Um exemplo: Imagine que deseja procurar num texto por parágrafos que comecem quer pelos nomes <quote>Henrique</quote> ou <quote>Pedro</quote>, seguidos de alguma forma do verbo <quote>dizer</quote>.</para>

<para>Com uma pesquisa normal, iria começar a procurar pelo primeiro nome, <quote>Henrique</quote>, sendo talvez seguido de <quote>di</quote>, como o seguinte: <userinput>Henrique di</userinput> e, enquanto procura por ocorrências, iria ignorar os que não se encontram no início de um parágrafo, assim como os que têm uma palavra que começa por <quote>di</quote> que não é <quote>diz</quote>, <quote>disse</quote> ou algo do género. Claro, e ainda ter que repetir isto com o próximo nome...</para>

<para>Com as Expressões Regulares, essa tarefa pode ser acompanhada com uma única pesquisa e com um maior grau de precisão.</para>

<para>Para conseguir isto, as Expressões Regulares definem regras para exprimir com detalhe uma generalização de uma sequência de texto com a qual corresponder. No nosso exemplo, o qual podemos exprimir literalmente da seguinte forma: <quote>Uma linha que começa por <quote>Henrique</quote> ou <quote>Pedro</quote> (possivelmente a seguir a 4 espaços ou tabulações) seguida de um espaço em branco e da sequência <quote>di</quote>, sendo esta seguida de <quote>z</quote> ou <quote>sse</quote></quote> pode ser expressa com a seguinte expressão regular:</para> <para><userinput>^[ \t]{0,4}(Henrique|Pedro) di(z|sse)</userinput></para>

<para>O exemplo anterior demonstra todos os quatro maiores conceitos das expressões regulares modernas, nomeadamente:</para>

<itemizedlist>
<listitem><para>Padrões</para></listitem>
<listitem><para>Asserções</para></listitem>
<listitem><para>Quantificadores</para></listitem>
<listitem><para>Referências anteriores</para></listitem>
</itemizedlist>

<para>O acento circunflexo (<literal>^</literal>) no início da expressão é uma asserção ou verificação que é verdadeira só se o texto correspondente está no início da linha.</para>

<para>As sequências <literal>[ \t]</literal> e <literal>(Henrique|Pedro) di(z|se)</literal> são padrões. O primeiro é uma <emphasis>classe de caracteres</emphasis> que corresponde quer a um espaço em branco quer a uma tabulação (horizontal); o outro padrão contém, em primeiro lugar, um sub-padrão que corresponde quer a <literal>Henrique</literal> <emphasis>quer a</emphasis> <literal>Pedro</literal>, pelo que se segue o texto exacto <literal> di</literal> e, finalmente, existe um sub-padrão que corresponde a <literal>z</literal> <emphasis>ou</emphasis> a <literal>sse</literal></para>

<para>A sequência <literal>{0,4}</literal> é um quantificador que diz <quote>qualquer número de vezes entre 0 e 4 da sequência anterior</quote>.</para>

<para>Como o 'software' de expressões regulares suporta o conceito de <emphasis>referências anteriores</emphasis>, ele guarda a parte inteira correspondente ao texto, bem como aos sub-padrões entre parêntesis; se for dado um meio de aceder a essas referências, pode-se aceder a toda a correspondência (ao procurar num documento de texto num editor com uma expressão regular, esta é normalmente marcada como seleccionada), apenas ao nome encontrado, ou à última parte do verbo.</para>

<para>Tudo em conjunto, a expressão irá corresponder onde nós queiramos que o faça, e só aí.</para>

<para>As secções seguintes irão descrever em detalhe como construir e usar os padrões, as classes de caracteres, as verificações, os quantificadores e as referências anteriores; a secção final irá dar alguns exemplos úteis.</para>

</sect1>

<sect1 id="regex-patterns">

<title>Padrões</title>

<para>Os padrões consistem em cadeias de caracteres literais e em classes de caracteres. Os padrões podem conter sub-padrões, que são padrões entre parêntesis.</para>

<sect2>
<title>Caracteres de escape</title>

<para>Tanto nos padrões como nas classes de caracteres, alguns caracteres têm um significado especial. Para corresponder literalmente com algum desses caracteres, estes têm de ser marcados ou <emphasis>escapados</emphasis>, para permitir ao 'software' de expressões regulares perceber que deve interpretar esses caracteres no seu sentido literal.</para>

<para>Isto é feito, antecedendo o carácter com uma barra invertida (<literal>\</literal>).</para>


<para>O 'software' de expressões regulares irá ignorar silenciosamente uma barra para um carácter que não tenha um significado especial no contexto; por isso, se escapar, por exemplo, um <quote>j</quote> (<userinput>\j</userinput>), não há problema. Se tiver dúvidas se um carácter poderá ter algum significado especial, podê-lo-á então escapar em segurança.</para>

<para>A marcação inclui o próprio carácter de barra; por isso, para escapar uma barra, deveria escrever <userinput>\\</userinput>.</para>

</sect2>

<sect2>
<title>Classes de Caracteres e abreviaturas</title>

<para>Uma <emphasis>classe de caracteres</emphasis> é uma expressão que corresponde a um carácter, dentro de um conjunto definido de caracteres. Nas Expressões Regulares, as classes de caracteres são definidas, pondo os caracteres permitidos para a classe entre parêntesis rectos, <literal>[]</literal>, ou usando uma das classes abreviadas descritas em seguida.</para>

<para>As classes de caracteres simples contêm apenas um ou mais caracteres literais, como por exemplo <userinput>[abc]</userinput> (o que pode corresponder quer a <quote>a</quote>, a <quote>b</quote> ou a <quote>c</quote>), ou então o <userinput>[0123456789]</userinput> (que corresponde a qualquer dígito).</para>

<para>Dado que as letras e os números têm uma ordem lógica, podê-los-á abreviar, indicando intervalos: o <userinput>[a-c]</userinput> é igual a <userinput>[abc]</userinput> e o <userinput>[0-9]</userinput> é igual a <userinput>[0123456789]</userinput>. Combinando estas opções, por exemplo <userinput>[a-fynot1-38]</userinput> é perfeitamente possível (a última classe irá corresponder a um dos seguintes caracteres: <quote>a</quote>,<quote>b</quote>,<quote>c</quote>,<quote>d</quote>, <quote>e</quote>,<quote>f</quote>,<quote>y</quote>,<quote>n</quote>,<quote>o</quote>,<quote>t</quote>, <quote>1</quote>,<quote>2</quote>,<quote>3</quote> ou <quote>8</quote>).</para>

<para>Dado que as letras maiúsculas são caracteres diferentes dos seus equivalentes minúsculos, para criar uma classe de caracteres indiferente da capitalização que corresponda quer a <quote>a</quote> ou a <quote>b</quote> em qualquer dos casos, será necessário indicá-la como <userinput>[aAbB]</userinput>.</para>

<para>Obviamente, é possível criar uma classe <quote>negativa</quote> que corresponda a <quote>tudo excepto</quote>. Para o fazer, coloque um acento circunflexo (<literal>^</literal>) no início da classe: </para>

<para><userinput>[^abc]</userinput> irá corresponder a qualquer carácter <emphasis>excepto</emphasis> o <quote>a</quote>, o <quote>b</quote> ou o <quote>c</quote>.</para>

<para>Para além dos caracteres literais, estão definidas algumas abreviaturas, o que torna a vida um pouco mais fácil: <variablelist>

<varlistentry>
<term><userinput>\a</userinput></term>
<listitem><para>Isto corresponde ao carácter <acronym>ASCII</acronym> da campainha (BEL, 0x07).</para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>\f</userinput></term>
<listitem><para>Isto corresponde ao carácter <acronym>ASCII</acronym> de 'form feed' (FF, 0x0C).</para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>\n</userinput></term>
<listitem><para>Isto corresponde ao carácter <acronym>ASCII</acronym> de 'line feed' (LF, 0x0A, a mudança de linha do Unix).</para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>\r</userinput></term>
<listitem><para>Isto corresponde ao carácter <acronym>ASCII</acronym> de 'carriage return' (CR, 0x0D).</para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>\t</userinput></term>
<listitem><para>Isto corresponde ao carácter <acronym>ASCII</acronym> de tabulação horizontal (HT, 0x09).</para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>\v</userinput></term>
<listitem><para>Isto corresponde ao carácter <acronym>ASCII</acronym> de tabulação vertical (VT, 0x0B).</para></listitem>
</varlistentry>
<varlistentry>
<term><userinput>\xhhhh</userinput></term>

<listitem><para>Isto corresponde ao carácter Unicode com o código hexadecimal 'hhhh' (entre 0x0000 e 0xFFFF). O \0ooo (isto é, \zero ooo) corresponde ao carácter <acronym>ASCII</acronym>/Latin-1 com o código octal 'ooo' (entre 0 e 0377).</para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>.</userinput> (ponto)</term>
<listitem><para>Isto corresponde a qualquer carácter (mesmo à mudança de linha).</para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>\d</userinput></term>
<listitem><para>Corresponde a um dígito. É igual a <literal>[0-9]</literal></para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>\D</userinput></term>
<listitem><para>Corresponde a um não-dígito. É igual a <literal>[^0-9]</literal> ou <literal>[^\d]</literal></para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>\s</userinput></term>
<listitem><para>Corresponde a um carácter em branco. É praticamente igual a <literal>[ \t\n\r]</literal></para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>\S</userinput></term>
<listitem><para>Corresponde a um carácter não-branco. É praticamente igual a <literal>[^ \t\r\n]</literal> e igual a <literal>[^\s]</literal></para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>\w</userinput></term>
<listitem><para>Corresponde a qualquer <quote>carácter de palavra</quote> - neste caso, qualquer letra ou dígito. Repare que o sublinhado (<literal>_</literal>) não corresponde, como acontece com as expressões regulares do Perl. É igual a <literal>[a-zA-Z0-9]</literal></para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>\W</userinput></term>
<listitem><para>Corresponde a um não-carácter de palavra - tudo menos letras ou dígitos. É igual a <literal>[^a-zA-Z0-9]</literal> ou <literal>[^\w]</literal></para></listitem>
</varlistentry>


</variablelist>

</para>

<para>As classes abreviadas podem ser postas dentro de uma classe personalizada; por exemplo, para corresponder a um carácter de palavra, a um espaço em branco ou a um ponto, poderia escrever <userinput>[\w \.]</userinput></para> 

<note> <para>A notação POSIX das classes, <userinput>[:&lt;nome da classe&gt;:]</userinput> não é suportada de momento.</para> </note>

<sect3>
<title>Os caracteres com significados especiais dentro de classes de caracteres</title>

<para>Os seguintes caracteres têm um significado especial dentro da estrutura da classe de caracteres <quote>[]</quote>, devendo ser escapados para serem incluídos literalmente dentro de uma classe:</para>

<variablelist>
<varlistentry>
<term><userinput>]</userinput></term>
<listitem><para>Termina a classe de caracteres. Deve ser escapada, a menos que seja o primeiro carácter da classe (pode estar a seguir a um ^ não-escapado)</para></listitem>
</varlistentry>
<varlistentry>
<term><userinput>^</userinput> (acento circunflexo)</term>
<listitem><para>Denota uma classe negativa, se for o primeiro carácter. Deve ser escapado para ser correspondido literalmente, se for o primeiro carácter da classe.</para></listitem> 
</varlistentry>
<varlistentry>
<term><userinput>-</userinput> (traço)</term>
<listitem><para>Denota um intervalo lógico. Deve estar sempre escapado numa classe de caracteres.</para></listitem>
</varlistentry>
<varlistentry>
<term><userinput>\</userinput> (barra invertida)</term>
<listitem><para>O carácter de escape. Deve ser sempre escapado.</para></listitem>
</varlistentry>

</variablelist>

</sect3>

</sect2>

<sect2>

<title>Alternativas: corresponder a <quote>um de</quote></title>

<para>Se quiser corresponder a um elemento de um conjunto de padrões alternativos, podê-los-á separar com o <literal>|</literal> (carácter de barra vertical).</para>

<para>Por exemplo, se quiser encontrar tanto <quote>João</quote> como <quote>Henrique</quote>, poderá usar uma expressão <userinput>João|Henrique</userinput>.</para>

</sect2>

<sect2>

<title>Sub-Padrões</title>

<para>Os <emphasis>sub-padrões</emphasis> são padrões colocados dentro de parêntesis, e podem ter várias utilizações no mundo das expressões regulares.</para>

<sect3>

<title>Definir alternativas</title>

<para>Poderá usar um sub-padrão para agrupar um conjunto de alternativas num padrão maior. As alternativas são separadas pelo carácter <quote>|</quote> (barra vertical).</para>

<para>Por exemplo, para corresponder a uma das palavras <quote>int</quote>, <quote>float</quote> ou <quote>double</quote>, poderia usar o padrão <userinput>int|float|double</userinput>. Se só desejar encontrar uma, se estiver seguida de algum espaço e de algumas letras, ponha as alternativas dentro de um sub-padrão: <userinput>(int|float|double)\s+\w+</userinput>.</para>

</sect3>

<sect3>

<title>Capturar o texto correspondente (referências anteriores)</title>

<para>Se desejar usar uma referência anterior, use um sub-padrão para obter a parte desejada do padrão recordado.</para>

<para>Por exemplo, se quiser encontrar duas ocorrências da mesma palavra, separadas por uma vírgula e provavelmente por algum espaço, poderia escrever <userinput>(\w+),\s*\1</userinput>. O sub-padrão <literal>\w+</literal> iria encontrar um conjunto de caracteres de palavra e a expressão inteira iria corresponder, se estas fossem seguidas por uma vírgula, 0 ou mais espaços e por um conjunto igual de caracteres de palavras. (O texto <literal>\1</literal> referencia <emphasis>o primeiro sub-padrão entre parêntesis</emphasis>)</para>

<!-- <para>See also <link linkend="backreferences">Back references</link>.</para> -->

</sect3>

<sect3 id="lookahead-assertions">
<title>Verificações Antecipadas</title>

<para>Uma verificação antecipada é um sub-padrão que começa por <literal>?=</literal> ou por <literal>?!</literal>.</para>

<para>Por exemplo, para fazer a correspondência com o nome <quote>Bill</quote> mas só se não for seguido de <quote> Gates</quote>, podia usar esta expressão: <userinput>Bill(?! Gates)</userinput>. (Isto iria encontrar o <quote>Bill Clinton</quote>, assim como o <quote>Billy the kid</quote>, mas iria ignorar as outras correspondências).</para>

<para>Os sub-padrões usados para as verificações não são capturados.</para>

<para>Veja também as <link linkend="assertions">Asserções ou Verificações</link></para>

</sect3>

</sect2>

<sect2 id="special-characters-in-patterns">
<title>Os caracteres com um significado especial dentro de padrões</title>

<para>Os seguintes caracteres têm significado próprio dentro de um padrão, e necessitam ser escapados se quiser fazer correspondência com eles: <variablelist>

<varlistentry>
<term><userinput>\</userinput> (barra invertida)</term>
<listitem><para>O carácter de escape.</para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>^</userinput> (acento circunflexo)</term>
<listitem><para>Corresponde ao início do texto.</para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>$</userinput></term>
<listitem><para>Verifica o fim do texto.</para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>()</userinput> (parêntesis esquerdo e direito)</term>
<listitem><para>Denota os sub-padrões.</para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>{}</userinput> (chavetas esquerda e direita)</term>
<listitem><para>Denota os quantificadores numéricos.</para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>[]</userinput> (parêntesis rectos esquerdo e direito)</term>
<listitem><para>Denota as classes de caracteres.</para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>|</userinput> (barra vertical)</term>
<listitem><para>OU lógico; separa as alternativas.</para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>+</userinput> (sinal mais)</term>
<listitem><para>Quantificador, 1 ou mais.</para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>*</userinput> (asterisco)</term>
<listitem><para>Quantificador, 0 ou mais.</para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>?</userinput> (ponto de interrogação)</term>
<listitem><para>Um carácter opcional. Pode ser interpretado como um quantificador 0 ou 1.</para></listitem>
</varlistentry>

</variablelist>

</para>

</sect2>

</sect1>

<sect1 id="quantifiers">
<title>Quantificadores</title>

<para>Os <emphasis>quantificadores</emphasis> permitem a uma expressão regular fazer a correspondência com um número ou intervalo específico de vezes nas quais ocorre um carácter, classe de caracteres ou sub-padrão.</para>

<para>Os quantificadores estão delimitados por chavetas (<literal>{</literal> e <literal>}</literal>) e têm a forma geral <literal>{[mínimo-de-ocorrências][,[máximo-de-ocorrências]]}</literal> </para>

<para>A sua utilização será melhor explicada com um exemplo: <variablelist>

<varlistentry>
<term><userinput>{1}</userinput></term>
<listitem><para>Exactamente 1 ocorrência</para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>{0,1}</userinput></term>
<listitem><para>Zero ou 1 ocorrências</para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>{,1}</userinput></term>
<listitem><para>O mesmo, mas com menos trabalho ;)</para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>{5,10}</userinput></term>
<listitem><para>Pelo menos 5, mas no máximo 10 ocorrências.</para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>{5,}</userinput></term>
<listitem><para>Pelo menos 5 ocorrências, sem máximo.</para></listitem>
</varlistentry>

</variablelist>

</para>

<para>Adicionalmente, existem algumas abreviaturas: <variablelist>

<varlistentry>
<term><userinput>*</userinput> (asterisco)</term>
<listitem><para>semelhante a <literal>{0,}</literal>, encontra qualquer número de ocorrências.</para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>+</userinput> (sinal mais)</term>
<listitem><para>semelhante a <literal>{1,}</literal>, pelo menos 1 ocorrência.</para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>?</userinput> (ponto de interrogação)</term>
<listitem><para>semelhante a <literal>{0,1}</literal>, zero ou uma ocorrências.</para></listitem>
</varlistentry>

</variablelist>

</para>

<sect2>

<title>Ganância</title>

<para>Ao usar quantificadores sem máximos, as expressões regulares tentam corresponder com o máximo do texto possível, um comportamento designado normalmente como <emphasis>greedy</emphasis> (ambicioso).</para>

<para>O 'software' de expressões regulares moderno oferece as opções para <quote>desligar esse comportamento</quote>, ainda que, num ambiente gráfico, isto dependa da interface que der para a funcionalidade. Por exemplo, uma janela de procura, que ofereça uma pesquisa de expressões regulares, poderia ter uma opção chamada <quote>Correspondência mínima</quote>, assim como podia indicar se o comportamento ambicioso é o comportamento por omissão.</para>

</sect2>

<sect2>
<title>Exemplos no contexto</title>

<para>Aqui estão alguns exemplos da utilização de quantificadores</para>

<variablelist>

<varlistentry>
<term><userinput>^\d{4,5}\s</userinput></term>
<listitem><para>Corresponde aos dígitos em <quote>1234 go</quote> e em <quote>12345 now</quote>, mas não corresponde a <quote>567 eleven</quote> ou a <quote>223459 somewhere</quote></para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>\s+</userinput></term>
<listitem><para>Corresponde a um ou mais caracteres em branco</para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>(bla){1,}</userinput></term>
<listitem><para>Corresponde a tudo de <quote>blablabla</quote> e a <quote>bla</quote> em <quote>blackbird</quote> ou em <quote>tabela</quote></para></listitem>
</varlistentry>

<varlistentry>
<term><userinput>/?&gt;</userinput></term>
<listitem><para>Corresponde a <quote>/&gt;</quote> em <quote>&lt;closeditem/&gt;</quote> assim como a <quote>&gt;</quote> em <quote>&lt;openitem&gt;</quote>.</para></listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>

<sect1 id="assertions">
<title>Asserções</title>

<para>As <emphasis>verificações</emphasis> ou asserções permitem a uma expressão regular fazer a correspondência, apenas sob determinadas condições controladas.</para>

<para>Uma verificação não precisa de um carácter com o qual corresponder; em vez disso, verifica os limites de uma possível correspondência antes de a indicar. Por exemplo, a verificação de <emphasis>limite de palavra</emphasis> não tenta encontrar um carácter não pertencente a uma palavra junto com um carácter de palavra, mas sim tenta ter a certeza que não existe um carácter de palavra. Isto significa que a verificação pode corresponder onde não existir um carácter, isto é, no fim do texto a pesquisar.</para>

<para>Algumas verificações, de facto, têm um padrão de correspondência, mas a parte do texto que correspondeu não será uma parte do resultado da correspondência, em relação à expressão completa.</para>

<para>As Expressões Regulares aqui referidas suportam as seguintes verificações: <variablelist>

<varlistentry> 
<term><userinput>^</userinput> (acento circunflexo: início do texto)</term> 
<listitem><para>Corresponde ao início do texto a pesquisar.</para> <para>A expressão <userinput>^Pedro</userinput> irá corresponder a <quote>Pedro</quote> no texto <quote>Pedro, olá!</quote> mas não em <quote>Olá, Pedro!</quote> </para> </listitem>
</varlistentry>

<varlistentry>
<term><userinput>$</userinput> (fim do texto)</term>
<listitem><para>Corresponde ao fim do texto a pesquisar.</para>

<para>A expressão <userinput>tu\?$</userinput> irá corresponder ao último 'tu' no texto <quote>tu não fizeste isto, ou foste tu?</quote> mas não fará correspondência em <quote>tu não fizeste isto, certo?</quote></para>

</listitem>
</varlistentry>

<varlistentry>
<term><userinput>\b</userinput> (limite de palavra)</term>
<listitem><para>Corresponde a um limite de palavra de um lado e se não é um carácter de palavra do outro.</para>
<para>Isto é útil para encontrar limites das palavras como, por exemplo, ambos os extremos para encontrar uma palavra inteira. A expressão <userinput>\bem\b</userinput> irá corresponde ao <quote>em</quote> separado no texto <quote>Ele entrou em Enfermagem</quote>, mas não corresponder a <quote>em</quote> na palavra <quote>Enfermagem</quote>.</para></listitem>

</varlistentry>

<varlistentry>
<term><userinput>\B</userinput> (não-limite de palavra)</term>
<listitem><para>Corresponde nos locais onde o <quote>\b</quote> não faz correspondência.</para>
<para>Isto significa que ele irá fazer correspondência, por exemplo, dentro de palavras. A expressão <userinput>\Bem\B</userinput> irá corresponder a <quote>sempre</quote> mas não a <quote>cem</quote> ou a <quote>Estou em casa</quote>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><userinput>(?=PADRÃO)</userinput> (Antevisão positiva)</term>
<listitem><para>Uma verificação antecipada olha para a parte do texto a seguir a uma possível correspondência. A antecipação positiva irá evitar que o texto corresponda se o texto que se encontra a seguir a possível correspondência não corresponder ao <emphasis>PADRÃO</emphasis> da verificação; o texto correspondente não será incluído no resultado.</para>
<para>A expressão <userinput>utilizar(?=\w)</userinput> irá corresponder a <quote>utilizar</quote> em <quote>utilizarei</quote>, mas não irá corresponder com <quote>Não vou utilizar!</quote></para>
</listitem>
</varlistentry>

<varlistentry>
<term><userinput>(?!PADRÃO)</userinput> (Antevisão Negativa)</term>

<listitem><para>A antevisão negativa evita que uma possível correspondência seja extraída, se a parte subsequente ao texto procurado corresponder ao <emphasis>PADRÃO</emphasis>.</para>
<para>A expressão <userinput>const \w+\b(?!\s*&amp;)</userinput> irá corresponder com o <quote>const char</quote> do texto <quote>const char* ola</quote>, embora não corresponderá a <quote>const TQString</quote> em <quote>const TQString&amp; bar</quote> porque o <quote>&amp;</quote> corresponde ao padrão de verificação antecipada negativa.</para>
</listitem>
</varlistentry>

</variablelist>

</para>

</sect1>

<!-- TODO sect1 id="backreferences">

<title>Back References</title>

<para></para>

</sect1 -->

</appendix>