man3/log10.3

   1 '\" t
   2 .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
   3 .\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk
   4 .\"     <mtk.manpages@gmail.com>
   5 .\"
   6 .\" SPDX-License-Identifier: Linux-man-pages-copyleft
   7 .\"
   8 .\" References consulted:
   9 .\"     Linux libc source code
  10 .\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
  11 .\"     386BSD man pages
  12 .\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu)
  13 .\" Modified 1995-08-14 by Arnt Gulbrandsen <agulbra@troll.no>
  14 .\" Modified 2002-07-27 by Walter Harms
  15 .\"     (walter.harms@informatik.uni-oldenburg.de)
  16 .\"
  17 .TH log10 3 (date) "Linux man-pages (unreleased)"
  18 .SH NAME
  19 log10, log10f, log10l \-  base-10 logarithmic function
  20 .SH LIBRARY
  21 Math library
  22 .RI ( libm ", " \-lm )
  23 .SH SYNOPSIS
  24 .nf
  25 .B #include <math.h>
  26 .PP
  27 .BI "double log10(double " x );
  28 .BI "float log10f(float " x );
  29 .BI "long double log10l(long double " x );
  30 .fi
  31 .PP
  32 .RS -4
  33 Feature Test Macro Requirements for glibc (see
  34 .BR feature_test_macros (7)):
  35 .RE
  36 .PP
  37 .BR log10f (),
  38 .BR log10l ():
  39 .nf
  40     _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
  41         || /* Since glibc 2.19: */ _DEFAULT_SOURCE
  42         || /* glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
  43 .fi
  44 .SH DESCRIPTION
  45 These functions return the base 10 logarithm of
  46 .IR x .
  47 .SH RETURN VALUE
  48 On success, these functions return the base 10 logarithm of
  49 .IR x .
  50 .PP
  51 For special cases, including where
  52 .I x
  53 is 0, 1, negative, infinity, or NaN, see
  54 .BR log (3).
  55 .SH ERRORS
  56 See
  57 .BR math_error (7)
  58 for information on how to determine whether an error has occurred
  59 when calling these functions.
  60 .PP
  61 For a discussion of the errors that can occur for these functions, see
  62 .BR log (3).
  63 .SH ATTRIBUTES
  64 For an explanation of the terms used in this section, see
  65 .BR attributes (7).
  66 .ad l
  67 .nh
  68 .TS
  69 allbox;
  70 lbx lb lb
  71 l l l.
  72 Interface       Attribute       Value
  73 T{
  74 .BR log10 (),
  75 .BR log10f (),
  76 .BR log10l ()
  77 T}      Thread safety   MT-Safe
  78 .TE
  79 .hy
  80 .ad
  81 .sp 1
  82 .SH STANDARDS
  83 C99, POSIX.1-2001, POSIX.1-2008.
  84 .PP
  85 The variant returning
  86 .I double
  87 also conforms to
  88 SVr4, 4.3BSD.
  89 .SH SEE ALSO
  90 .BR cbrt (3),
  91 .BR clog10 (3),
  92 .BR exp10 (3),
  93 .BR log (3),
  94 .BR log2 (3),
  95 .BR sqrt (3)