Tekst źródłowy strony C/fmod

=== Deklaracja ===

 double      fmod (double      x, double      y);
 float       fmodf(float       x, float       y);
 long double fmodl(long double x, long double y);
 
 double      remainder (double      x, double      y);
 float       remainderf(float       x, float       y);
 long double remainderl(long double x, long double y);
 
 double      remquo (double      x, double      y, int *quo);
 float       remquof(float       x, float       y, int *quo);
 long double remquol(long double x, long double y, int *quo);

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

=== Argumenty ===
; x, y: argumenty ilorazu
; quo: wskaźnik do części 

=== 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 bez lub z przyrostkiem.

Funkcja fmod oblicza resztę z dzielenia <tt>x</tt> przez <tt>y</tt>, tzn. taką liczbę <math>r</math>, że jeżeli <tt>y</tt> jest różne od zera, zachodzi: 

:<math>\exists_{n \in \mathbb{Z}} \ r = x - ny \ \wedge\ xr \ge 0 \ \wedge\ |r| < |y|</math>.

Funkcja remainder zwraca resztę z dzielenia <tt>x</tt> przez <tt>y</tt> wymaganą przez IEC 60559, tzn. taką liczbę <math>r</math>, że jeżeli <tt>y</tt> jest różne od zera, zachodzi: <math>r = x - ny</math>, gdzie <math>n</math> jest liczbą całkowitą najbliższą wartości <math>x/y</math>. Jeżeli istnieją dwie takie liczby całkowite <math>n</math> jest parzysta.

Funkcja remquo zwraca resztę z dzielenia <tt>x</tt> przez <tt>y</tt> jak funkcja remainder i dodatkowo, zapisuje w zmiennej wskazywanej przez <tt>quo</tt> wartość przystającą modulo <math>2^k</math> do wartości bezwzględnej wyrażenia <math>(x-r)/y</math>, gdzie <math>k</math> jest wartością zależną od implementacji nie mniejszą niż 3.

=== Wartość zwracana ===
Wartości odpowiednich funkcji zgodnie z opisem powyżej. Jeżeli <tt>y</tt> jest równe zero funkcja może zwrócić zero lub ustawić wartość zmiennej [[C/errno|errno]] na [[C/EDOM|EDOM]].

=== Przykład użycia ===

Redukcja zakresu dla funkcji trygonometrycznych ( okresowych). <ref>[https://www.trygonometria.edu.pl/funkcje-trygonometryczne-dowolnego-kata-i-wzory-redukcyjne/ trygonometria: funkcje-trygonometryczne-dowolnego-kata-i-wzory-redukcyjne]</ref>

 sin (1500) = sin (60º + 4*360º) = sin (60º) //  w stopniach
  <math>\sin(\alpha + 2\pi k) = \sin(\alpha)</math> // w radianach


<syntaxhighlight lang="c">  
/*
  gcc f.c -Wall -Wextra -lm
  ./a.out
*/
#include <stdio.h>
#include <math.h>
#include <stdlib.h> // Data Type: div_t

int main () {
	double r = 300.1234;
	double rr;
	double TwoPi=2.0*M_PI; // 
	div_t result; // ang. result = wynik
	result = div ((int) r, (int) TwoPi);
	rr = fmod(r,TwoPi); // range reduction for trigonometric function in radians
	
   
	printf("%f =  %f +  %d*%f \n", r, rr , result.quot, TwoPi);
   
   
   return(0);
}

</syntaxhighlight>


Wynik: 

 300.123400 =  4.813691 +  50*6.283185

=== 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 remainder oraz remquo 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>.


=== Żródła===
<references/>

[[Kategoria:Programowanie]]