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

Usunięta treść Dodana treść
m usunięcie kategorii
Mina86 (dyskusja | edycje)
Połączony opis funkcji trygonometrycznych i hiperbolicznych; Dokładniejszy opis i przykład
Linia 1:
=== Deklaracja ===
: double acos (double x);
 
#include <math.h>
==Plik nagłówkowy==
: [[C/Biblioteka standardowa/Indeks tematyczny#math.h|math.h]]
 
==== Arcusy funkcji trygonometrycznych ====
==Opis==
 
Funkcja acos zwraca [[w:Funkcje odwrotne do trygonometrycznych|arcus cosinus]] argumentu x, podanego w radianach.
double acos (double x);
float acosf (float x);
long double acosl (long double x);
double asin (double x);
float asinf (float x);
long double asinl (long double x);
double atan (double x);
float atanf (float x);
long double atanl (long double x);
double atan2 (double a, double b);
float atan2f(float a, double b);
long double atan2l(long double a, double b);
 
==== Funkcje trygonometryczne ====
 
double cos (double x);
float cosf (float x);
long double cosl (long double x);
double sin (double x);
float sinf (float x);
long double sinl (long double x);
double tan (double x);
float tanf (float x);
long double tanl (long double x);
 
==== Area funkcji hiperbolicznych ====
 
double acosh (double x);
float acoshf(float x);
long double acoshl(long double x);
double asinh (double x);
float asinhf(float x);
long double asinhl(long double x);
double atanh (double x);
float atanhf(float x);
long double atanhl(long double x);
 
==== Funkcje hiperboliczne ====
 
double cosh (double x);
float coshf(float x);
long double coshl(long double x);
double sinh (double x);
float sinhf(float x);
long double sinhl(long double x);
double tanh (double x);
float tanhf(float x);
long double tanhl(long double x);
 
=== Argumenty ===
; x: argument funkcji matematycznej. Miary kątów podawane są w radianach
; a, b: współrzędne punktu na okręgu
 
=== 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 werji.
 
Funkcje liczą wartości odpowiednich funkcji matematycznych zgodnie z ich nazwą:
* <tt>acos</tt> - [[w:Funkcje odwrotne do trygonometrycznych|arcus cosinus]] argumentu,
* <tt>asin</tt> - arcus sinus argumentu,
* <tt>atan</tt> - arcus tangens argumentu,
* <tt>atan2</tt> - arcus tangens ilorazu argumentu,
* <tt>cos</tt> - [[w:Funkcje trygonometryczne|cosinus]] argumentu,
* <tt>sin</tt> - sinus argumentu,
* <tt>tan</tt> - tangens argumentu.
Funkcje z przyrostkiem "h" obliczają wartości analogicznych [[w:Funkcje hiperboliczne|funkcji hiperbolicznych]] i [[w:Funkcje hiperboliczne odwrotne|funkcji area]].
 
Funkcja atan2 bierze pod uwagę znaki obu argumentów dzięki czemu może dokładnie obliczyć kąt. Funkcja atan nie posiada takich informacji przez co przedział zwracanych przez nią wartości jest dwa razy mniejszy.
 
Jeżeli wartości argumentu <tt>x</tt> jest spoza przedziału <tt><nowiki>[-1; 1]</nowiki></tt> funkcje acos i asin zwracają nieokreśloną wartość na zmienna [[C/errno|errno]] ustawiona jest na [[C/EDOM|EDOM]]. Podobnie, jeżeli argumenty <tt>a</tt> i <tt>b</tt> są jednocześnie równe 0 funkcja atan2 ustawia zmienną errno na EDOM.
 
=== Wartość zwracana ===
Wartości odpowiednich funkcji matematycznych. Dodatkowo, dla arcusów funkcji trygonometrycznych zakres zwracanych wartości jest ograniczony. Dla funkcji:
* acos jest to przedział <tt><nowiki>[0; &Pi;]</nowiki></tt>,
* asin jest to przedział <tt><nowiki>[-&Pi;/2; &Pi;/2]</nowiki></tt>,
* atan jest to przedział <tt><nowiki>[-&Pi;/2; &Pi;/2]</nowiki></tt>, natomiast
* atan2 jest to przedział <tt><nowiki>[-&Pi;; &Pi;]</nowiki></tt>.
 
Ponadto, jeżeli wystąpi nadmair funkcja zwraca w wyniku [[C/HUGE_VAL|HUGE_VAL]] z odpowiednim znakiem i ustawia wartość zmeinnej 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 ===
 
#include <math.h>
#include <stdio.h>
/* Program oblicza wychylenie, prędkość i przyśpieszenie
ciała, gdy drga ono harmonicznie */
int main(void) {
double A, omega, t, x, V, a;
printf("A = ");
if (scanf("%lf", &A)!=1) return 1;
printf("omega = ");
if (scanf("%lf", &omega)!=1) return 1;
printf("t = ");
if (scanf("%lf", &t)!=1) return 1;
x = A * sin(omega * t);
V = A * omega * cos(omega * t);
a = - omega * omega * x;
printf("x = %f\nV = %f\na = %f\n", x, V, a);
return 0;
}
 
=== Uwagi ===
Wersje funkcji z przyroskiem "f" i "l" (tzn. wersje operujące na zmiennych typu float i long double) zostały wprwoadzone dopiero w standardzie C99.
 
W przypadku użycia funkcji matematycznych może zaistnieć konieczność podania odpowiedneigo argumentu linkerowi, aby ten połączył program z biblioteką matematyczną. Np. na systemach GNU/Linux jest to <tt>-lm</tt>.