Tekst źródłowy strony C/pow

=== Deklaracja ===

 double      pow (double      x, double      y);
 float       powf(float       x, float       y);
 long double powl(long double x, long double y);
 
 double      sqrt (double      x);
 float       sqrtf(float       x);
 long double sqrtl(long double x);
 
 double      hypot (double      x, double      y);
 float       hypotf(float       x, float       y);
 long double hypotl(long double x, long double y);
 
 double      cbrt (double      x);
 float       cbrtf(float       x);
 long double cbrtl(long double x);
 
 double      fabs (double      x);
 float       fabsf(float       x);
 long double fabsl(long double x);

===Plik nagłówkowy===
[[C/Biblioteka standardowa/Indeks tematyczny#math.h|math.h]]

=== Argumenty ===
; x, y: argumenty funkcji

=== Opis ===
Funkcje z przyrostkami "f" i "l" to inne wersje odpowiedniej funkcji bez przyrostka operujące na innych typach danych. Z tego powodu w poniższym opisie odwołanie do konkretnej funkcji będzie oznaczać odwołanie się do wszystkich 3 wersji.

Funkcje obliczają następujące wartości:
* <tt>pow</tt> - <tt>x</tt> do potęgi <tt>y</tt>, tj. <math>x^y</math>,
* <tt>sqrt</tt> - pierwiastek kwadratowy argumentu, tj. <math>\sqrt x</math>,
* <tt>hypot</tt> - pierwiastek kwadratowy z sumy kwadratów argumentów, tj. <math>\sqrt{x^2 + y^2}</math>,
* <tt>cbrt</tt> - pierwiastek sześcienny argumentu, tj. <math>\sqrt[3] x</math>,
* <tt>fabs</tt> - wartość bezwzględna argumentu, tj. <math>|x|</math>.

Jeżeli <tt>x</tt> jest liczbą ujemną funkcje sqrt ustawiają zmienną [[C/errno|errno]] na [[C/EDOM|EDOM]]. Tak samo zachowuje się funkcja pow, jeżeli <tt>x</tt> jest skończoną ujemną wartością, a <tt>y</tt> nie jest wartością całkowitą. Błąd dziedziny może także nastąpić, gdy <tt>x</tt> jest równe zero, a <tt>y</tt> jest liczbą niedodatnią.

=== Wartość zwracana ===
Wartości odpowiednich funkcji zgodnie z opisem powyżej.

Ponadto, jeżeli wystąpi nadmiar funkcja zwraca w wyniku [[C/HUGE_VAL|HUGE_VAL]] z odpowiednim znakiem i ustawia wartość zmiennej errno na [[C/ERANGE|ERANGE]]. Jeśli wystąpi niedomiar funkcja w wyniku zwraca zero, a to czy do zmiennej errno zostanie zapisana wartość ERANGE zależy od implementacji.

=== Przykład użycia ===
<syntaxhighlight lang="c">
#include<math.h> 

  //...
  // obliczanie przeciwprostokątnej c trójkąta prostokątnego a,b,c

  double a, b, temp;   //przyprostokątne trójkąta
  double c;            //przeciwprostokątna
  temp= pow(a,2) + pow(b,2);
  c= sqrt(temp);
</syntaxhighlight>



<syntaxhighlight lang="c">
// gcc c.c -lm
#include <stdio.h>
#include <math.h> // -lm

int main()
{
   // pek = p*10^k = p*pow(10.0, k) 
    printf("%f\n", pow(10.0, 3));
    printf("%f\n", 1e3);

    return 0;
}
</syntaxhighlight>


wynik: 

<pre>
1000.000000                                                                                                                                                                                                                                     
1000.000000   
</pre>

=== Uwagi ===
Wersje funkcji z przyrostkiem "f" i "l" (tzn. wersje operujące na zmiennych typu float i long double) zostały wprowadzone dopiero w standardzie C99.  Również funkcje hypot oraz cbrt zostały wprowadzone dopiero w standardzie C99.

W przypadku użycia funkcji matematycznych może zaistnieć konieczność podania odpowiedniego argumentu linkerowi, aby ten połączył program z biblioteką matematyczną. Np. na systemach GNU/Linux jest to <tt>-lm</tt>.

===Zobacz też===
:[[C/abs|abs]] (dla liczb całkowitych)

{{BrClear}}
<noinclude>
{{Wolumin}}
</noinclude>