perkamon - en to fr translation catalogue (40 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: matherr - SVID math library exception handling
fr: matherr - Gestionnaire d'exception SVID de la bibliothèque mathématique

note: type: Plain text
en: Link with I<-lm>.
fr: Effectuez l'édition des liens avec l'option I<-lm>.

note: type: Plain text
en: The System V Interface Definition (SVID) specifies that various math functions should invoke a function called B<matherr>()  if a math exception is detected.  This function is called before the math function returns; after B<matherr>()  returns, the system then returns to the math function, which in turn returns to the caller.
fr: La spécification « System V Interface Definition » (SVID) spécifie que différentes fonctions devraient appeler une fonction B<matherr>() en cas d'exception mathématique. Cette fonction est appelée avant que la fonction mathématique ne rende la main ; après le retour de B<matherr>(), le système retourne dans la fonction mathématique qui renvoie le résultat à l'appelant.

note: type: Plain text
en: To employ B<matherr>(), the programmer must define the B<_SVID_SOURCE> feature test macro (before including I<any> header files), and assign the value B<_SVID_> to the external variable B<_LIB_VERSION>.
fr: Pour utiliser B<matherr>(), le programmeur doit définir la macro de test de fonctionnalité B<_SVID_SOURCE> (avant d'inclure I<tout> en-tête) et définir la variable externe B<_LIB_VERSION> à la valeur B<_SVID_>.

note: type: Plain text
en: The system provides a default version of B<matherr>().  This version does nothing, and returns zero (see below for the significance of this).  The default B<matherr>()  can be overridden by a programmer-defined version, which will be invoked when an exception occurs.  The function is invoked with one argument, a pointer to an I<exception> structure, defined as follows:
fr: Le système fourni une version par défaut de B<matherr>(). Cette version ne fait rien et renvoie zéro (voir ci-dessous pour la signification). La fonction B<matherr>() par défaut peut être remplacée par une version spécifique au programme, qui sera appelée quand une exception se produit. La fonction est appelée avec un paramètre, un pointeur vers une structure I<exception>, définie comme ceci :

note: type: Plain text
en: struct exception {
        int    type;      /* Exception type */
        char  *name;      /* Name of function causing exception */
        double arg1;      /* 1st argument to function */
        double arg2;      /* 2nd argument to function */
        double retval;    /* Function return value */
    }
fr: struct exception {
        int    type;      /* Type d'exception */
        char  *name;      /* Nom de la fonction ayant
                             produit l'exception */
        double arg1;      /* 1er paramètre de la fonction */
        double arg2;      /* 2e paramètre de la fonction */
        double retval;    /* Valeur de retour de la fonction */
    }

note: type: Plain text
en: The I<type> field has one of the following values:
fr: Le champ I<type> peut prendre une des valeurs suivantes\ :

note: type: Plain text
en: A domain error occurred (the function argument was outside the range for which the function is defined).  The return value depends on the function; I<errno> is set to B<EDOM>.
fr: Une erreur de domaine s'est produite (un paramètre de la fonction était en dehors du domaine de définition de la fonction). La valeur de retour dépend de la fonction ; I<errno> prend la valeur B<EDOM>.

note: type: Plain text
en: A pole error occurred (the function result is an infinity).  The return value in most cases is B<HUGE> (the largest single precision floating-point number), appropriately signed.  In most cases, I<errno> is set to B<EDOM>.
fr: Une erreur de pôle s'est produite (la fonction résulte en un infini). La valeur de retour dans la plupart des cas est B<HUGE> (le plus grand nombre en virgule flottante), avec le bon signe. Dans la plupart des cas, I<errno> prend la valeur B<EDOM>.

note: type: Plain text
en: An overflow occurred.  In most cases, the value B<HUGE> is returned, and I<errno> is set to B<ERANGE>.
fr: Un dépassement s'est produit. Dans la plupart des cas, la valeur B<HUGE> est renvoyée et I<errno> prend la valeur B<ERANGE>.

note: type: Plain text
en: An underflow occurred.  0.0 is returned, and I<errno> is set to B<ERANGE>.
fr: Un soupassement (« underflow ») s'est produit. 0,0 est renvoyé et I<errno> prend la valeur B<ERANGE>.

note: type: Plain text
en: Total loss of significance.  0.0 is returned, and I<errno> is set to B<ERANGE>.
fr: Perte complète de chiffres significatifs. 0,0 est renvoyé et I<errno> prend la valeur B<ERANGE>.

note: type: Plain text
en: Partial loss of significance.  This value is unused on glibc (and many other systems).
fr: Perte partielle de chiffres significatifs. La valeur n'est pas utilisée par la glibc (et beaucoup d'autres systèmes).

note: type: Plain text
en: The I<arg1> and I<arg2> fields are the arguments supplied to the function (I<arg2> is undefined for functions that take only one argument).
fr: Les champs I<arg1> et I<arg2> sont les paramètres fournis à la fonction (I<arg2> n'est pas défini pour les fonctions qui ne prennent qu'un seul paramètre).

note: type: Plain text
en: The I<retval> field specifies the return value that the math function will return to its caller.  The programmer-defined B<matherr>()  can modify this field to change the return value of the math function.
fr: Le champ I<retval> spécifie la valeur de retour que la fonction mathématique va renvoyer à l'appelant. La fonction B<matherr>() spécifique au programme peut modifier ce champ pour changer la valeur de retour de la fonction mathématique.

note: type: Plain text
en: If the B<matherr>()  function returns zero, then the system sets I<errno> as described above, and may print an error message on standard error (see below).
fr: Si la fonction B<matherr>() renvoie zéro, alors le système positionne I<errno> comme décrit ci-dessus et peut afficher un message d'erreur sur la sortie d'erreur (voir ci-dessous).

note: type: Plain text
en: If the B<matherr>()  function returns a nonzero value, then the system does not set I<errno>, and doesn't print an error message.
fr: Si la fonction B<matherr>() renvoie une valeur non nulle, alors le système ne positionne pas I<errno> et n'affiche pas de message d'erreur.

note: type: SS
en: Math functions that employ matherr()
fr: Fonctions mathématiques qui utilisent matherr()

note: type: Plain text
en: The table below lists the functions and circumstances in which B<matherr>()  is called.  The "Type" column indicates the value assigned to I<exc-E<gt>type> when calling B<matherr>().  The "Result" column is the default return value assigned to I<exc-E<gt>retval>.
fr: La table ci-dessous liste les fonctions et les circonstances pour lesquelles B<matherr>() est appelée. La colonne « Type » indique la valeur donnée à I<exc-E<gt>type> lors de l'appel à B<matherr>(). La colonne « Résultat » est la valeur du résultat par défaut donnée à I<exc-E<gt>retval>.

note: type: Plain text
en: The "Msg?" and "errno" columns describe the default behavior if B<matherr>()  returns zero.  If the "Msg?" columns contains "y", then the system prints an error message on standard error.
fr: Les colonnes « Msg? » et « errno » décrivent le comportement par défaut si B<matherr>() renvoie zéro. Si la colonne « Msg? » contient « o », alors le système affiche un message d'erreur sur la sortie d'erreur.

note: type: Plain text
en: The table uses the following notations and abbreviations:
fr: La table utilise les notations et abréviations suivantes :

note: type: Plain text
en: x        first argument to function
    y        second argument to function
    fin      finite value for argument
    neg      negative value for argument
    int      integral value for argument
    o/f      result overflowed
    u/f      result underflowed
    |x|      absolute value of x
    X_TLOSS  is a constant defined in I<E<lt>math.hE<gt>>
fr: x        premier paramètre de la fonction
    y        deuxième paramètre de la fonction
    fin      valeur finie du paramètre
    nég      valeur négative du paramètre
    ent      valeur entière du paramètre
    o/f      dépassement (« overflow ») pour le résultat
    u/f      soupassement (« underflow ») pour le résultat
    |x|      valeur absolue de x
    X_TLOSS  constante définie dans I<E<lt>math.hE<gt>>

note: type: SH
en: ATTRIBUTES
fr: ATTRIBUTS

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

note: type: SH
en: EXAMPLE
fr: EXEMPLE

note: type: Plain text
en: The example program demonstrates the use of B<matherr>()  when calling B<log>(3).  The program takes up to three command-line arguments.  The first argument is the floating-point number to be given to B<log>(3).  If the optional second argument is provided, then B<_LIB_VERSION> is set to B<_SVID_> so that B<matherr>()  is called, and the integer supplied in the command-line argument is used as the return value from B<matherr>().  If the optional third command-line argument is supplied, then it specifies an alternative return value that B<matherr>()  should assign as the return value of the math function.
fr: Le programme d'exemple montre l'utilisation de B<matherr>() lors de l'appel à B<log>(3). Le programme prend jusqu'à 3 paramètres en ligne de commande. Le premier paramètre est le nombre en virgule flottante à fournir à B<log>(3). Si le deuxième paramètre, optionnel, est fourni, B<_LIB_VERSION> est configuré à la valeur B<_SVID_> de telle sorte que B<matherr>() soit appelée et l'entier fourni sur la ligne de commande est utilisé comme valeur de retour de B<matherr>(). Si le troisième paramètre, optionnel, est fourni, il spécifie une autre valeur de retour que B<matherr>() doit positionner comme valeur de retour de la fonction mathématique.

note: type: Plain text
en: The following example run, where B<log>(3)  is given an argument of 0.0, does not use B<matherr>():
fr: L'exécution suivante de l'exemple (dans laquelle B<log>(3) reçoit la valeur 0,0) n'utilise pas B<matherr>() :

note: type: Plain text
en: In the following run, B<matherr>()  is called, and returns 0:
fr: Dans l'exécution suivante, B<matherr>() est appelée et renvoie 0 :

note: type: Plain text
en: The message "log: SING error" was printed by the C library.
fr: Le message « log: SING error » a été affiché par la bibliothèque C.

note: type: Plain text
en: In the following run, B<matherr>()  is called, and returns a nonzero value:
fr: Dans l'exécution suivante, B<matherr>() est appelée et renvoie une valeur non nulle :

note: type: Plain text
en: In this case, the C library did not print a message, and I<errno> was not set.
fr: Dans ce cas, la bibliothèque C n'a pas affiché de message et I<errno> n'a pas été positionnée.

note: type: Plain text
en: In the following run, B<matherr>()  is called, changes the return value of the math function, and returns a nonzero value:
fr: Dans l'exécution suivante, B<matherr>() est appelée, modifie la valeur de retour de la fonction mathématique et renvoie une valeur non nulle :

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

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