Comando findText

Utilize o comando findText para localizar e opcionalmente substituir o texto em um documento.

Os parâmetros para o comando findText são divididos em dois grupos:

Sintaxe

findText [ up
         | checkStart
         | replace
         | all
         | quiet
         | noBeep
         ] [...]
         [ [ mark
           | columns col1 col2
           | block
           | wholeWord
           | noWrap
           | asis
           | noEmphasis
           | regularExpression
           | replaceWith replaceText
           ] [...]
           text
         ] 

Parâmetros

para cima Utilize o parâmetro opcional up para indicar que a procura deve retroceder a partir da posição atual.
checkStart Utilize o parâmetro opcional checkStart para indicar que a posição atual do cursor deve ser verificada antes de prosseguir com a procura.
replace Utilize o parâmetro opcional replace para indicar que o texto localizado deve ser substituído pelo texto indicado pelo parâmetro findText.replaceText.
all Utilize o parâmetro opcional all para indicar que todas as ocorrências do texto procurado devem ser localizadas.  A pesquisa ignora a posição atual do cursor, mas segue as restrições de block e columns.
quiet Utilize o parâmetro opcional quiet para indicar que nenhum feedback de mensagem ou áudio deve ser emitido.
noBeep Utilize o parâmetro opcional noBeep para indicar que nenhum feedback de áudio deve ser emitido.
mark Utilize o parâmetro opcional mark para indicar que o texto encontrado deve ser selecionado.
columns col1 col2 Utilize o parâmetro opcional columns para restringir o escopo da procura às colunas iniciais e finais especificadas.  col1 e col2 devem ser inteiros positivos.
block Utilize o parâmetro opcional block para restringir o escopo da procura à seleção de bloco atual.
wholeWord Utilize o parâmetro opcional wholeWord para restringir a procura a palavras inteiras.  Palavras consistem em letras, dígitos e sublinhados.
noWrap Utilize o parâmetro opcional noWrap para indicar que a procura deve parar quando atingir o final do documento.  Ou, quando a pesquisa ocorre inversamente no documento, o parâmetro noWrap indica que a pesquisa deve ser interrompida quando atingir a parte superior do documento.
asis Utilize o parâmetro opcional asis para indicar que a procura deve fazer distinção entre maiúsculas e minúsculas.
noEmphasis Utilize o parâmetro opcional noEmphasis para indicar que o texto localizado não deve ser enfatizado com o estilo de ênfase da visualização de documento.
regularExpression Utilize o parâmetro opcional regularExpression para indicar que a cadeia de procura deve ser tratada como um padrão de expressão comum.
replaceWith replaceText Utilize o parâmetro opcional replaceWith para indicar que o texto localizado deve ser substituído por replaceText.   Se replaceText contiver espaços, ele deverá ser colocado entre aspas (").  Se replaceText contiver aspas, será necessário colocar como prefixo para as aspas uma barra invertida (\").  Se replaceText contiver barras invertidas, será necessário colocar como prefixo para as barras invertidas outra barra invertida (\\).
text Utilize o parâmetro text para indicar o texto no qual deseja fazer a procura.  Talvez seja necessário colocar a cadeia entre aspas se estiver procurando uma das palavras-chave findText.

Status

O parâmetro status será definido para um dos seguintes itens:
null Indica que o comando findText localizou com êxito o texto especificado sem quaisquer condições especiais.
findText.onlyOccurrence Indica que o comando findText pesquisou o documento inteiro, circulou e localizou o texto especificado na localização original do cursor.
findText.wrapped Indica que o comando findText localizou com êxito o texto especificado, mas teve que circular para o início do documento durante a procura.  Ou se a procura estava sendo feita de forma inversa, ele teve que circular para o fim do arquivo durante a procura.
findText.notFound Indica que o texto especificado não pôde ser encontrado.
findText.invalidPattern Indica que o texto especificado não é um padrão de expressão regular válido.  Esse status pode ser definido somente quando você tiver indicado que o texto especificado é um padrão de expressão comum.

Descrição

O comando findText utiliza os seguintes parâmetros:

A menos que o parâmetro all tenha sido especificado, o comando findText afetará apenas os elementos visíveis.

As expressões comuns permitem localizar um texto que corresponda a um padrão especificado.  O suporte da expressão comum no editor é aquele fornecido pela linguagem Java.  Note, entretanto, que o comando findText opera linha por linha.

A seguir são apresentados alguns padrões de expressão comum:

c Se c não for um caractere especial, então corresponderá a uma instância única desse caractere.
\c Corresponde a uma instância única do caractere c que, de outra forma, seria interpretado como um caractere especial.  Por exemplo, a expressão \\ corresponde a uma única barra invertida e a expressão \[ corresponde a um colchete esquerdo.
\t O caractere de tabulação ('\u0009').
\xhh O caractere com valor hexadecimal 0xhh.  Cada h representa um dígito hexadecimal.
\uhhhh O caractere com valor hexadecimal 0xhhhh.  Cada h representa um dígito hexadecimal.
. Corresponde a qualquer caractere simples.
[abc] Corresponde a qualquer caractere único incluído em abc.
[^abc] Corresponde a qualquer caractere único, exceto aqueles incluídos em abc.
[a-z] Corresponde a qualquer caractere único no intervalo de a até z.
[^a-z] Corresponde a qualquer caractere único, exceto aqueles incluídos no intervalo de a até z.
[a-zA-Z] Corresponde a qualquer caractere único no intervalo de a até z ou de A até Z.
\d Um dígito.  Ele é equivalente a [0-9].
\D UM não-dígito.  Ele é equivalente a [^0-9].
\s Um caractere de espaço em branco.  Ele é equivalente a [ \t\x0A\x0B\x0C\x0D].
\S Um caractere diferente de espaço em branco.  Ele é equivalente a [^\s].
\w Um caractere de palavra (um alfanumérico).  Ele é equivalente a [a-zA-Z0-9_].
\W Um caractere diferente de palavra.  Ele é equivalente a [^\w].
^ Corresponde ao início de uma linha.  ^ deve ser o primeiro caractere na expressão.
$ Corresponde ao final de uma linha.  $ deve ser o último caractere na expressão.
\b Corresponde a um limite de palavra.
\B Corresponde a um limite não relacionado a palavra.
X? Corresponde a zero ou uma ocorrência da expressão X.  A maior correspondência possível é localizada (correspondência voraz).
X* Corresponde a zero ou mais ocorrências sucessivas da expressão X.  A maior correspondência possível é localizada (correspondência voraz).
X+ Corresponde a uma ou mais ocorrências sucessivas da expressão X.  A maior correspondência possível é localizada (correspondência voraz).
X{n} Corresponde exatamente a n ocorrências sucessivas da expressão X.  A maior correspondência possível é localizada (correspondência voraz).
X{n,} Corresponde pelo menos a n ocorrências sucessivas da expressão X.  A maior correspondência possível é localizada (correspondência voraz).
X{n,m} Corresponde pelo menos a n mas não mais de m ocorrências sucessivas da expressão X.  A maior correspondência possível é localizada (correspondência voraz).
X?? Corresponde a zero ou uma ocorrência da expressão X.  A menor correspondência é localizada (correspondência não voraz).
X*? Corresponde a zero ou mais ocorrências sucessivas da expressão X.  A menor correspondência é localizada (correspondência não voraz).
X+? Corresponde a uma ou mais ocorrências sucessivas da expressão X.  A menor correspondência é localizada (correspondência não voraz).
X{n}? Corresponde exatamente a n ocorrências sucessivas da expressão X.  A menor correspondência é localizada (correspondência não voraz).
X{n,}? Corresponde pelo menos a n ocorrências sucessivas da expressão X.  A menor correspondência é localizada (correspondência não voraz).
X{n,m}? Corresponde pelo menos a n mas não mais de m ocorrências sucessivas da expressão X.  A menor correspondência é localizada (correspondência não voraz).
XY Corresponde à expressão X seguida pela expressão Y.
X|Y Corresponde à expressão X ou Y.

Exemplos

findText "text"
findText replaceWith "new text" "text"
findText up
findText regularExpression "this|that" 

Conceitos relacionados
Comandos, ações e parâmetros do editor

Referência relacionada
Parâmetro emphasisLength
Parâmetro expandHide
parâmetro expanded
Parâmetro findText.asis
Parâmetro findText.block
Parâmetro findText.columns
Parâmetro findText.emphasis
Parâmetro findText.endColumn
Parâmetro findText.findText
Parâmetro findText.mark
Parâmetro findText.regularExpression
Parâmetro findText.replaceText
Parâmetro findText.startColumn
Parâmetro findText.wholeWord
Parâmetro findText.wrap
parâmetro topExpanded
Parâmetro visible
Ação filterSelection
Ação find
Ação findAndReplace
Ação findAndReplaceNext
Ação findAndReplaceUp
Ação findNext
Ação findSelection
Ação findUp
Comandos padrão do editor
Padrões de expressões Java comuns