perkamon - en to fr translation catalogue (44 entries)

note: type: TH
en: 2019-03-06
fr: 6 mars 2019

note: type: TH
en: Linux Programmer's Manual
fr: Manuel du programmeur Linux

note: type: SH
en: NAME
fr: NOM

note: type: Plain text
en: getopt, getopt_long, getopt_long_only, optarg, optind, opterr, optopt - Parse command-line options
fr: getopt, getopt_long, getopt_long_only, optarg, optind, opterr, optopt - Analyser les options de la ligne de commande

note: type: Plain text
en: Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):
fr: Exigences de macros de test de fonctionnalités pour la glibc (consultez B<feature_test_macros>(7)) :

note: type: Plain text
en: B<getopt>(): _POSIX_C_SOURCE\ E<gt>=\ 2 || _XOPEN_SOURCE
fr: B<getopt>() : _POSIX_C_SOURCE\ E<gt>=\ 2 || _XOPEN_SOURCE

note: type: Plain text
en: B<getopt_long>(), B<getopt_long_only>(): _GNU_SOURCE
fr: B<getopt_long>(), B<getopt_long_only>()\ : _GNU_SOURCE

note: type: Plain text
en: The B<getopt>()  function parses the command-line arguments.  Its arguments I<argc> and I<argv> are the argument count and array as passed to the I<main>()  function on program invocation.  An element of I<argv> that starts with \(aq-\(aq (and is not exactly "-" or "--")  is an option element.  The characters of this element (aside from the initial \(aq-\(aq) are option characters.  If B<getopt>()  is called repeatedly, it returns successively each of the option characters from each of the option elements.
fr: La fonction B<getopt>() analyse les arguments de la ligne de commande. Ses éléments I<argc> et I<argv> correspondent aux nombres et à la table d'arguments qui sont transmis à la fonction I<main>() lors du lancement du programme. Un élément de I<argv> qui commence par «\ -\ » (et qui ne soit pas uniquement «\ --\ » ou «\ -\ ») est considéré comme une option. Les caractères à la suite du «\ -\ » initial sont les caractères de l'option. Si B<getopt>() est appelée à plusieurs reprises, elle renverra successivement chaque caractère de chaque option.

note: type: Plain text
en: The variable I<optind> is the index of the next element to be processed in I<argv>.  The system initializes this value to 1.  The caller can reset it to 1 to restart scanning of the same I<argv>, or when scanning a new argument vector.
fr: La variable I<optind> est l'indice de l'élément suivant à analyser dans I<argv>. Le système initialise cette valeur à 1. L'appelant peut le remettre à 1 pour recommencer l'analyse du même I<argv> ou pour analyser un nouveau tableau de paramètre.

note: type: Plain text
en: If B<getopt>()  finds another option character, it returns that character, updating the external variable I<optind> and a static variable I<nextchar> so that the next call to B<getopt>()  can resume the scan with the following option character or I<argv>-element.
fr: Si B<getopt>() trouve un autre caractère d'option, elle le renvoie, mettant à jour la variable externe I<optind> et la variable statique I<nextchar>, ainsi l'appel suivant à B<getopt>() peut continuer l'analyse avec le caractère suivant ou l'élément I<argv>.

note: type: Plain text
en: If there are no more option characters, B<getopt>()  returns -1.  Then I<optind> is the index in I<argv> of the first I<argv>-element that is not an option.
fr: S'il n'y a plus de caractères d'option, B<getopt>() renvoie -1. Alors, I<optind> devient l'index du premier élément de I<argv> qui ne soit pas une option.

note: type: Plain text
en: I<optstring> is a string containing the legitimate option characters.  If such a character is followed by a colon, the option requires an argument, so B<getopt>()  places a pointer to the following text in the same I<argv>-element, or the text of the following I<argv>-element, in I<optarg>.  Two colons mean an option takes an optional arg; if there is text in the current I<argv>-element (i.e., in the same word as the option name itself, for example, "-oarg"), then it is returned in I<optarg>, otherwise I<optarg> is set to zero.  This is a GNU extension.  If I<optstring> contains B<W> followed by a semicolon, then B<-W foo> is treated as the long option B<--foo>.  (The B<-W> option is reserved by POSIX.2 for implementation extensions.)  This behavior is a GNU extension, not available with libraries before glibc 2.
fr: I<optstring> est une chaîne contenant l'ensemble des caractères d'option autorisés. Si un de ces caractères est suivi par un deux-points (« : »), l'option nécessite un argument, donc B<getopt>() placera un pointeur sur le texte suivant dans le même I<argv>, ou sur le texte de l'élément I<argv> suivant dans I<optarg>. Un double deux points (« :: ») signifie qu'une option prend un argument optionnel. S'il existe un texte dans le même élément de I<argv> (c'est-à-dire dans le même mot que l'option elle-même comme «\ -oarg\ ») alors il est renvoyé dans I<optarg>, sinon I<optarg> est défini à zéro. Il s'agit d'une extension GNU. Si I<optstring> contient B<W> suivi d'un point-virgule, alors B<-W foo> est traité comme l'option longue B<--foo> (l'option B<-W> est réservée par POSIX.2 pour des extensions spécifique à l'implémentation). Ce comportement, spécifique à la version GNU, n'est pas disponible avant la bibliothèque glibc\ 2.

note: type: Plain text
en: By default, B<getopt>()  permutes the contents of I<argv> as it scans, so that eventually all the nonoptions are at the end.  Two other modes are also implemented.  If the first character of I<optstring> is \(aq+\(aq or the environment variable B<POSIXLY_CORRECT> is set, then option processing stops as soon as a nonoption argument is encountered.  If the first character of I<optstring> is \(aq-\(aq, then each nonoption I<argv>-element is handled as if it were the argument of an option with character code 1.  (This is used by programs that were written to expect options and other I<argv>-elements in any order and that care about the ordering of the two.)  The special argument "--" forces an end of option-scanning regardless of the scanning mode.
fr: Par défaut, B<getopt>() permute les éléments de I<argv> au fur et à mesure de son analyse, ainsi tous les arguments éventuels ne constituant pas des options se trouvent à la fin. Deux autres modes sont également implémentés\ : Si le premier caractère de I<optstring> vaut «\ +\ », ou si la variable d'environnement B<POSIXLY_CORRECT> est valide, alors l'analyse s'arrête aussitôt qu'un argument ne constituant pas une option est rencontré. Si le premier caractère de I<optstring> vaut «\ -\ », alors les arguments ne correspondant pas à une option sont manipulés comme s'ils étaient des arguments d'une option dont le caractère est le caractère de code 1 (ceci est utilisé par les programmes qui sont conçus pour recevoir des options et d'autres éléments de I<argv> dans n'importe quel ordre mais qui prennent en compte l'ordre de ces deux types). L'argument spécial «\ --\ » arrête l'analyse des options, quelque soit le mode en cours.

note: type: SS
en: getopt_long() and getopt_long_only()
fr: getopt_long() et getopt_long_only()

note: type: Plain text
en: The B<getopt_long>()  function works like B<getopt>()  except that it also accepts long options, started with two dashes.  (If the program accepts only long options, then I<optstring> should be specified as an empty string (""), not NULL.)  Long option names may be abbreviated if the abbreviation is unique or is an exact match for some defined option.  A long option may take a parameter, of the form B<--arg=param> or B<--arg param>.
fr: La fonction B<getopt_long>() fonctionne comme B<getopt>() sauf qu'elle accepte également des noms longs d'option, commençant par deux tirets (si le programme accepte seulement les options longues, alors I<optstring> devrait être indiquée avec une chaîne vide «\ ""\ » et non avec NULL). Les noms longs d'option peuvent être abrégés, si l'abréviation est unique, ou si elle correspond exactement à une option définie. Une option longue peut prendre un argument, de la forme B<--arg=param> ou B<--arg param>.

note: type: Plain text
en: I<longopts> is a pointer to the first element of an array of I<struct option> declared in I<E<lt>getopt.hE<gt>> as
fr: I<longopts> est un pointeur sur le premier élément d'un tableau de structures I<struct option> déclarées dans I<E<lt>getopt.hE<gt>> ainsi\ :

note: type: Plain text
en: The meanings of the different fields are:
fr: La signification des différents champs est la suivante\ :

note: type: Plain text
en: is the name of the long option.
fr: est le nom de l'option longue.

note: type: Plain text
en: is: B<no_argument> (or 0) if the option does not take an argument; B<required_argument> (or 1) if the option requires an argument; or B<optional_argument> (or 2) if the option takes an optional argument.
fr: vaut\ : B<no_argument> (ou 0), si l'option ne prend pas d'argument, B<required_argument> (ou 1) si l'option prend un argument, ou B<optional_argument> (ou 2) si l'option prend un argument optionnel.

note: type: Plain text
en: specifies how results are returned for a long option.  If I<flag> is NULL, then B<getopt_long>()  returns I<val>.  (For example, the calling program may set I<val> to the equivalent short option character.)  Otherwise, B<getopt_long>()  returns 0, and I<flag> points to a variable which is set to I<val> if the option is found, but left unchanged if the option is not found.
fr: indique la manière de renvoyer les résultats pour une option longue. Si I<flag> vaut NULL, alors B<getopt_long>() renvoie I<val> (par exemple, le programme appelant peut remplir I<val> avec le caractère de l'option courte correspondante). Sinon, B<getopt_long>() renvoie 0, et I<flag> pointe sur une variable définie à I<val> si l'option est trouvée, mais reste inchangé si l'option est absente.

note: type: Plain text
en: is the value to return, or to load into the variable pointed to by I<flag>.
fr: est la valeur à renvoyer, ou à charger dans la variable pointée par I<flag>.

note: type: Plain text
en: The last element of the array has to be filled with zeros.
fr: Le dernier élément de la table doit être rempli avec des zéros.

note: type: Plain text
en: If I<longindex> is not NULL, it points to a variable which is set to the index of the long option relative to I<longopts>.
fr: Si I<longindex> n'est pas NULL, il pointe sur une variable qui est définie avec l'index de l'option longue correspondant à I<longopts>.

note: type: Plain text
en: B<getopt_long_only>()  is like B<getopt_long>(), but \(aq-\(aq as well as "--" can indicate a long option.  If an option that starts with \(aq-\(aq (not "--") doesn't match a long option, but does match a short option, it is parsed as a short option instead.
fr: B<getopt_long_only>() fonctionne comme B<getopt_long>(), mais «\ -\ » tout comme «\ --\ » peut indiquer une option longue. Si une option commençant par «\ -\ » (et non «\ --\ ») ne correspond pas à une option longue, mais correspond à une option courte, elle est analysée en tant qu'option courte.

note: type: SH
en: RETURN VALUE
fr: VALEUR DE RETOUR

note: type: Plain text
en: If an option was successfully found, then B<getopt>()  returns the option character.  If all command-line options have been parsed, then B<getopt>()  returns -1.  If B<getopt>()  encounters an option character that was not in I<optstring>, then \(aq?\(aq is returned.  If B<getopt>()  encounters an option with a missing argument, then the return value depends on the first character in I<optstring>: if it is \(aq:\(aq, then \(aq:\(aq is returned; otherwise \(aq?\(aq is returned.
fr: Si une option a été trouvée, alors B<getopt>() renvoie le caractère de l'option. Si toutes les options de la ligne de commande ont été lues, alors B<getopt>() renvoie -1. Si B<getopt>() rencontre un caractère d'option qui n'est pas dans I<optstring>, alors «\ ?\ » est renvoyé. Si B<getopt>() rencontre une option avec un argument manquant, alors la valeur renvoyée dépend du premier caractère de I<optstring>\ : si c'est «\ :\ », alors ce caractère est renvoyé, sinon «\ ?\ » est renvoyé.

note: type: Plain text
en: B<getopt_long>()  and B<getopt_long_only>()  also return the option character when a short option is recognized.  For a long option, they return I<val> if I<flag> is NULL, and 0 otherwise.  Error and -1 returns are the same as for B<getopt>(), plus \(aq?\(aq for an ambiguous match or an extraneous parameter.
fr: B<getopt_long>() et B<getopt_long_only>() renvoient également le caractère d'option courte s'ils en trouvent une. Pour les options longues, ils renvoient I<val> si I<flag> vaut NULL, et 0 sinon. Les erreurs et la fin des options sont gérées comme avec B<getopt>(), en renvoyant de surcroît «\ ?\ » pour une correspondance ambiguë, ou un paramètre en trop.

note: type: SH
en: ENVIRONMENT
fr: ENVIRONNEMENT

note: type: Plain text
en: If this is set, then option processing stops as soon as a nonoption argument is encountered.
fr: Si cette variable est positionnée, l'analyse s'arrête dès qu'un argument ne constituant pas une option est rencontré.

note: type: Plain text
en: This variable was used by B<bash>(1)  2.0 to communicate to glibc which arguments are the results of wildcard expansion and so should not be considered as options.  This behavior was removed in B<bash>(1)  version 2.01, but the support remains in glibc.
fr: Cette variable est utilisée par B<bash>(1) 2.0 pour communiquer à la glibc les arguments résultant de l'expansion des caractères génériques, et ils ne doivent pas être considérés comme des options. Ce comportement a été supprimé de B<bash>(1) version 2.01, mais il est toujours géré par la glibc.

note: type: SH
en: ATTRIBUTES
fr: ATTRIBUTS

note: type: tbl table
en: Value
fr: Valeur

note: type: SH
en: CONFORMING TO
fr: CONFORMITÉ

note: type: TP
en: B<getopt>():
fr: B<getopt>()\ :

note: type: Plain text
en: The use of \(aq+\(aq and \(aq-\(aq in I<optstring> is a GNU extension.
fr: L'utilisation de \(aq+\(aq et \(aq-\(aq dans I<optstring> est une extension GNU.

note: type: TP
en: B<getopt_long>() and B<getopt_long_only>():
fr: B<getopt_long>() et B<getopt_long_only>()\ :

note: type: Plain text
en: These functions are GNU extensions.
fr: Ces fonctions sont des extensions GNU.

note: type: Plain text
en: A program that scans multiple argument vectors, or rescans the same vector more than once, and wants to make use of GNU extensions such as \(aq+\(aq and \(aq-\(aq at the start of I<optstring>, or changes the value of B<POSIXLY_CORRECT> between scans, must reinitialize B<getopt>()  by resetting I<optind> to 0, rather than the traditional value of 1.  (Resetting to 0 forces the invocation of an internal initialization routine that rechecks B<POSIXLY_CORRECT> and checks for GNU extensions in I<optstring>.)
fr: Un programme qui analyse plusieurs tableaux de paramètres ou analyse de nouveau le même tableau plusieurs fois, et qui veut utiliser les extension GNU telles que \(aq+\(aq et \(aq-\(aq au début de I<optstring>, ou changer la valeur de B<POSIXLY_CORRECT> entre les analyses, doit réinitialiser B<getopt>() en remettant I<optind> à 0, plutôt que la valeur traditionnelle de 1. La remise à 0 force l'appel d'une routine d'initialisation interne qui vérifie B<POSIXLY_CORRECT>  et vérifie les extensions GNU dans I<optstring>.

note: type: SH
en: EXAMPLE
fr: EXEMPLE

note: type: Plain text
en: The following trivial example program uses B<getopt>()  to handle two program options: I<-n>, with no associated value; and I<-t val>, which expects an associated value.
fr: Le programme d'exemple trivial suivant utilise B<getopt>() avec 2 options\ :I<-n> sans valeur associée et I<-t val> qui nécessite une valeur.

note: type: SH
en: SEE ALSO
fr: VOIR AUSSI

note: type: Plain text
en: This page is part of release 5.03 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
fr: Cette page fait partie de la publication 5.03 du projet I<man-pages> Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse \%https://www.kernel.org/doc/man-pages/.

note: type: Plain text
en: This page is part of release 5.02 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
fr: Cette page fait partie de la publication 5.02 du projet I<man-pages> Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse \%https://www.kernel.org/doc/man-pages/.

note: type: Plain text
en: This page is part of release 5.01 of the Linux I<man-pages> project.  A description of the project, information about reporting bugs, and the latest version of this page, can be found at \%https://www.kernel.org/doc/man-pages/.
fr: Cette page fait partie de la publication 5.01 du projet I<man-pages> Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse \%https://www.kernel.org/doc/man-pages/.
