.\" -*- coding: UTF-8 -*- '\" t .\" Copyright 2004 Andries Brouwer . .\" and Copyright 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 scalbln 3 "20 juillet 2023" "Pages du manuel de Linux 6.05.01" .SH NOM scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl \- Multiplier un nombre en virgule flottante par un entier puissance d'une base .SH BIBLIOTHÈQUE Bibliothèque de math (\fIlibm\fP, \fI\-lm\fP) .SH SYNOPSIS .nf \fB#include \fP .PP \fBdouble scalbln(double \fP\fIx\fP\fB, long \fP\fIexp\fP\fB);\fP \fBfloat scalblnf(float \fP\fIx\fP\fB, long \fP\fIexp\fP\fB);\fP \fBlong double scalblnl(long double \fP\fIx\fP\fB, long \fP\fIexp\fP\fB);\fP .PP \fBdouble scalbn(double \fP\fIx\fP\fB, int \fP\fIexp\fP\fB);\fP \fBfloat scalbnf(float \fP\fIx\fP\fB, int \fP\fIexp\fP\fB);\fP \fBlong double scalbnl(long double \fP\fIx\fP\fB, int \fP\fIexp\fP\fB);\fP .fi .PP .RS -4 Exigences de macros de test de fonctionnalités pour la glibc (consulter \fBfeature_test_macros\fP(7))\ : .RE .PP \fBscalbln\fP(), \fBscalblnf\fP(), \fBscalblnl\fP()\ : .nf _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L || /* Depuis la glibc 2.19 : */ _DEFAULT_SOURCE .fi .PP \fBscalbn\fP(), \fBscalbnf\fP(), \fBscalbnl\fP()\ : .nf _ISOC99_SOURCE || _POSIX_C_SOURCE\ >=\ 200112L || /* Depuis la glibc 2.19 : */ _DEFAULT_SOURCE || /* glibc <= 2.19 : */ _BSD_SOURCE || _SVID_SOURCE .fi .SH DESCRIPTION Ces fonctions multiplient leur premier paramètre \fIx\fP par \fBFLT_RADIX\fP (probablement 2) à la puissance \fIexp\fP, c'est\-à\-dire\ : .PP .nf x * FLT_RADIX ** exp .fi .PP .\" not in /usr/include but in a gcc lib La définition de \fBFLT_RADIX\fP peut être obtenue en incluant \fI\fP. .SH "VALEUR RENVOYÉE" En cas de réussite, ces fonctions renvoient \fIx\fP * \fBFLT_RADIX\fP ** \fIexp\fP. .PP Si \fIx\fP n’est pas un nombre, un \fBNaN\fP est renvoyé. .PP Si \fIx\fP est une valeur infinie positive (resp. négative), une valeur infinie positive est renvoyée (resp. négative). .PP Si \fIx\fP est +0 (\-0), \fB+0\fP (\fB\-0\fP) est renvoyé. .PP En cas de dépassement pour le résultat, une erreur d'intervalle se produit et les fonctions renvoient \fBHUGE_VAL\fP, \fBHUGE_VALF\fP ou \fBHUGE_VALL\fP, resp. avec le même signe que \fIx\fP. .PP En cas de soupassement («\ underflow\ »), une erreur d'intervalle se produit et les fonctions renvoient zéro avec le même signe que \fIx\fP. .SH ERREURS Voir \fBmath_error\fP(7) pour savoir comment déterminer si une erreur s'est produite lors de l'appel d'une de ces fonctions. .PP Les erreurs suivantes peuvent se produire\ : .TP Erreur d'intervalle, dépassement par le haut .\" .I errno .\" is set to .\" .BR ERANGE . Une exception de dépassement de virgule flottante (\fBFE_OVERFLOW\fP) est levée. .TP Erreur d'intervalle, dépassement par le bas \fIerrno\fP prend la valeur \fBERANGE\fP. Une exception de dépassement par le bas de virgule flottante (\fBFE_UNDERFLOW\fP) est levée. .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 \fBscalbn\fP(), \fBscalbnf\fP(), \fBscalbnl\fP(), \fBscalbln\fP(), \fBscalblnf\fP(), \fBscalblnl\fP() T} Sécurité des threads MT\-Safe .TE .sp 1 .SH STANDARDS C11, POSIX.1\-2008. .SH HISTORIQUE glibc 2.1. C99, POSIX.1\-2001. .SH HISTORIQUE Ces fonctions diffèrent des fonctions obsolètes décrites dans \fBscalb\fP(3) par le type de leur deuxième paramètre. Les fonctions décrites sur cette page ont un deuxième paramètre de type entier, tandis que celle de \fBscalb\fP(3) ont un deuxième paramètre de type \fIdouble\fP. .SH NOTES Si \fBFLT_RADIX\fP vaut 2 (ce qui est le cas en général), alors \fBscalbn\fP() est équivalent à \fBldexp\fP(3). .SH BOGUES .\" https://www.sourceware.org/bugzilla/show_bug.cgi?id=6803 Avant la glibc\ 2.20, Ces fonctions ne positionnaient pas \fIerrno\fP pour les erreurs d'intervalle. .SH "VOIR AUSSI" \fBldexp\fP(3), \fBscalb\fP(3) .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 et Cédric Boutillier . .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 .