.\" -*- coding: UTF-8 -*- '\" t .\" Copyright (c) 2008, Linux Foundation, written by Michael Kerrisk .\" .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH matherr 3 "20 juillet 2023" "Pages du manuel de Linux 6.05.01" .SH NOM matherr — Gestionnaire d'exception SVID de la bibliothèque mathématique .SH BIBLIOTHÈQUE Bibliothèque de math (\fIlibm\fP, \fI\-lm\fP) .SH SYNOPSIS .nf \fB#include \fP .PP \fB[[obsolète]] int matherr(struct exception *\fP\fIexc\fP\fB);\fP .PP \fB[[obsolète]] extern _LIB_VERSION_TYPE _LIB_VERSION;\fP .fi .SH DESCRIPTION .\" glibc commit 813378e9fe17e029caf627cab76fe23eb46815fa \fINote\fP\ : Le mécanisme décrit dans cette page n'est plus pris en charge par la glibc. Avant la glibc\ 2.27, il a été marqué comme obsolète. Depuis la glibc\ 2.27, il a été complètement supprimé. Les nouvelles applications devraient utiliser les techniques décrites dans \fBmath_error\fP(7) et \fBfenv\fP(3). Cette page documente le mécanisme \fBmatherr\fP() de la glibc comme aide pour maintenir et porter d'anciennes applications. .PP La spécification «\ System V Interface Definition\ » (SVID) spécifie que différentes fonctions mathématiques devraient appeler une fonction \fBmatherr\fP() 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 \fBmatherr\fP(), le système retourne dans la fonction mathématique qui renvoie le résultat à l'appelant. .PP Pour utiliser \fBmatherr\fP(), le programmeur doit définir la macro de test de fonctionnalité \fB_SVID_SOURCE\fP (avant d'inclure \fItout\fP fichier d'en\-tête) et définir la variable externe \fB_LIB_VERSION\fP à la valeur \fB_SVID_\fP. .PP Le système fournit une version par défaut de \fBmatherr\fP(). Cette version ne fait rien et renvoie zéro (voir ci\-dessous pour la signification). La fonction \fBmatherr\fP() 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 \fIexception\fP, défini comme ceci\ : .PP .in +4n .EX 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; /* 2ème paramètre de la fonction */ double retval; /* Valeur renvoyée par la fonction */ } .EE .in .PP Le champ \fItype\fP peut prendre une des valeurs suivantes\ : .TP 12 \fBDOMAIN\fP 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 renvoyée dépend de la fonction\ ; \fIerrno\fP prend la valeur \fBEDOM\fP. .TP \fBSING\fP Une erreur de pôle s'est produite (le résultat de la fonction est un infini). La valeur renvoyée dans la plupart des cas est \fBHUGE\fP (le plus grand nombre en virgule flottante simple précision), avec le bon signe. Dans la plupart des cas, \fIerrno\fP prend la valeur \fBEDOM\fP. .TP \fBOVERFLOW\fP Un dépassement s'est produit. Dans la plupart des cas, la valeur \fBHUGE\fP est renvoyée et \fIerrno\fP prend la valeur \fBERANGE\fP. .TP \fBUNDERFLOW\fP Un soupassement («\ underflow\ ») s'est produit. 0.0 est renvoyé et \fIerrno\fP prend la valeur \fBERANGE\fP. .TP \fBTLOSS\fP Perte complète de chiffres significatifs. 0,0 est renvoyé et \fIerrno\fP prend la valeur \fBERANGE\fP. .TP \fBPLOSS\fP Perte partielle de chiffres significatifs. La valeur n'est pas utilisée par la glibc (et beaucoup d'autres systèmes). .PP Les champs \fIarg1\fP et \fIarg2\fP sont les paramètres fournis à la fonction (\fIarg2\fP n'est pas défini pour les fonctions qui ne prennent qu'un seul paramètre). .PP Le champ \fIretval\fP spécifie la valeur que la fonction mathématique va renvoyer à l'appelant. La fonction \fBmatherr\fP() définie par le programmeur peut modifier ce champ pour changer la valeur renvoyée par la fonction mathématique. .PP Si la fonction \fBmatherr\fP() renvoie zéro, alors le système positionne \fIerrno\fP comme décrit ci\-dessus et peut afficher un message d'erreur sur la sortie d'erreur standard (voir ci\-dessous). .PP Si la fonction \fBmatherr\fP() renvoie une valeur non nulle, alors le système ne positionne pas \fIerrno\fP et n'affiche pas de message d'erreur. .SS "Fonctions mathématiques qui utilisent matherr()" La table ci\-dessous liste les fonctions et les circonstances pour lesquelles \fBmatherr\fP() est appelée. La colonne «\ Type\ » indique la valeur donnée à \fIexc\->type\fP lors de l'appel à \fBmatherr\fP(). La colonne «\ Résultat\ » est la valeur du résultat par défaut donnée à \fIexc\->retval\fP. .PP Les colonnes «\ Msg?\ » et «\ errno\ » décrivent le comportement par défaut si \fBmatherr\fP() renvoie zéro. Si la colonne «\ Msg?\ » contient «\ o\ », alors le système affiche un message d'erreur sur la sortie d'erreur standard. .PP La table utilise les notations et abréviations suivantes\ : .PP .RS .TS l l. x premier paramètre de la fonction y second paramètre de la fonction fin valeur finie du paramètre neg valeur négative du paramètre int valeur entière du paramètre o/f dépassement du résultat u/f soupassement du résultat |x| valeur absolue de x X_TLOSS est une constante définie dans \fI\fP .TE .RE .\" Details below from glibc 2.8's sysdeps/ieee754/k_standard.c .\" A subset of cases were test by experimental programs. .TS lB lB lB cB lB l l l c l. Fonction Type Résultat Msg ? errno acos(|x|>1) DOMAIN HUGE y EDOM asin(|x|>1) DOMAIN HUGE y EDOM atan2(0,0) DOMAIN HUGE y EDOM .\" retval is 0.0/0.0 acosh(x<1) DOMAIN NAN y EDOM .\" retval is 0.0/0.0 atanh(|x|>1) DOMAIN NAN y EDOM .\" retval is x/0.0 atanh(|x|==1) SING (x>0.0)? y EDOM \ \ HUGE_VAL : \ \ \-HUGE_VAL cosh(fin) o/f OVERFLOW HUGE n ERANGE sinh(fin) o/f OVERFLOW (x>0.0) ? n ERANGE \ \ HUGE : \-HUGE sqrt(x<0) DOMAIN 0.0 y EDOM hypot(fin,fin) o/f OVERFLOW HUGE n ERANGE exp(fin) o/f OVERFLOW HUGE n ERANGE exp(fin) u/f UNDERFLOW 0.0 n ERANGE exp2(fin) o/f OVERFLOW HUGE n ERANGE exp2(fin) u/f UNDERFLOW 0.0 n ERANGE exp10(fin) o/f OVERFLOW HUGE n ERANGE exp10(fin) u/f UNDERFLOW 0.0 n ERANGE j0(|x|>X_TLOSS) TLOSS 0.0 y ERANGE j1(|x|>X_TLOSS) TLOSS 0.0 y ERANGE jn(|x|>X_TLOSS) TLOSS 0.0 y ERANGE y0(x>X_TLOSS) TLOSS 0.0 y ERANGE y1(x>X_TLOSS) TLOSS 0.0 y ERANGE yn(x>X_TLOSS) TLOSS 0.0 y ERANGE y0(0) DOMAIN \-HUGE y EDOM y0(x<0) DOMAIN \-HUGE y EDOM y1(0) DOMAIN \-HUGE y EDOM y1(x<0) DOMAIN \-HUGE y EDOM yn(n,0) DOMAIN \-HUGE y EDOM yn(x<0) DOMAIN \-HUGE y EDOM lgamma(fin) o/f OVERFLOW HUGE n ERANGE lgamma(\-int) ou SING HUGE y EDOM \ \ lgamma(0) tgamma(fin) o/f OVERFLOW HUGE_VAL n ERANGE tgamma(\-int) SING NAN y EDOM tgamma(0) SING copysign( y ERANGE \ \ HUGE_VAL,x) log(0) SING \-HUGE y EDOM log(x<0) DOMAIN \-HUGE y EDOM .\" different from log() log2(0) SING \-HUGE n EDOM .\" different from log() log2(x<0) DOMAIN \-HUGE n EDOM log10(0) SING \-HUGE y EDOM log10(x<0) DOMAIN \-HUGE y EDOM pow(0.0,0.0) DOMAIN 0.0 y EDOM pow(x,y) o/f OVERFLOW HUGE n ERANGE pow(x,y) u/f UNDERFLOW 0.0 n ERANGE pow(NaN,0.0) DOMAIN x n EDOM .\" +0 and -0 0**neg DOMAIN 0.0 y EDOM neg**non\-int DOMAIN 0.0 y EDOM scalb() o/f OVERFLOW (x>0.0) ? n ERANGE \ \ HUGE_VAL : \ \ \-HUGE_VAL scalb() u/f UNDERFLOW copysign( n ERANGE \ \ \ \ 0.0,x) fmod(x,0) DOMAIN x y EDOM .\" retval is 0.0/0.0 remainder(x,0) DOMAIN NAN y EDOM .TE .SH ATTRIBUTS Pour une explication des termes utilisés dans cette section, consulter \fBattributes\fP(7). .TS allbox; lbx lb lb l l l. Interface Attribut Valeur T{ .na .nh \fBmatherr\fP() T} Sécurité des threads MT\-Safe .TE .sp 1 .SH EXEMPLES Le programme d'exemple montre l'utilisation de \fBmatherr\fP() lors de l'appel à \fBlog\fP(3). Le programme prend jusqu'à 3 paramètres en ligne de commande. Le premier paramètre est le nombre en virgule flottante à fournir à \fBlog\fP(3). Si le deuxième paramètre, optionnel, est fourni, \fB_LIB_VERSION\fP est configuré à la valeur \fB_SVID_\fP de telle sorte que \fBmatherr\fP() soit appelée et l'entier fourni sur la ligne de commande est utilisé comme valeur renvoyée par \fBmatherr\fP(). Si le troisième paramètre, optionnel, est fourni, il spécifie une autre valeur que \fBmatherr\fP() doit positionner comme valeur renvoyée de la fonction mathématique. .PP L'exécution suivante de l'exemple (dans laquelle \fBlog\fP(3) reçoit la valeur 0.0) n'utilise pas \fBmatherr\fP()\ : .PP .in +4n .EX $\fB ./a.out 0.0\fP errno: Numerical result out of range x=\-inf .EE .in .PP Dans l'exécution suivante, \fBmatherr\fP() est appelée et renvoie 0\ : .PP .in +4n .EX $\fB ./a.out 0.0 0\fP matherr SING exception in log() function args: 0.000000, 0.000000 retval: \-340282346638528859811704183484516925440.000000 log: SING error errno: Numerical argument out of domain x=\-340282346638528859811704183484516925440.000000 .EE .in .PP Le message «\ log: SING error\ » a été affiché par la bibliothèque C. .PP Dans l'exécution suivante, \fBmatherr\fP() est appelée et renvoie une valeur non nulle\ : .PP .in +4n .EX $\fB ./a.out 0.0 1\fP matherr SING exception in log() function args: 0.000000, 0.000000 retval: \-340282346638528859811704183484516925440.000000 x=\-340282346638528859811704183484516925440.000000 .EE .in .PP Dans ce cas, la bibliothèque\ C n'a pas affiché de message et \fIerrno\fP n'a pas été positionnée. .PP Dans l'exécution suivante, \fBmatherr\fP() est appelée, modifie la valeur renvoyée par la fonction mathématique et renvoie une valeur non nulle\ : .PP .in +4n .EX $\fB ./a.out 0.0 1 12345.0\fP matherr SING exception in log() function args: 0.000000, 0.000000 retval: \-340282346638528859811704183484516925440.000000 x=12345.000000 .EE .in .SS "Source du programme" .\" [[deprecated]] SRC BEGIN (matherr.c) \& .EX #define _SVID_SOURCE #include #include #include #include \& static int matherr_ret = 0; /* Valeur que matherr() devrait renvoyer */ static int change_retval = 0; /* Voulez\-vous que matherr() modifie la valeur renvoyée par la fonction ? */ static double new_retval; /* Nouvelle valeur renvoyée par la fonction */ \& int matherr(struct exception *exc) { fprintf(stderr, "matherr %s exception in %s() function\en", (exc\->type == DOMAIN) ? "DOMAIN" : (exc\->type == OVERFLOW) ? "OVERFLOW" : (exc\->type == UNDERFLOW) ? "UNDERFLOW" : (exc\->type == SING) ? "SING" : (exc\->type == TLOSS) ? "TLOSS" : (exc\->type == PLOSS) ? "PLOSS" : "???", exc\->name); fprintf(stderr, " args: %f, %f\en", exc\->arg1, exc\->arg2); fprintf(stderr, " retval: %f\en", exc\->retval); \& if (change_retval) exc\->retval = new_retval; \& return matherr_ret; } \& int main(int argc, char *argv[]) { double x; \& if (argc < 2) { fprintf(stderr, "Usage: %s " " [ []]\en", argv[0]); exit(EXIT_FAILURE); } \& if (argc > 2) { _LIB_VERSION = _SVID_; matherr_ret = atoi(argv[2]); } \& if (argc > 3) { change_retval = 1; new_retval = atof(argv[3]); } \& x = log(atof(argv[1])); if (errno != 0) perror("errno"); \& printf("x=%f\en", x); exit(EXIT_SUCCESS); } .EE .\" SRC END .SH "VOIR AUSSI" \fBfenv\fP(3), \fBmath_error\fP(7), \fBstandards\fP(7) .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par Christophe Blaess , Stéphan Rafin , Thierry Vignaud , François Micaux, Alain Portal , Jean-Philippe Guérard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas François , Florentin Duneau , Simon Paillard , Denis Barbier , David Prévot , Cédric Boutillier et Jean-Pierre Giraud . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .