remainder, remainderf, remainderl

Le reste en virgule flottante IEEE de l'opération de division x / y calculé par cette fonction est exactement la valeur x - n * y , où la valeur n est la valeur entière la plus proche de la valeur exacte x / y . Lorsque |n-x/y| = ½ , la valeur n est choisie paire.

Contrairement à fmod() , la valeur retournée n'est pas garantie d'avoir le même signe que x .

Si la valeur retournée est ​ 0 ​ , elle aura le même signe que x .

Paramètres

Valeur de retour

En cas de succès, retourne le reste en virgule flottante IEEE de la division x / y tel que défini ci-dessus.

Si une erreur de domaine se produit, une valeur définie par l'implémentation est retournée (NaN là où supporté).

Si une erreur de plage se produit en raison d'un dépassement inférieur, le résultat correct est retourné.

Si y est nul, mais que l'erreur de domaine ne se produit pas, zéro est retourné.

Gestion des erreurs

Les erreurs sont signalées comme spécifié dans math_errhandling .

Une erreur de domaine peut survenir si y est nul.

Si l'implémentation prend en charge l'arithmétique à virgule flottante IEEE (IEC 60559),

• Le mode d'arrondi actuel n'a aucun effet.
• FE_INEXACT n'est jamais déclenchée, le résultat est toujours exact.
• Si x est ±∞ et y n'est pas NaN, NaN est retourné et FE_INVALID est déclenchée.
• Si y est ±0 et x n'est pas NaN, NaN est retourné et FE_INVALID est déclenchée.
• Si l'un des arguments est NaN, NaN est retourné.

Notes

POSIX exige qu'une erreur de domaine se produise si x est infini ou y est zéro.

fmod , mais pas remainder , est utile pour effectuer un enveloppement silencieux des types à virgule flottante vers les types entiers non signés : ( 0.0 <= ( y = fmod ( rint ( x ) , 65536.0 ) ) ? y : 65536.0 + y ) est dans l'intervalle [ - 0.0 , 65535.0 ] , ce qui correspond à unsigned short , mais remainder ( rint ( x ) , 65536.0 ) est dans l'intervalle [ - 32767.0 , + 32768.0 ] , ce qui est en dehors de l'intervalle de signed short .

Exemple

#include <fenv.h>
#include <math.h>
#include <stdio.h>
// #pragma STDC FENV_ACCESS ON
int main(void)
{
    printf("remainder(+5.1, +3.0) = %.1f\n", remainder(5.1, 3));
    printf("remainder(-5.1, +3.0) = %.1f\n", remainder(-5.1, 3));
    printf("remainder(+5.1, -3.0) = %.1f\n", remainder(5.1, -3));
    printf("remainder(-5.1, -3.0) = %.1f\n", remainder(-5.1, -3));
    // valeurs spéciales
    printf("remainder(-0.0, 1.0) = %.1f\n", remainder(-0.0, 1));
    printf("remainder(+5.1, Inf) = %.1f\n", remainder(5.1, INFINITY));
    // gestion des erreurs
    feclearexcept(FE_ALL_EXCEPT);
    printf("remainder(+5.1, 0) = %.1f\n", remainder(5.1, 0));
    if (fetestexcept(FE_INVALID))
        puts("    FE_INVALID raised");
}

remainder(+5.1, +3.0) = -0.9
remainder(-5.1, +3.0) = 0.9
remainder(+5.1, -3.0) = -0.9
remainder(-5.1, -3.0) = 0.9
remainder(+0.0, 1.0) = 0.0
remainder(-0.0, 1.0) = -0.0
remainder(+5.1, Inf) = 5.1
remainder(+5.1, 0) = -nan
    FE_INVALID raised

Références

Voir aussi