j0f(3) - f35

1J0(3)                      Linux Programmer's Manual                     J0(3)
2
3
4

NAME

6       j0,  j0f,  j0l,  j1,  j1f,  j1l, jn, jnf, jnl - Bessel functions of the
7       first kind
8

SYNOPSIS

10       #include <math.h>
11
12       double j0(double x);
13       double j1(double x);
14       double jn(int n, double x);
15
16       float j0f(float x);
17       float j1f(float x);
18       float jnf(int n, float x);
19
20       long double j0l(long double x);
21       long double j1l(long double x);
22       long double jnl(int n, long double x);
23
24       Link with -lm.
25
26   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):
27
28       j0(), j1(), jn():
29           _XOPEN_SOURCE
30               || /* Since glibc 2.19: */ _DEFAULT_SOURCE
31               || /* Glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE
32
33       j0f(), j0l(), j1f(), j1l(), jnf(), jnl():
34           _XOPEN_SOURCE >= 600
35               || (_ISOC99_SOURCE && _XOPEN_SOURCE)
36               || /* Since glibc 2.19: */ _DEFAULT_SOURCE
37               || /* Glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE
38

DESCRIPTION

40       The j0() and j1() functions return Bessel functions of x of  the  first
41       kind  of  orders  0 and 1, respectively.  The jn() function returns the
42       Bessel function of x of the first kind of order n.
43
44       The j0f(), j1f(), and jnf(), functions are versions that take  and  re‐
45       turn  float values.  The j0l(), j1l(), and jnl() functions are versions
46       that take and return long double values.
47

RETURN VALUE

49       On success, these functions return the appropriate Bessel value of  the
50       first kind for x.
51
52       If x is a NaN, a NaN is returned.
53
54       If x is too large in magnitude, or the result underflows, a range error
55       occurs, and the return value is 0.
56

ERRORS

58       See math_error(7) for information on how to determine whether an  error
59       has occurred when calling these functions.
60
61       The following errors can occur:
62
63       Range error: result underflow, or x is too large in magnitude
64              errno is set to ERANGE.
65
66       These functions do not raise exceptions for fetestexcept(3).
67

ATTRIBUTES

69       For  an  explanation  of  the  terms  used  in  this  section,  see at‐
70       tributes(7).
71
72       ┌────────────────────────────────────────────┬───────────────┬─────────┐
73       │Interface                                   │ Attribute     │ Value   │
74       ├────────────────────────────────────────────┼───────────────┼─────────┤
75       │j0(), j0f(), j0l()                          │ Thread safety │ MT-Safe │
76       ├────────────────────────────────────────────┼───────────────┼─────────┤
77       │j1(), j1f(), j1l()                          │ Thread safety │ MT-Safe │
78       ├────────────────────────────────────────────┼───────────────┼─────────┤
79       │jn(), jnf(), jnl()                          │ Thread safety │ MT-Safe │
80       └────────────────────────────────────────────┴───────────────┴─────────┘
81

CONFORMING TO

83       The functions returning double conform to SVr4,  4.3BSD,  POSIX.1-2001,
84       and POSIX.1-2008.  The others are nonstandard functions that also exist
85       on the BSDs.
86

BUGS

88       There are errors of up to 2e-16 in the values returned by  j0(),  j1(),
89       and jn() for values of x between -8 and 8.
90

COLOPHON

95       This  page  is  part of release 5.12 of the Linux man-pages project.  A
96       description of the project, information about reporting bugs,  and  the
97       latest     version     of     this    page,    can    be    found    at
98       https://www.kernel.org/doc/man-pages/.
99
100
101
102                                  2021-03-22                             J0(3)