perkamon - en to fr translation catalogue (34 entries)

note: type: TH
en: 2019-10-10
fr: 10 octobre 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: strtok, strtok_r - extract tokens from strings
fr: strtok, strtok_r - Extraire des mots d'une chaîne

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: The I<delim> argument specifies a set of bytes that delimit the tokens in the parsed string.  The caller may specify different strings in I<delim> in successive calls that parse the same string.
fr: L'argument I<delimit> indique l'ensemble des octets qui délimitent les éléments dans la chaîne à analyser. La chaîne de séparateurs I<delimit> peut être différente à chaque appel sur la même chaîne.

note: type: Plain text
en: Each call to B<strtok>()  returns a pointer to a null-terminated string containing the next token.  This string does not include the delimiting byte.  If no more tokens are found, B<strtok>()  returns NULL.
fr: Chaque appel à B<strtok>() renvoie un pointeur sur une chaîne, terminée par un octet nul, contenant l'élément suivant. Cette chaîne n'inclut pas le séparateur. S'il n'y a plus d'éléments, B<strtok> renvoie NULL.

note: type: Plain text
en: A sequence of calls to B<strtok>()  that operate on the same string maintains a pointer that determines the point from which to start searching for the next token.  The first call to B<strtok>()  sets this pointer to point to the first byte of the string.  The start of the next token is determined by scanning forward for the next nondelimiter byte in I<str>.  If such a byte is found, it is taken as the start of the next token.  If no such byte is found, then there are no more tokens, and B<strtok>()  returns NULL.  (A string that is empty or that contains only delimiters will thus cause B<strtok>()  to return NULL on the first call.)
fr: Une séquence d'appels à B<strtok>() qui s'exécute sur la même chaîne gère un pointeur qui indique le point de départ de la recherche pour l'élément lexical suivant. Le premier appel à B<strtok>() positionne ce pointeur sur le premier octet de la chaîne. Le début de l'élément lexical suivant est déterminé en parcourant I<str> jusqu'à l'octet suivant qui ne soit pas un séparateur. Lorsqu'un tel octet est rencontré, il est pris comme point de départ de l'élément lexical suivant. Si on ne trouve plus d'octet qui ne soit pas un séparateur, alors il n'y a plus d'élément lexical dans la chaîne, et B<strtok>() renvoie la valeur NULL. (Ainsi, pour une chaîne vide ou qui ne contient que des séparateurs, B<strtok>() renverra la valeur NULL dès le premier appel).

note: type: Plain text
en: The end of each token is found by scanning forward until either the next delimiter byte is found or until the terminating null byte (\(aq\e0\(aq) is encountered.  If a delimiter byte is found, it is overwritten with a null byte to terminate the current token, and B<strtok>()  saves a pointer to the following byte; that pointer will be used as the starting point when searching for the next token.  In this case, B<strtok>()  returns a pointer to the start of the found token.
fr: La fin de chaque élément lexical est déterminée en parcourant la chaîne jusqu'à ce que l'octet suivant soit un délimiteur, ou jusqu'à ce qu'on rencontre l'octet vide (\(aq\e0\(aq). Si un délimiteur est trouvé, il est écrasé par un octet vide pour signifier la fin de l'élément lexical en cours de détermination, et B<strtok>() positionne un pointeur sur l'octet suivant ; ce pointeur marque le point de départ de la recherche de l'élément lexical suivant. Dans ce cas, B<strtok>() renvoie un pointeur vers le début de l'élément lexical qui vient d'être isolé.

note: type: Plain text
en: From the above description, it follows that a sequence of two or more contiguous delimiter bytes in the parsed string is considered to be a single delimiter, and that delimiter bytes at the start or end of the string are ignored.  Put another way: the tokens returned by B<strtok>()  are always nonempty strings.  Thus, for example, given the string "I<aaa;;bbb,>", successive calls to B<strtok>()  that specify the delimiter string "I<;,>" would return the strings "I<aaa>" and "I<bbb>", and then a null pointer.
fr: De ce qui précède, il découle qu'une séquence de deux séparateurs contigus ou plus est considérée comme un seul séparateur et que les séparateurs en début et en fin de chaîne sont ignorés. Les éléments renvoyés par B<strtok>() sont toujours des chaînes non vides. Si l'on considère par exemple la chaîne «I<aaa;;bbb,>», les appels successifs à B<strtok>() pour lequel le séparateur serait «I<;,>» renverraient les chaînes «I<aaa>» and «I<bbb>», puis un pointeur NULL.

note: type: Plain text
en: The B<strtok_r>()  function is a reentrant version B<strtok>().  The I<saveptr> argument is a pointer to a I<char\ *> variable that is used internally by B<strtok_r>()  in order to maintain context between successive calls that parse the same string.
fr: La fonction B<strtok_r>() est la version réentrante de la fonction B<strtok>(). L'argument I<saveptr> est un pointeur sur une variable I<char\ *> utilisée de manière interne à B<strtok_r>() afin de maintenir le contexte entre les appels successifs qui analysent la même chaîne.

note: type: Plain text
en: Different strings may be parsed concurrently using sequences of calls to B<strtok_r>()  that specify different I<saveptr> arguments.
fr: Différentes chaînes peuvent être analysées de manière concurrente en utilisant des séquences d'appels à B<strtok_r>() qui spécifient différents arguments I<saveptr>.

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

note: type: Plain text
en: The B<strtok>()  and B<strtok_r>()  functions return a pointer to the next token, or NULL if there are no more tokens.
fr: Les fonctions B<strtok>() et B<strtok_r>() renvoient un pointeur sur l'élément lexical suivant, ou NULL s'il n'y en a plus.

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: SH
en: BUGS
fr: BOGUES

note: type: Plain text
en: Be cautious when using these functions.  If you do use them, note that:
fr: Faites attention quand vous utilisez ces fonctions. Si vous les utilisez, prenez note des informations suivantes\ :

note: type: Plain text
en: These functions modify their first argument.
fr: Ces fonctions modifient leur premier paramètre.

note: type: Plain text
en: These functions cannot be used on constant strings.
fr: Ces fonctions ne peuvent pas être utilisées avec des chaînes constantes.

note: type: Plain text
en: The identity of the delimiting byte is lost.
fr: L'identité du délimiteur est perdue.

note: type: Plain text
en: The B<strtok>()  function uses a static buffer while parsing, so it's not thread safe.  Use B<strtok_r>()  if this matters to you.
fr: La fonction B<strtok>() utilise un tampon statique et n'est donc pas sûre dans un contexte multithread. Dans ce cas, il vaut mieux utiliser B<strtok_r>().

note: type: SH
en: EXAMPLE
fr: EXEMPLE

note: type: Plain text
en: The program below uses nested loops that employ B<strtok_r>()  to break a string into a two-level hierarchy of tokens.  The first command-line argument specifies the string to be parsed.  The second argument specifies the delimiter byte(s)  to be used to separate that string into "major" tokens.  The third argument specifies the delimiter byte(s)  to be used to separate the "major" tokens into subtokens.
fr: Le programme ci-dessous utilise des boucles imbriquées qui utilisent B<strtok_r>() pour scinder une chaîne en une hiérarchie d'éléments à deux niveaux. Le premier argument de la ligne de commande indique la chaîne à analyser. Le second argument indique le ou les séparateurs utilisés pour séparer la chaîne en éléments «\ majeurs\ ». Le troisième argument indique le ou les séparateurs utilisés pour séparer les éléments «\ majeurs\ » en sous-éléments.

note: type: Plain text
en: An example of the output produced by this program is the following:
fr: Voici un exemple de la sortie produite par ce programme\ :

note: type: SS
en: Program source
fr: Source du programme

note: type: Plain text
en: Another example program using B<strtok>()  can be found in B<getaddrinfo_a>(3).
fr: Un autre exemple de programme qui utilise B<strtok>() se trouve dans B<getaddrinfo_a>(3).

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: TH
en: 2019-03-06
fr: 6 mars 2019

note: type: Plain text
en: On the first call to B<strtok_r>(), I<str> should point to the string to be parsed, and the value of I<saveptr> is ignored.  In subsequent calls, I<str> should be NULL, and I<saveptr> should be unchanged since the previous call.
fr: Au premier appel de B<strtok_r>(), I<str> doit pointer sur la chaîne à analyser et la valeur de I<saveptr> est ignorée. Dans les appels suivants, I<str> doit être NULL et I<saveptr> ne doit pas être modifié depuis le précédent appel.

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/.
