agrep - manuel de référence, options, exemples de commandes


NOM

agrep - imprimer des lignes correspondant approximativement à un motif

SYNOPSIS

agrep [OPTION]... PATTERN [FILE]...

DESCRIPTION

Recherche des correspondances approximatives de MOTIF dans chaque FICHIER ou entrée standard. Exemple:

agrep -2 optimize foo.txt

affiche toutes les lignes du fichier `foo.txt' qui correspondent à "optimize" avec deux erreurs. Par exemple. les lignes qui contiennent "optimise", "optmise" et "opitmize" correspondent toutes.

OPTIONS

Sélection et interprétation des expressions régulières :

-e PATTERN, - -regexp=PATTERN

Utilisez PATTERN comme expression régulière ; utile pour protéger les modèles commençant par -.

-i, - -ignore-case

Ignorer les distinctions de casse (telles que définies par les paramètres régionaux actuels) dans PATTERN et les fichiers d'entrée.

-k, - -literal

Traitez PATTERN comme une chaîne littérale, c'est-à-dire une chaîne fixe sans caractères spéciaux.

-w, - -word-regexp

Forcez PATTERN à ne faire correspondre que des mots entiers. Un "mot entier" est une sous-chaîne qui commence au début ou à l'enregistrement ou est précédée d'un caractère constitutif autre qu'un mot. De même, la sous-chaîne doit soit se terminer à la fin de l'enregistrement, soit être suivie d'un caractère constitutif autre qu'un mot. Les caractères constitutifs d'un mot sont des caractères alphanumériques (tels que définis par les paramètres régionaux actuels) et le caractère de soulignement. Notez que les caractères constitutifs non verbaux doivent entourer la correspondance ; ils ne peuvent pas être comptés comme des erreurs.

Paramètres de correspondance approximatifs :

-D NUM, - -delete-cost=NUM

Définissez le coût des caractères manquants sur NUM.

-I NUM, - -insert-cost=NUM

Définissez le coût des caractères supplémentaires sur NUM.

-S NUM, - -substitute-cost=NUM

Définissez le coût des caractères incorrects sur NUM. Notez qu'une suppression (caractère manquant) et une insertion (caractère supplémentaire) constituent ensemble un caractère substitué, mais le coût sera celui d'une suppression et d'une insertion additionnées. Ainsi, si la const d'une substitution est définie comme étant supérieure à la somme des coûts de suppression et d'insertion, les substitutions directes ne seront jamais effectuées.

-E NUM, - -max-errors=NUM

Sélectionnez les enregistrements contenant au plus NUM erreurs.

-#

Sélectionnez les enregistrements contenant au plus # erreurs (# est un chiffre compris entre 0 et 9).

Divers:

-d PATTERN, - -delimiter=PATTERN

Définissez l'expression régulière du délimiteur d'enregistrement sur PATTERN. Le texte entre deux délimiteurs, avant le premier délimiteur et après le dernier délimiteur est considéré comme un enregistrement. Le délimiteur d'enregistrement par défaut est l'expression régulière "\n", donc par défaut un enregistrement est une ligne. PATTERN peut être n'importe quelle expression régulière qui ne correspond pas à la chaîne vide. Par exemple, l'utilisation de -d "^From" définit les messages électroniques comme des enregistrements dans un fichier au format de boîte aux lettres.

-v, - -invert-match

Sélectionnez les enregistrements non correspondants au lieu des enregistrements correspondants.

-V, - -version

Imprimer les informations de version et quitter.

-y, - -nothing

Ne fait rien. Cette option n'existe que pour la compatibilité avec le programme non libre agrep.

- -help

Affichez un bref message d'aide et quittez.

Contrôle de sortie :

-B, - -best-match

Sortez uniquement les enregistrements les plus correspondants, c'est-à-dire ceux dont le coût est le plus bas. Ceci est actuellement implémenté en effectuant deux passages sur les fichiers d'entrée et ne peut pas être utilisé lors de la lecture à partir de l'entrée standard.

- -color, - -colour

Mettez en surbrillance les chaînes correspondantes dans la sortie avec un marqueur de couleur. La chaîne de couleur est extraite de la variable d'environnement GREP_COLOR. La couleur par défaut est le rouge.

-c, - -count

Imprime uniquement le nombre d'enregistrements correspondants pour chaque fichier d'entrée, supprimant la sortie normale.

-h, - -no-filename

Supprime le nom de fichier préfixé sur la sortie lorsque plusieurs fichiers sont recherchés.

-H, - -with-filename

Préfixez chaque enregistrement de sortie avec le nom du fichier d'entrée à partir duquel l'enregistrement a été lu.

-l, - -files-with-matches

N'imprime que le nom de chaque fichier d'entrée qui contient au moins une correspondance, supprimant la sortie normale. L'analyse de chaque fichier s'arrêtera à la première correspondance.

-n, - -record-number

Préfixez chaque enregistrement de sortie avec son numéro de séquence dans le fichier d'entrée. Le numéro du premier enregistrement est 1.

-q, - -quiet, - -silent

N'écrivez rien sur la sortie standard. Quittez immédiatement avec un statut de sortie nul si une correspondance est trouvée.

-s, - -show-cost

Le coût d'impression correspond à la sortie.

- -show-position

Préfixez chaque enregistrement de sortie avec le décalage de début et de fin de la première correspondance dans l'enregistrement. Le décalage du premier caractère de l'enregistrement est 0. La position de fin est donnée comme le décalage du premier caractère après la correspondance.

-M, - -delimiter-after

Par défaut, le délimiteur d'enregistrement est le caractère de saut de ligne et est affiché après l'enregistrement correspondant. Si -d est utilisé, le délimiteur d'enregistrement sera affiché avant l'enregistrement correspondant. Cette option entraîne la sortie du délimiteur après l'enregistrement correspondant.

Sans FILE, ou lorsque FILE vaut -, lit l'entrée standard. Si moins de deux FILE sont donnés, -h est supposé, sinon -H est la valeur par défaut.

DIAGNOSTIQUE

Le statut de sortie est 0 si une correspondance est trouvée, 1 pour aucune correspondance et 2 s'il y a eu des erreurs. Si -E ou -# n'est pas spécifié, seules les correspondances exactes sont sélectionnées.

PATTERN est une expression régulière étendue POSIX (ERE) avec les extensions TRE.

SIGNALER DES BOGUES

Signalez les bogues à la liste de diffusion TRE <tre-general@lists.laurikari.net>.

DROITS D'AUTEUR

Copyright © 2002-2004 Ville Laurikari.
Il s'agit d'un logiciel gratuit, et il est livré avec ABSOLUMENT AUCUNE GARANTIE. Vous êtes invités à redistribuer ce logiciel sous certaines conditions ; voir la source pour le texte complet de la licence.