File: expr.1

package info (click to toggle)
manpages-fr 0.9.3-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 7,052 kB
  • ctags: 4
  • sloc: makefile: 58; sh: 8
file content (121 lines) | stat: -rw-r--r-- 4,403 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
.\" Traduction 23/12/1996 par Christophe Blaess (ccb@club-internet.fr)
.\"
.TH EXPR 1L "23 Decembre 1996" FSF "Manuel de l'utilisateur Linux"
.SH NOM
expr \- Evaluer des expressions.
.SH SYNOPSIS
.B expr
expression...
.br
.B expr
{\-\-help,\-\-version}
.br
.SH DESCRIPTION
Cette page de manuel dcrit la version GNU de
.BR expr .

.B expr
value une expression, et imprime le rsultat sur la sortie standard.

Chaque lment minimal de l'expression doit tre fourni comme argument
indpendant. Les oprandes peuvent tre des nombres ou des chanes de
caractres. Les chanes n'ont pas besoin d'tre encadres pour \fBexpr\fP,
mais il est gnralement ncessaire de le faire pour les protger du shell.

.B expr
transforme tout argument apparaissant en position d'oprande en un entier,
ou en une chane suivant le type d'opration  appliquer.
.PP
Les oprateurs sont (par ordre dcroissant de prcdence):
.IP "\fI|\fP"
Renvoie son premier argument s'il n'est pas nul, et si sa valeur n'est pas
zro, sinon il renvoie son second argument. Il s'agit de l'opration 'OU'
habituelle.
.IP "\fI&\fP"
Si aucun des deux arguments n'est nul, et si aucune valeur n'est 0, renvoie
son premier argument. Sinon il renvoie 0.
.IP "\fI<\fP\0 \fI<=\fP\0 \fI=\fP\0 \fI==\fP\0 \fI!=\fP\0 \fI>=\fP\0 \fI>\fP"
Compare les arguments et renvoie 1 si la relation est vraie, 0 sinon.
(\fI==\fP est un synonyme de \fI=\fP.)
\fBexpr\fP transforme les deux arguments en nombres. La comparaison est
numrique. Si la transformation en nombre choue, une comparaison de type
lexicographique est choisie.
.IP "\fI+\fP\0 \fI-\fP"
Effectuent une opration arithmtique. Les deux arguments sont transforms
en nombres et une erreur se produit si c'est impossible.
.IP "\fI*\fP\0 \fI/\fP\0 \fI%\fP"
Effectuent une opration arithmtique (le `%' est l'opration `modulo' comme
en C). Les deux arguments sont transforms en nombres et une erreur se produit
si c'est impossible.
.IP "\fI:\fP"
Effectue une recherche de sous-chane. Les arguments sont considrs comme
des chanes. Le second est une expression rgulire avec un `^' ajout
implicitement au dbut. Le premier argument est compar  ce motif.
Si la correspondance russit, et si une partie de la chane est
encadre par `\e(' et `\e)', cette partie sera renvoye comme valeur
de l'expression \fI:\fP. Sinon l'opration renvoie un entier reprsentant
le nombre de caractres mis en correspondance. Si la comparaison choue,
l'oprateur \fI:\fP renvoie une chane nulle si l'encadrement `\e(' et `\e)'
est utilis, et renvoie 0 sinon. On ne peut utiliser qu'un seul encadrement
`\e(' et `\e)'.
.TP
De plus, les mots-cls suivants sont valides :
.TP
.BI match " chane exp_reg"
Une autre manire de faire une mise en correspondance. Le rsultat est
le mme que ``\fIchane\fP \fB:\fP \fIexp_reg\fP''.
.TP
.BI substr " chane pos lg"
Renvoie la partie de \fIchane\fP commenant  la position \fIpos\fP et
de longueur maximale \fIlg\fP.  Si \fIpos\fP ou \fIlg\fP est ngatif, ou
non-numrique, \fIsubstr\fP renvoie une chane nulle.
.TP
.BI index " chane classe_caractre"
Renvoie la position de la premire occurence du premier caractre appartenant
 \fIclasse_caractre\fP dans la \fIchane\fP. Si aucun caractre de
\fIclasse_caractre\fP n'est trouv dans \fIchane\fP, 0 est renvoy.
.TP
.BI length " chane"
Renvoie la longueur de la \fIchane\fP.
.PP
Les parenthses servent  grouper les oprations comme d'habitude. Les mots-cls
ne peuvent pas tre utiliss comme chanes.
.SS OPTIONS
Quand la version GNU de
.B expr
est invoque avec un unique argument, les options suivantes sont reconnues :
.TP
.I "\-\-help"
Afficher un message d'aide sur la sortie standard, et terminer normalement.
.TP
.I "\-\-version"
Afficher un numro de version sur la sortie standard, et terminer normalement.
.SH EXEMPLES
.PP
Pour ajouter 1  la variable shell
.IR a " :"
.IP
a=\`expr $a + 1\`
.PP
On peut utiliser l'expression suivante pour imprimer la partie sans rpertoire d'un nom
de fichier situ dans la variable
.IR a
(La valeur de
.IR a
n'a pas besoin de contenir de `/'):
.IP
expr $a : '.*/\e(\^.*\e)' '\^|' $a
.LP
Remarquez la protection des mta-caractres du shell.
.PP
.B expr
renvoie les codes de retour suivants :
.PP
0 si l'expression n'est ni nulle ni 0,
.br
1 si l'expression est nulle ou 0,
.br
2 si l'expression est invalide.

.SH TRADUCTION
Christophe Blaess, 1997.