Debian Codegraph @

upstream/debian-trixie/man3/cbrt.3

raw
1 '\" t
2 .\" Copyright 1995 Jim Van Zandt <[email protected]>
3 .\"
4 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
5 .\"
6 .\" changed `square root' into `cube root' - aeb, 950919
7 .\"
8 .\" Modified 2002-07-27 Walter Harms
9 .\" ([email protected])
10 .\"
11 .TH cbrt 3 2024-05-02 "Linux man-pages 6.9.1"
12 .SH NAME
13 cbrt, cbrtf, cbrtl \- cube root function
14 .SH LIBRARY
15 Math library
16 .RI ( libm ", " \-lm )
17 .SH SYNOPSIS
18 .nf
19 .B #include <math.h>
20 .P
21 .BI "double cbrt(double " x );
22 .BI "float cbrtf(float " x );
23 .BI "long double cbrtl(long double " x );
24 .fi
25 .P
26 .RS -4
27 Feature Test Macro Requirements for glibc (see
28 .BR feature_test_macros (7)):
29 .RE
30 .P
31 .BR cbrt ():
32 .nf
33 _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
34 || _XOPEN_SOURCE >= 500
35 .\" || _XOPEN_SOURCE && _XOPEN_SOURCE_EXTENDED
36 || /* Since glibc 2.19: */ _DEFAULT_SOURCE
37 || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
38 .fi
39 .P
40 .BR cbrtf (),
41 .BR cbrtl ():
42 .nf
43 _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
44 || /* Since glibc 2.19: */ _DEFAULT_SOURCE
45 || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
46 .fi
47 .SH DESCRIPTION
48 These functions return the (real) cube root of
49 .IR x .
50 This function cannot fail;
51 every representable real value
52 has a real cube root,
53 and rounding it to a representable value
54 never causes overflow nor underflow.
55 .SH RETURN VALUE
56 These functions return the cube root of
57 .IR x .
58 .P
59 If
60 .I x
61 is +0, \-0, positive infinity, negative infinity, or NaN,
62 .I x
63 is returned.
64 .SH ERRORS
65 No errors occur.
66 .SH ATTRIBUTES
67 For an explanation of the terms used in this section, see
68 .BR attributes (7).
69 .TS
70 allbox;
71 lbx lb lb
72 l l l.
73 Interface Attribute Value
74 T{
75 .na
76 .nh
77 .BR cbrt (),
78 .BR cbrtf (),
79 .BR cbrtl ()
80 T} Thread safety MT-Safe
81 .TE
82 .SH STANDARDS
83 C11, POSIX.1-2008.
84 .SH HISTORY
85 C99, POSIX.1-2001.
86 .\" .BR cbrt ()
87 .\" was a GNU extension. It is now a C99 requirement.
88 .SH SEE ALSO
89 .BR pow (3),
90 .BR sqrt (3)