C/pow: Różnice pomiędzy wersjami

Z Wikibooks, biblioteki wolnych podręczników.
< C
Usunięta treść Dodana treść
Linia 53: Linia 53:
double a, b, temp; //przyprostokątne trójkąta
double a, b, temp; //przyprostokątne trójkąta
double c; //przeciwprostokątna
double c; //przeciwprostokątna
temp= pow(a,2) + pow(b,2);
temp= pow(a,2) + pow(b,2); // jak już jest funkcja hypot to najlepiej od razu:
c= sqrt(temp);
c= sqrt(temp); // c = hypot(a, b);
</source>
</source>



Wersja z 11:15, 2 wrz 2011

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

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:

  • pow - x do potęgi y, tj. ,
  • sqrt - pierwiastek kwadratowy argumentu, tj. ,
  • hypot - pierwiastek kwadratowy z sumy kwadratów argumentów, tj. ,
  • cbrt - pierwiastek sześcienny argumentu, tj. ,
  • fabs - wartość bezwzględna argumentu, tj. .

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

Wartość zwracana

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

Ponadto, jeżeli wystąpi nadmair funkcja zwraca w wyniku HUGE_VAL z odpowiednim znakiem i ustawia wartość zmeinnej errno na 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

#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);  // jak już jest funkcja hypot to najlepiej od razu:  
  c= sqrt(temp);       //    c = hypot(a, b);

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 -lm.