Man page 3 : y0

y0, y0f, y0l, y1, y1f, y1l, yn, ynf, ynl - Fonctions de Bessel de seconde espèce

#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);

Effectuez l'édition des liens avec l'option -lm.

Exigences de macros de test de fonctionnalités pour la glibc (consultez feature_test_macros(7)) :

y0(), y1(), yn() :
    _SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE
y0f(), y0l(), y1f(), y1l(), ynf(), ynl() : _SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE >= 600

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(), etc. et y0l(), etc. sont des versions qui prennent et renvoient des valeurs de type float et long double, respectivement.

En cas de réussite, ces fonctions renvoient la valeur appropriée de Bessel de la seconde espèce pour x. Si x est un NaN, la valeur renvoyée est un NaN. 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.)

Consultez math_error(7) pour savoir comment déterminer qu'une erreur est survenue lors de l'appel de ces fonctions.

Les erreurs suivantes peuvent se produire :

• Erreur de domaine : x est négatif
      errno prend la valeur EDOM. Une exception indiquant une virgule flottante incorrecte (FE_INVALID) est levée.
• Erreur de pôle : x vaut 0,0 errno prend la valeur ERANGE (mais consultez la section des BOGUES). Aucune exception FE_DIVBYZERO n'est renvoyée par fetestexcept(3) dans ce cas.
• Erreur d'intervalle : soupassement (« underflow ») du résultat errno prend la valeur ERANGE. Aucune exception FE_UNDERFLOW n'est renvoyée par fetestexcept(3) dans ce cas.
• Erreur d'intervalle : dépassement pour le résultat errno n'est pas modifiée dans ce cas. Une exception de virgule flottante de dépassement (FE_OVERFLOW) est levée.

Les fonctions renvoyant des valeurs de type double se conforment à SVr4, BSD 4.3 et POSIX.1-2001. Les autres sont des fonctions non standard qui existent également sur les BSD.

En cas d'erreur de pôle, ces fonctions configurent errno avec EDOM, à la place de ERANGE comme demandé dans POSIX.1-2004. Dans le 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)

Cette page fait partie de la publication 3.52 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies peuvent être trouvées à l'adresse http://www.kernel.org/doc/man-pages/.

Depuis 2010, cette traduction est maintenue à l'aide de l'outil po4a <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du projet perkamon <http://perkamon.alioth.debian.org/>.

Alain Portal <http://manpagesfr.free.fr/> (2008).

Veuillez signaler toute erreur de traduction en écrivant à <>.

Vous pouvez toujours avoir accès à la version anglaise de ce document en utilisant la commande « LC_ALL=C man <section> <page_de_man> ».