man3/cbrt.3

   1 '\" t
   2 .\" Copyright 1995 Jim Van Zandt <jrv@vanzandt.mv.com>
   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 .\" (walter.harms@informatik.uni-oldenburg.de)
  10 .\"
  11 .TH cbrt 3 (date) "Linux man-pages (unreleased)"
  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; every representable real value has a
  51 representable real cube root.
  52 .SH RETURN VALUE
  53 These functions return the cube root of
  54 .IR x .
  55 .P
  56 If
  57 .I x
  58 is +0, \-0, positive infinity, negative infinity, or NaN,
  59 .I x
  60 is returned.
  61 .SH ERRORS
  62 No errors occur.
  63 .SH ATTRIBUTES
  64 For an explanation of the terms used in this section, see
  65 .BR attributes (7).
  66 .TS
  67 allbox;
  68 lbx lb lb
  69 l l l.
  70 Interface       Attribute       Value
  71 T{
  72 .na
  73 .nh
  74 .BR cbrt (),
  75 .BR cbrtf (),
  76 .BR cbrtl ()
  77 T}      Thread safety   MT-Safe
  78 .TE
  79 .SH STANDARDS
  80 C11, POSIX.1-2008.
  81 .SH HISTORY
  82 C99, POSIX.1-2001.
  83 .\" .BR cbrt ()
  84 .\" was a GNU extension. It is now a C99 requirement.
  85 .SH SEE ALSO
  86 .BR pow (3),
  87 .BR sqrt (3)