y0, y0f, y0l, y1, y1f, y1l, yn, ynf, ynl - Bessel functions of the second kind

Synopsis

Description

Return Value

Errors

Bugs

See Also

Colophon

#include <math.h>

double y0(doublex);

double y1(doublex);

double yn(intn, doublex);

float y0f(floatx);

float y1f(floatx);

float ynf(intn, floatx);

long double y0l(long doublex);

long double y1l(long doublex);

long double ynl(intn, long doublex);Link with

-lm.Feature Test Macro Requirements for glibc (see

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

The

y0() andy1() functions return Bessel functions ofxof the second kind of orders 0 and 1, respectively. Theyn() function returns the Bessel function ofxof the second kind of ordern.The value of

xmust be positive.The

y0f() etc. andy0l() etc. functions are versions that take and returnfloatandlong doublevalues, respectively.

On success, these functions return the appropriate Bessel value of the second kind forx.If

xis a NaN, a NaN is returned.If

xis negative, a domain error occurs, and the functions return -HUGE_VAL, -HUGE_VALF, or -HUGE_VALL, respectively. (POSIX.1-2001 also allows a NaN return for this case.)If

xis 0.0, a pole error occurs, and the functions return -HUGE_VAL, -HUGE_VALF, or -HUGE_VALL, respectively.If the result underflows, a range error occurs, and the functions return 0.0

If the result overflows, a range error occurs, and the functions return -

HUGE_VAL, -HUGE_VALF, or -HUGE_VALL, respectively. (POSIX.1-2001 also allows a 0.0 return for this case.)

Seemath_error(7) for information on how to determine whether an error has occurred when calling these functions.The following errors can occur:

Domain error: xis negativeerrnois set toEDOM. An invalid floating-point exception (FE_INVALID) is raised.Pole error: xis 0.0errnois set toERANGE(but see BUGS). NoFE_DIVBYZEROexception is returned byfetestexcept(3) for this case.Range error: result underflow errnois set toERANGE. NoFE_UNDERFLOWexception is returned byfetestexcept(3) for this case.Range error: result overflow errnois not set for this case. An overflow floating-point exception (FE_OVERFLOW) is raised.

The functions returningdoubleconform to SVr4, 4.3BSD, POSIX.1-2001. The others are nonstandard functions that also exist on the BSDs.

On a pole error, these functions seterrnotoEDOM, instead ofERANGEas POSIX.1-2004 requires.In glibc version 2.3.2 and earlier, these functions do not raise an invalid floating-point exception (

FE_INVALID) when a domain error occurs.

j0(3)

This page is part of release 3.44 of the Linuxman-pagesproject. A description of the project, and information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/.

Y0 (3) | 2008-08-10 |