Commande compare

La commande compare permet de comparer le document sélectionné à un fichier spécifié.Les lignes qui apparaissent dans le fichier spécifié, mais pas dans le document sélectionné, sont mises en évidence à l'aide des attributs de style styleAttributes.deletedLines. A l'inverse, les lignes qui apparaissent dans le document sélectionné, mais pas dans le fichier spécifié, sont mises en évidence à l'aide des attributs de style styleAttributes.addedLines.

Syntaxe

compare { clear
        | next
        | previous
        | refresh
        | [ ignoredStyles carStyle ] { prompt [ "nomFichier" ]
                                     | [ [ optionsFichier ] "nomFichier" ]
                                     }
        } 

Paramètres

clear Le paramètre clear permet de supprimer les informations de comparaison d'une session de comparaison précédente.
next Le paramètre next permet de se déplacer vers la non-concordance suivante. Cela ne boucle pas vers le haut du document.
previous Le paramètre previous permet de revenir à la non-concordance précédente. Cela ne boucle pas vers le bas du document.
refresh Le paramètre refresh permet de régénérer la comparaison par rapport au fichier précédemment spécifié à l'aide des dernières modifications de la vue courante.
ignoredStyles carStyle Le paramètre ignoredStyles indique que le texte correspondant aux caractères de style spécifiés dans le paramètre carStyle doivent être ignorés dans la comparaison. Les espaces sont également ignorés. Les caractères de style sont définis par les analyseurs syntaxiques de document.
prompt [ "nomFichier" ] Le paramètre prompt indique que la boîte de dialogue du fichier de comparaison doit s'afficher afin de permettre à l'utilisateur de sélectionner un fichier. Si le paramètre facultatif nomFichier est spécifié, la boîte de dialogue est initialisée avec le nom du fichier spécifié.
optionsFichier Paramètres facultatifs du fichier de comparaison, au format suivant :
[ sequenceNumbers colonneNum largeurNum colonneTexte largeurTexte ]
[ encoding codageCar ]
Le paramètre sequenceNumbers permet d'indiquer que le paramètre des numéros de séquence du fichier est colonneNum largeurNum colonneTexte largeurTexte. S'il n'est pas spécifié, le système suppose que le fichier de comparaison possède le même paramètre que le document en cours pour les numéros de séquence. Pour plus d'informations sur la spécification des numéros de séquence, reportez-vous au paramètre d'éditeur sequenceNumbers.

Le paramètre encoding permet d'indiquer que le codage des caractères du fichier est codageCar. Si vous spécifiez une chaîne vide (""), l'éditeur essaye de détecter lui-même le codage du fichier et utilise le codage natif s'il n'y parvient pas. S'il n'est pas spécifié, le fichier de comparaison est utilisé par défaut dans le codage des caractères natif (plateforme par défaut).
"nomFichier" Le paramètre nomFichier permet d'indiquer le fichier à utiliser. Si aucun paramètre nomFichier n'est indiqué, le document est comparé avec la version sauvegardée de son fichier sous-jacent.

Etat

La valeur du paramètre status peut être :
null La commande compare a trouvé le fichier spécifié.
file.notFound La commande compare n'a pas trouvé le fichier spécifié.
file.errorReading La commande compare a rencontré une erreur lors de la lecture du fichier.

Description

Les lignes qui apparaissent dans le document en cours, mais pas dans le document de comparaison, sont mises en évidence et font toujours partie du dit document. A l'inverse, les lignes qui n'apparaissent pas dans le document en cours, mais dans le document de comparaison, sont insérées en tant qu'éléments show dans la vue en cours. Elles sont protégées et ne peuvent pas être modifiées. Etant donné qu'il s'agit d'éléments show, elles ne sont pas sauvegardées avec le document.

La comparaison tient compte de la valeur des paramètres compare. Si vous modifiez l'une de ces valeurs, vous devez exécuter une autre commande compare ou compare refresh pour que la vue applique les modifications.

Exemples

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

Concepts connexes
Commandes, actions et paramètres de l'éditeur

Références connexes
Paramètre compare.columns
Paramètre compare.endColumn
Paramètre compare.ignoreAllBlanks
Paramètre compare.ignoreCase
Paramètre compare.ignoreComments
Paramètre compare.ignoreLeadingBlanks
Paramètre compare.ignoreSequenceNumbers
Paramètre compare.ignoreTrailingBlanks
Paramètre compare.startColumn
Paramètre sequenceNumbers
Paramètre show
Paramètre status
Paramètre style
Paramètre styleAttributes

Action compare
Action compareAllBlanks
Action compareCase
Action compareClear
Action compareComments
Action compareLeadingBlanks
Action compareNext
Action comparePrevious
Action compareRefresh
Action compareSequenceNumbers
Action compareTrailingBlanks