Debian Codegraph @

upstream/debian-unstable/man3/cbrt.3

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