y0, y0f, y0l, y1, y1f, y1l, yn, ynf, ynl - Fonctions de Bessel de seconde
espèce
Bibliothèque de math (
libm,
-lm)
#include <math.h>
double y0(double x);
double y1(double x);
double yn(int n, double x);
float y0f(float x);
float y1f(float x);
float ynf(int n, float x);
long double y0l(long double x);
long double y1l(long double x);
long double ynl(int n, long double x);
y0(),
y1(),
yn() :
_ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
|| /* Depuis la glibc 2.19 : */ _DEFAULT_SOURCE
|| /* glibc <= 2.19 : */ _BSD_SOURCE || _SVID_SOURCE
y0f(),
y0l(),
y1f(),
y1l(),
ynf(),
ynl() :
_XOPEN_SOURCE >= 600
|| (_ISOC99_SOURCE && _XOPEN_SOURCE)
|| /* depuis la glibc 2.19 : */ _DEFAULT_SOURCE
|| /* glibc <= 2.19 : */ _SVID_SOURCE || _BSD_SOURCE
Les fonctions
y0() et
y1() renvoient les fonctions de Bessel de
x de la seconde espèce pour l'ordre 0 et l'ordre 1,
respectivement. La fonction
yn() renvoie la fonction de Bessel de
x de la seconde espèce à l'ordre
n.
La valeur
x doit être positive.
Les fonctions
y0f(),
y1f() et
ynf() sont des versions qui
prennent en argument et renvoient des valeurs de type
float. Les
fonctions
y0l(),
y1l() et
ynl() sont des versions qui
prennent en argument et renvoient des valeurs de type
long double.
En cas de réussite, ces fonctions renvoient la valeur appropriée
de Bessel de la seconde espèce pour
x.
Si
x n’est pas un nombre, un
NaN est
renvoyé.
Si
x est négatif, une erreur de domaine se produit et les
fonctions renvoient -
HUGE_VAL, -
HUGE_VALF ou -
HUGE_VALL,
respectivement (POSIX.1-2001 permet également de renvoyer un NaN dans
ce cas).
Si
x vaut 0,0, une erreur de pôle se produit et les fonctions
renvoient -
HUGE_VAL, -
HUGE_VALF ou -
HUGE_VALL,
respectivement.
En cas de dépassement pour le résultat, une erreur d'intervalle se
produit et les fonctions renvoient 0,0.
En cas de dépassement pour le résultat, une erreur d'intervalle se
produit et les fonctions renvoient -
HUGE_VAL, -
HUGE_VALF ou
-
HUGE_VALL, respectivement. (POSIX.1-2001 permet également de
renvoyer 0,0 dans ce cas.)
Voir
math_error(7) pour savoir comment déterminer si une erreur
s'est produite lors de l'appel d'une de ces fonctions.
Les erreurs suivantes peuvent se produire :
- Erreur de domaine : x est négatif
-
errno prend la valeur EDOM. Une exception de
virgule flottante non valable ( FE_INVALID) est levée.
- Erreur de pôle : x vaut 0,0
-
errno prend la valeur ERANGE et une exception
FE_DIVBYZERO est levée (mais voir BOGUES).
- Erreur d'intervalle : dépassement par le bas
du résultat
-
errno prend la valeur ERANGE. Aucune
exception FE_UNDERFLOW n'est renvoyée par
fetestexcept(3) dans ce cas.
- Erreur de plage : débordement du
résultat
-
errno est définie à ERANGE
(mais consultez la section des BOGUES). Une exception de
dépassement par le haut en virgule flottante ( FE_OVERFLOW)
est levée.
Pour une explication des termes utilisés dans cette section, consulter
attributes(7).
Interface |
Attribut |
Valeur |
y0(), y0f(), y0l() |
Sécurité des threads |
MT-Safe |
y1(), y1f(), y1l() |
Sécurité des threads |
MT-Safe |
yn(), ynf(), ynl() |
Sécurité des threads |
MT-Safe |
Les fonctions renvoyant des valeurs de type
double se conforment à
SVr4, 4.3BSD, POSIX.1-2001 et POSIX.1-2008. Les autres sont des fonctions non
standard qui existent également sur les BSD.
Avant la glibc 2.19, ces fonctions diagnostiquaient de façon
incorrecte les erreurs de pôle :
errno était
défini à
EDOM au lieu de
ERANGE et aucune
exception
FE_DIVBYZERO n'était levée.
Avant la glibc 2.17, ces fonctions ne définissait pas d'erreur
pour « range error: result underflow ».
Dans la glibc 2.3.2 et les versions antérieures, ces fonctions ne
lèvent pas d'exception de virgule flottante incorrecte (
FE_INVALID) quand une erreur de domaine se produit.
j0(3)
La traduction française de cette page de manuel a été
créée par Christophe Blaess
<
https://www.blaess.fr/christophe/>, Stéphan Rafin
<
[email protected]>, Thierry Vignaud
<
[email protected]>, François Micaux, Alain Portal
<
[email protected]>, Jean-Philippe Guérard
<
[email protected]>, Jean-Luc Coulon (f5ibh)
<
[email protected]>, Julien Cristau
<
[email protected]>, Thomas Huriaux <
[email protected]>,
Nicolas François <
[email protected]>, Florentin
Duneau <
[email protected]>, Simon Paillard
<
[email protected]>, Denis Barbier
<
[email protected]>, David Prévot <
[email protected]>,
Cédric Boutillier <
[email protected]> et Jean-Pierre
Giraud <
[email protected]>
Cette traduction est une documentation libre ; veuillez vous reporter
à la
GNU
General Public License version 3 concernant les conditions de copie
et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel,
veuillez envoyer un message à
[email protected]