File: csplit.1

package info (click to toggle)
manpages-fr 0.5-2
  • links: PTS
  • area: main
  • in suites: hamm
  • size: 4,236 kB
  • ctags: 4
  • sloc: makefile: 55
file content (131 lines) | stat: -rw-r--r-- 4,948 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
.\" Traduction 09/01/1997 par Christophe Blaess (ccb@club-internet.fr)
.\"
.TH CSPLIT 1 "9 Janvier 1997" FSF "Manuel de l'utilisateur Linux"
.SH NOM
csplit \- Decouper un fichier en sections determinees par des lignes de contexte.
.SH SYNOPSIS
.B csplit
[\-sqkz] [\-f prefixe] [\-b suffixe] [\-n longueur] [\-\-prefix=prefixe]
[\-\-suffix\-format=suffixe] [\-\-digits=longueur] [\-\-quiet] [\-\-silent]
[\-\-keep-files] [\-\-elide\-empty\-files] [\-\-help] [\-\-version]
fichier motif...
.SH DESCRIPTION
Cette page de manuel documente la version GNU de
.BR csplit .

.B csplit
cree plusieurs fichiers de sortie contenant differentes sections du \fIfichier\fP
d'entree indique, ou de l'entree standard si le nom `\-' est fourni.

Par defaut,
.B csplit
affiche le nombre d'octets ecrits dans chaque fichier de sortie apres
l'avoir cree.
.PP

Le contenu des fichiers de sortie est determine par les arguments
.IR motif .
Une erreur est declenchee si un motif ne correspond a aucune ligne
du fichier d'entree, par exemple si aucune ligne restante ne
se rapporte a une expression reguliere donnee.

Apres avoir trouve des lignes correspondantes pour chaque motif donne,
le reste du fichier est copie dans un dernier fichier de sortie.

Les types d'argument \fImotif\fP sont :
.RS
.TP
.I nombre
.br
Cree un fichier de sortie contenant la ligne en cours, et les suivantes
jusqu'a la ligne \fInombre\fP (un entier positif) non-incluse.
Si cet argument est suivi d'un nombre de repetitions, un autre fichier
de sortie contenant \fInombre\fP lignes est cree pour chaque iteration.
.TP
/\fIregexp\fP/[\fIdecallage\fP]
.br
Creer un fichier de sortie commencant a la ligne en cours, jusqu'a 
la prochaine ligne du fichier d'entree correspondant a l'expression
reguliere \fIregexp\fP. Cette ligne n'est pas incluse. Le \fIdecallage\fP
eventuel est un nombre entier positif ou negatif. S'il est mentionne,
le fichier de sortie ira jusqu'a la ligne precedant ou suivant de la
valeur \fIdecallage\fP celle correspondant a l'expression reguliere.
La ligne suivante debutera alors la prochaine section.
.TP
%\fIregexp\fP%[\fIoffset\fP]
.br
Comme le type precedent, a la difference que le resultat n'est pas
ecrit dans un fichier de sortie, la section est ainsi ignoree.
.TP
{\fInombre\fP}
.br
Repeter \fInombre\fP fois supplementaires le motif precedent. \fInombre\fP
doit etre un entier positif. Un asterisque a la place de \fInombre\fP
indique une repetition indefinie, jusqu'a la fin du fichier d'entree.
.RE
.PP
Le nom des fichiers de sortie consistent en un \fIprefixe\fP suivi
d'un \fIsuffixe\fP. Par defaut, le suffixe est un nombre de deux chiffres,
dans l'intervalle croissant 00 a 99. Neanmoins ceci peut etre modifie
par les options
.I \-\-digits
ou
.IR \-\-suffix\-format .
(Voir plus bas.) 

Dans tous les cas, la concatenation des fichiers
resultats dans l'ordre croissant des noms de fichiers redonne le
fichier original.
Le prefixe par defaut des fichiers de sortie est `xx'.
.PP
Par defaut, lorsque
.B csplit
rencontre une erreur, ou recoit un signal Hangup, Interrupt, Quit ou Terminate,
il efface tous les fichiers resultats qu'il avait crees.
.SS OPTIONS
.TP
.I "\-f, \-\-prefix=prefixe"
Utiliser le
.I prefixe
indique pour creer les noms de fichiers de sortie.
.TP
.I "\-b, \-\-suffix\-format=suffixe"
Utiliser le
.I suffixe
pour creer les noms de fichiers de sortie. Quand cette option est
mentionnee, la chaine \fIsuffixe\fP doit contenir exactement une
specification de format compatible avec \fBprintf\fP(3) 
(comme %d, avec eventuellement des attributs de largeur, de precision, ou
tout autre modificateur). La specification 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 autorises.
La chaine \fIsuffixe\fP complete (avec le numero de fichier de sortie)
est transmise a \fBsprintf\fP(3) pour creer le suffixe du nom de
chaque fichier individuellement.
Quand cette option est utilisee, l'argument
.I \-\-digits
est ignore.
.TP
.I "\-n, \-\-digits=longueur"
Utiliser des noms de fichiers contenant des nombres de la \fIlongueur\fP
indiquee. (Par defaut 2).
.TP
.I "\-k, \-\-keep-files"
Ne pas effacer les fichiers resultats lorsque des erreurs se produisent.
.TP
.I "\-z, \-\-elide\-empty\-files"
Eviter la creation de fichiers de sortie vides (Dans le cas ou un
identificateur indique la premiere ligne de chaque section, le premier
fichier resultat sera generalement vide si l'on n'utilise pas cette
option). Remarquez que la sequence des numeros de fichiers de sortie
sera toujours continue, commencant a 0, meme si des sections vides
sont eliminees.
.TP
.I "\-s, \-q, \-\-silent, \-\-quiet"
Ne pas afficher les tailles des fichiers de sortie.
.TP
.I "\-\-help"
Afficher un message d'aide sur la sortie standard et terminer normalement.
.TP
.I "\-\-version"
Afficher un numero de version sur la sortie standard et terminer normalement.