Utilice el mandato findText para localizar y opcionalmente sustituir el texto de un documento.
Los parámetros del mandato findText se dividen en dos grupos:
findText [ up | checkStart | replace | all | quiet | noBeep ] [...] [ [ mark | columns col1 col2 | { block | selection } | wholeWord | noWrap | asis | noEmphasis | regularExpression | replaceWith replaceText ] [...] text ]
up | Utilice el parámetro opcional up para indicar que la búsqueda debe realizarse hacia atrás desde la posición actual. |
checkStart | Utilice el parámetro opcional checkStart para indicar que debe comprobarse la posición actual del cursor antes de continuar con la búsqueda. |
replace | Utilice el parámetro opcional replace para indicar que el texto encontrado debe sustituirse por el texto que indica el parámetro findText.replaceText. |
all | Utilice el parámetro opcional all para indicar que deben localizarse todas las apariciones del texto buscado. La búsqueda ignora la posición actual del cursor pero acepta las restricciones block y columns. |
quiet | Utilice el parámetro opcional quiet para indicar que no deben emitirse mensajes ni respuestas sonoras. |
noBeep | Utilice el parámetro opcional noBeep para indicar que no debe emitirse ninguna respuesta sonora. |
mark | Utilice el parámetro opcional mark para indicar que el texto encontrado debe seleccionarse. |
columns col1 col2 | Utilice el parámetro opcional columns para restringir el ámbito de la búsqueda a las columnas inicial y final especificadas. col1 y col2 deben ser enteros positivos. |
block | selection | El parámetro opcional block o selection le permite restringir el ámbito de la búsqueda a la selección de bloque actual. |
wholeWord | Utilice el parámetro opcional wholeWord para restringir la búsqueda a palabras enteras. Las palabras constan de letras, dígitos y subrayados. |
noWrap | Utilice el parámetro opcional noWrap para indicar que la búsqueda debe detenerse cuando llegue al final del documento. O bien, cuando la búsqueda se realiza hacia atrás, el parámetro noWrap indica que la búsqueda debe detenerse cuando llegue al principio del documento. |
asis | Utilice el parámetro opcional asis para indicar que la búsqueda debe distinguir entre mayúsculas y minúsculas. |
noEmphasis | Utilice el parámetro opcional noEmphasis para indicar que el texto encontrado no debe resaltarse con el estilo de resaltado de la vista de documento. |
regularExpression | Utilice el parámetro opcional regularExpression para indicar que la serie de búsqueda debe tratarse como un patrón de expresión regular. |
replaceWith replaceText | Utilice el parámetro opcional replaceWith para indicar que el texto encontrado debe sustituirse por replaceText. Si replaceText contiene espacios, debe prefijarlo con comillas ("). Si replaceText contiene comillas, debe prefijarlas con una barra inclinada invertida (\"). Si replaceText contiene barras inclinadas invertidas, debe prefijarlas con una barra inclinada invertida (\\). |
text | Utilice el parámetro text para indicar el texto que desea buscar. Es posible que tenga que entrecomillar la serie si está buscando una de las palabras clave findText. |
El parámetro status se establecerá igual a uno de estos valores:
null El texto especificado se ha localizado satisfactoriamente sin condiciones especiales. findText.onlyOccurrence El mandato findText ha buscado en todo el documento, ha reiniciado la búsqueda y ha localizado el texto especificado en la posición original del cursor. findText.wrapped El mandato findText ha localizado satisfactoriamente el texto especificado, pero para ello ha tenido que reiniciar la búsqueda desde el principio del documento. O bien, si la búsqueda era hacia atrás, ha tenido que reiniciar la búsqueda desde el final del documento. findText.notFound No se ha podido encontrar el texto especificado. findText.invalidPattern El texto especificado no ee un patrón de expresión regular válido. Solo se establecerá este estado si ha indicado que el texto especificado es un patrón de expresión regular.
El mandato findText utiliza los siguientes parámetros:
- findText.asis
- findText.block
- findText.columns
- findText.emphasis
- findText.endColumn
- findText.findText
- findText.mark
- findText.regularExpression
- findText.replaceText
- findText.startColumn
- findText.wholeWord
- findText.wrap.
A menos que se haya especificado all, el mandato findText solo afecta a los elementos visibles.
Las expresiones regulares permiten encontrar texto que coincide con un patrón especificado. El soporte de la expresión regular en el editor es el que proporciona el lenguaje Java. Sin embargo tenga en cuenta que el mandato findText funciona línea a línea.
A continuación se proporcionan algunos patrones de expresiones regulares:
c Si c no es un carácter especial, emparejar una sola instancia de ese carácter. \c Emparejar una sola instancia del carácter c que de lo contrario se interpretaría como un carácter especial. Por ejemplo, la expresión \\ empareja una sola barra inclinada invertida y la expresión \[ empareja una llave cuadrada izquierda. \t El carácter tabulador ('\u0009'). \xhh El carácter con valor hexadecimal 0xhh. Cada h representa un dígito hexadecimal. \uhhhh El carácter con valor hexadecimal 0xhhhh. Cada h representa un dígito hexadecimal. . Emparejar cualquier carácter individual. [abc] Emparejar cualquier carácter individual incluido en abc. [^abc] Emparejar cualquier carácter individual excepto los incluidos en abc. [a-z] Emparejar cualquier carácter individual comprendido entre a y z. [^a-z] Emparejar cualquier carácter individual excepto los incluidos entre a y z. [a-zA-Z] Emparejar cualquier carácter individual entre a y z o entre A y Z. \d Un dígito. Esto es equivalente a [0-9]. \D No es un dígito. Esto es equivalente a [^0-9]. \s Un carácter de espacio en blanco. Esto es equivalente a [ \t\x0A\x0B\x0C\x0D]. \S Un carácter que no es un espacio en blanco. Esto es equivalente a [^\s]. \w Un carácter de palabra (un alfanumérico). Esto es equivalente a [a-zA-Z0-9_]. \W Un carácter que no es una palabra. Esto es equivalente a [^\w]. ^ Emparejar al principio de una línea. ^ debe ser el primer carácter de la expresión. $ Emparejar al final de una línea. $ debe ser el último carácter de la expresión. \b Emparejar un límite de palabra. \B Emparejar un límite que no sea una palabra. X? Emparejar cero o una aparición de la expresión X. Se busca la coincidencia más larga posible (coincidencia ávida). X* Emparejar cero o más apariciones sucesivas de la expresión X. Se busca la coincidencia más larga posible (coincidencia ávida). X+ Emparejar una o más apariciones sucesivas de la expresión X. Se busca la coincidencia más larga posible (coincidencia ávida). X{n} Emparejar exactamente n apariciones sucesivas de la expresión X. Se busca la coincidencia más larga posible (coincidencia ávida). X{n,} Emparejar como mínimo n apariciones sucesivas de la expresión X. Se busca la coincidencia más larga posible (coincidencia ávida). X{n,m} Emparejar como mínimo n pero no más de m apariciones sucesivas de la expresión X. Se busca la coincidencia más larga posible (coincidencia ávida). X?? Emparejar cero o una aparición de la expresión X. Se busca la coincidencia más corta posible (coincidencia no ávida). X*? Emparejar cero o más apariciones sucesivas de la expresión X. Se busca la coincidencia más corta posible (coincidencia no ávida). X+? Emparejar una o más apariciones sucesivas de la expresión X. Se busca la coincidencia más corta posible (coincidencia no ávida). X{n}? Emparejar exactamente n apariciones sucesivas de la expresión X. Se busca la coincidencia más corta (coincidencia no ávida). X{n,}? Emparejar como mínimo n apariciones sucesivas de la expresión X. Se busca la coincidencia más corta (coincidencia no ávida). X{n,m}? Emparejar como mínimo n pero no más de m apariciones sucesivas de la expresión X. Se busca la coincidencia más corta (coincidencia no ávida). XY Emparejar la expresión X seguida de la expresión Y. X|Y Emparejar la expresión X o la expresión Y.
findText "text" findText replaceWith "new text" "text" findText up findText regularExpression "this|that"
Mandatos, acciones y parámetros del editor
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.incremental
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 status
Parámetro topExpanded
Parámetro visible
Acción excludeSelection
Acción filterSelection
Acción find
Acción findAndReplace
Acción findAndReplaceNext
Acción findAndReplaceUp
Acción findNext
Acción findSelection
Acción findUp
Patrones de expresión regular Java
Copyright IBM Corporation 1992, 2005. Reservados todos los derechos.