Mandato compare

Utilice el mandato compare para comparar el documento actual con un archivo especificado.   Las líneas que existen en el archivo especificado pero no en el documento actual se resaltan con los atributos de estilo styleAttributes.deletedLines.  Las líneas que existen en el documento actual pero no en el archivo especificado se resaltan con los atributos de estilo styleAttributes.addedLines.

Sintaxis:

compare { clear
        | next
        | previous
        | refresh
        | [ ignoredStyles styleChars ] { prompt [ "fileName" ]
                                       | [ [ fileOptions ] "fileName" ]
                                       }
        } 

Parámetros

clear Utilice el parámetro clear para eliminar la información de comparación de una sesión de comparación anterior.
next Utilice el parámetro next para avanzar a la discrepancia siguiente.  La búsqueda no se reiniciará desde el principio del documento.
previous Utilice el parámetro previous para volver a la discrepancia anterior.  La búsqueda no se reiniciará desde el final del documento.
refresh Utilice el parámetro refresh para renovar la comparación respecto al archivo especificado anteriormente, utilizando los cambios más recientes de la vista actual.
ignoredStyles styleChars Utilice el parámetro ignoredStyles para indicar que el texto correspondiente a los caracteres de estilo especificados por el parámetro styleChars no deben tenerse en cuenta en la comparación.  Tampoco se tendrán en cuenta los espacios en blanco.  Los analizadores de documentos establecen los caracteres de estilo.
prompt [ "fileName" ] Utilice el parámetro prompt para indicar que debe visualizarse el diálogo Comparar archivo para que el usuario pueda seleccionar un archivo.  Si se especifica el parámetro opcional fileName, el diálogo Comparar archivo se inicializará con el nombre de archivo especificado.
fileOptions Valores opcionales para el archivo de comparación, en este formato:
[ sequenceNumbers numColumn numWidth textColumn textWidth ]
[ encoding charEncoding ]
Utilice el parámetro sequenceNumbers para especificar que el valor de números de secuencia del archivo es numColumn numWidth textColumn textWidth.  Si no se especifica se da por supuesto que el archivo de comparación tiene el mismo valor de número de secuencia que el documento actual.  Consulte el parámetro del editor sequenceNumbers para obtener información adicional sobre la especificación de números de secuencia.

Utilice el parámetro encoding para especificar que la codficación de caracteres del archivo es charEncoding.  Si especifica una serie vacía (""), el editor intenta detectar la codificación del archivo por sí mismo y si no lo consigue, adopta por omisión la codificación nativa.  Si no se especifica, se presupone que la codificación de caracteres del archivo es la nativa (valor predeterminado de la plataforma).
"fileName" Utilice el parámetro fileName para indicar qué archivo debe utilizarse.   Si no se especifica el parámetro fileName, el documento compara con el archivo subyacente.

Estado

El parámetro status se establecerá igual a uno de estos valores:
null El mandato compare ha localizado satisfactoriamente el archivo especificado.
file.notFound El mandato compare no ha podido localizar el archivo especificado.
file.errorReading El mandato compare encontró un error mientras leía el archivo.

Descripción

Las líneas que existen en el documento actual pero no en el documento de comparación se resaltan y siguen formando parte del documento.  Las líneas que no existen en el documento actual pero existen en el documento de comparación se insertan como elementos show en la vista actual.  Estos elementos están protegidos y no pueden editarse.  Como se trata de elementos show, no se guardarán con el documento.

La comparación tiene en cuenta los valores de los parámetros compare..  Después de cambiar estos valores, debe emitirse otro mandato compare o compare refresh para que la vista refleje los cambios.

Ejemplos

compare prompt
compare "test.java"
compare encoding Cp850 "test.java"
compare ignoredStyles "c" prompt "test.java"
compare clear
compare next
compare previous
compare refresh 

Conceptos relacionados
Mandatos, acciones y parámetros del editor

Consulta relacionada
Parámetro compare.columns
Parámetro compare.endColumn
Parámetro compare.ignoreAllBlanks
Parámetro compare.ignoreCase
Parámetro compare.ignoreComments
Parámetro compare.ignoreLeadingBlanks
Parámetro compare.ignoreSequenceNumbers
Parámetro compare.ignoreTrailingBlanks
Parámetro compare.startColumn
Parámetro sequenceNumbers
Parámetro show
Parámetro status
Parámetro style
Parámetro styleAttributes

Acción compare
Acción compareAllBlanks
Acción compareCase
Acción compareClear
Acción compareComments
Acción compareLeadingBlanks
Acción compareNext
Acción comparePrevious
Acción compareRefresh
Acción compareSequenceNumbers
Acción compareTrailingBlanks