Debian Codegraph @

upstream/debian-unstable/man3/j0.3

raw
1 '\" t
2 .\" Copyright 1993, David Metcalfe <[email protected]>
3 .\" Copyright, the authors of the Linux man-pages project
4 .\"
5 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
6 .\"
7 .TH j0 3 2026-02-08 "Linux man-pages 6.18"
8 .SH NAME
9 j0, j0f, j0l, j1, j1f, j1l, jn, jnf, jnl \-
10 Bessel functions of the first kind
11 .SH LIBRARY
12 Math library
13 .RI ( libm ,\~ \-lm )
14 .SH SYNOPSIS
15 .nf
16 .B #include <math.h>
17 .P
18 .BI "double j0(double " x );
19 .BI "double j1(double " x );
20 .BI "double jn(int " n ", double " x );
21 .P
22 .BI "float j0f(float " x );
23 .BI "float j1f(float " x );
24 .BI "float jnf(int " n ", float " x );
25 .P
26 .BI "long double j0l(long double " x );
27 .BI "long double j1l(long double " x );
28 .BI "long double jnl(int " n ", long double " x );
29 .fi
30 .P
31 .RS -4
32 Feature Test Macro Requirements for glibc (see
33 .BR feature_test_macros (7)):
34 .RE
35 .P
36 .BR j0 (),
37 .BR j1 (),
38 .BR jn ():
39 .nf
40 _XOPEN_SOURCE
41 || /* Since glibc 2.19: */ _DEFAULT_SOURCE
42 || /* glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE
43 .fi
44 .P
45 .BR j0f (),
46 .BR j0l (),
47 .BR j1f (),
48 .BR j1l (),
49 .BR jnf (),
50 .BR jnl ():
51 .nf
52 _XOPEN_SOURCE >= 600
53 || (_ISOC99_SOURCE && _XOPEN_SOURCE)
54 || /* Since glibc 2.19: */ _DEFAULT_SOURCE
55 || /* glibc <= 2.19: */ _SVID_SOURCE || _BSD_SOURCE
56 .fi
57 .SH DESCRIPTION
58 The
59 .BR j0 ()
60 and
61 .BR j1 ()
62 functions return Bessel functions of
63 .I x
64 of the first kind of orders 0 and 1, respectively.
65 The
66 .BR jn ()
67 function
68 returns the Bessel function of
69 .I x
70 of the first kind of order
71 .IR n .
72 .P
73 The
74 .BR j0f (),
75 .BR j1f (),
76 and
77 .BR jnf (),
78 functions are versions that take and return
79 .I float
80 values.
81 The
82 .BR j0l (),
83 .BR j1l (),
84 and
85 .BR jnl ()
86 functions are versions that take and return
87 .I "long double"
88 values.
89 .SH RETURN VALUE
90 On success, these functions return the appropriate
91 Bessel value of the first kind for
92 .IR x .
93 .P
94 If
95 .I x
96 is a NaN, a NaN is returned.
97 .P
98 If
99 .I x
100 is too large in magnitude,
101 or the result underflows,
102 a range error occurs,
103 and the return value is 0.
104 .SH ERRORS
105 See
106 .BR math_error (7)
107 for information on how to determine whether an error has occurred
108 when calling these functions.
109 .P
110 The following errors can occur:
111 .TP
112 Range error: result underflow, or \f[I]x\f[] is too large in magnitude
113 .I errno
114 is set to
115 .BR ERANGE .
116 .P
117 These functions do not raise exceptions for
118 .BR fetestexcept (3).
119 .\" e.g., j0(1.5e16)
120 .\" This is intentional.
121 .\" See https://www.sourceware.org/bugzilla/show_bug.cgi?id=6805
122 .SH ATTRIBUTES
123 For an explanation of the terms used in this section, see
124 .BR attributes (7).
125 .TS
126 allbox;
127 lbx lb lb
128 l l l.
129 Interface Attribute Value
130 T{
131 .na
132 .nh
133 .BR j0 (),
134 .BR j0f (),
135 .BR j0l ()
136 T} Thread safety MT-Safe
137 T{
138 .na
139 .nh
140 .BR j1 (),
141 .BR j1f (),
142 .BR j1l ()
143 T} Thread safety MT-Safe
144 T{
145 .na
146 .nh
147 .BR jn (),
148 .BR jnf (),
149 .BR jnl ()
150 T} Thread safety MT-Safe
151 .TE
152 .SH STANDARDS
153 .TP
154 .BR j0 ()
155 .TQ
156 .BR j1 ()
157 .TQ
158 .BR jn ()
159 POSIX.1-2008.
160 .TP
161 Others:
162 BSD.
163 .SH HISTORY
164 .TP
165 .BR j0 ()
166 .TQ
167 .BR j1 ()
168 .TQ
169 .BR jn ()
170 SVr4, 4.3BSD,
171 POSIX.1-2001, POSIX.1-2008.
172 .TP
173 Others:
174 BSD.
175 .SH BUGS
176 There are errors of up to 2e\-16 in the values returned by
177 .BR j0 (),
178 .BR j1 (),
179 and
180 .BR jn ()
181 for values of
182 .I x
183 between \-8 and 8.
184 .SH SEE ALSO
185 .BR y0 (3)