CSPLIT(1) Manuel de l'utilisateur Linux CSPLIT(1)
NOM
csplit - Découper un fichier en sections déterminées par
des lignes de contexte.
SYNOPSIS
csplit [-sqkz] [-f préfixe] [-b suffixe] [-n longueur]
[--prefix=préfixe] [--suffix-format=suffixe] [--dig
its=longueur] [--quiet] [--silent] [--keep-files]
[--elide-empty-files] [--help] [--version] fichier
motif...
DESCRIPTION
Cette page de manuel documente la version GNU de csplit.
csplit crée plusieurs fichiers de sortie contenant
différentes sections du fichier d'entrée indiqué, ou de
l'entrée standard si le nom `-' est fourni.
Par défaut, csplit affiche le nombre d'octets écrits dans
chaque fichier de sortie après l'avoir créé.
Le contenu des fichiers de sortie est déterminé par les
arguments motif. Une erreur est déclenchée si un motif ne
correspond à aucune ligne du fichier d'entrée, par exemple
si aucune ligne restante ne se rapporte à une expression
regulière donnée.
Après avoir trouvé des lignes correspondantes pour chaque
motif donné, le reste du fichier est copié dans un dernier
fichier de sortie.
Les types d'argument motif sont :
nombre
Crée un fichier de sortie contenant la ligne
en cours, et les suivantes jusqu'à la ligne
nombre (un entier positif) non-incluse. Si
cet argument est suivi d'un nombre de
répétitions, un autre fichier de sortie con
tenant nombre lignes est créé pour chaque
itération.
/regexp/[décalage]
Créer un fichier de sortie commençant à la
ligne en cours, jusqu'à la prochaine ligne
du fichier d'entrée correspondant à
l'expression régulière regexp. Cette ligne
n'est pas incluse. Le décalage éventuel est
un nombre entier positif ou négatif. S'il
est mentionné, le fichier de sortie ira
jusqu'à la ligne précédant ou suivant de la
valeur décalage celle correspondant à
l'expression régulière. La ligne suivante
FSF 9 Janvier 1997 1
CSPLIT(1) Manuel de l'utilisateur Linux CSPLIT(1)
débutera alors la prochaine section.
%regexp%[offset]
Comme le type précédent, à la différence que
le résultat n'est pas écrit dans un fichier
de sortie, la section est ainsi ignorée.
{nombre}
Répéter nombre fois supplémentaires le motif
précédent. nombre doit être un entier posi
tif. Un astérisque à la place de nombre
indique une répétition indéfinie, jusqu'à la
fin du fichier d'entrée.
Les noms des fichiers de sortie consistent en un préfixe
suivi d'un suffixe. Par défaut, le suffixe est un nombre
de deux chiffres, dans l'intervalle croissant 00 à 99.
Néanmoins ceci peut être modifié par les options --digits
ou --suffix-format. (Voir plus bas.)
Dans tous les cas, la concaténation des fichiers résultats
dans l'ordre croissant des noms de fichiers redonne le
fichier original. Le préfixe par défaut des fichiers de
sortie est `xx'.
Par défaut, lorsque csplit rencontre une erreur, ou reçoit
un signal Hangup, Interrupt, Quit ou Terminate, il efface
tous les fichiers résultats qu'il avait créés.
OPTIONS
-f, --prefix=préfixe
Utiliser le préfixe indiqué pour créér les noms de
fichiers de sortie.
-b, --suffix-format=suffixe
Utiliser le suffixe pour créér les noms de fichiers
de sortie. Quand cette option est mentionnée, la
chaîne suffixe doit contenir exactement une
spécification de format compatible avec printf(3)
(comme %d, avec éventuellement des attributs de
largeur, de précision, ou tout autre modificateur).
La spécification doit permettre la conversion d'un
argument entier binaire en forme lisible. Ainsi
seuls les indicateurs de format `d', 'i', `u', `o',
`x', et `X' sont autorisés. La chaîne suffixe
complète (avec le numéro de fichier de sortie) est
transmise à sprintf(3) pour créer le suffixe du nom
de chaque fichier individuellement. Quand cette
option est utilisée, l'argument --digits est
ignoré.
-n, --digits=longueur
Utiliser des noms de fichiers contenant des nombres
de la longueur indiquée. (Par défaut 2).
FSF 9 Janvier 1997 2
CSPLIT(1) Manuel de l'utilisateur Linux CSPLIT(1)
-k, --keep-files
Ne pas effacer les fichiers résultats lorsque des
erreurs se produisent.
-z, --elide-empty-files
Eviter la création de fichiers de sortie vides
(Dans le cas où un identificateur indique la
première ligne de chaque section, le premier
fichier résultat sera généralement vide si l'on
n'utilise pas cette option). Remarquez que la
séquence des numéros de fichiers de sortie sera
toujours continue, commençant à 0, même si des sec
tions vides sont éliminées.
-s, -q, --silent, --quiet
Ne pas afficher les tailles des fichiers de sortie.
--help Afficher un message d'aide sur la sortie standard
et terminer normalement.
--version
Afficher un numéro de version sur la sortie stan
dard et terminer normalement.
TRADUCTION
Christophe Blaess, 1997.
FSF 9 Janvier 1997 3