Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

<tgmath.h> — mathématiques génériques selon le type

L’en-tête <tgmath.h> fournit des macros qui sélectionnent les fonctions mathématiques en fonction des types des arguments.

Version : C23; repository compiler flag, production runtime not attested

Syntaxe

#include <tgmath.h>

<tgmath.h> inclut <math.h> et <complex.h>. Des macros comme sqrt sélectionnent la fonction appropriée sans qu’un suffixe explicite soit nécessaire.

Pour les types réels ordinaires, sqrt(float) sélectionne sqrtf, sqrt(double) sélectionne sqrt et sqrt(long double) sélectionne sqrtl. Un appel à sqrt avec un argument entier sélectionne la variante pour double. Seuls les arguments qui correspondent à des paramètres génériques interviennent dans la sélection. Les macros suivent leurs propres règles de sélection, distinctes des conversions arithmétiques habituelles. Si l’implémentation prend en charge les types flottants décimaux, la macro pow, appelée avec un argument de type _Decimal32 et un argument entier, sélectionne la variante pour _Decimal64, alors que les conversions arithmétiques habituelles donnent _Decimal32 comme type commun pour des opérandes de ces types.

Un argument complexe peut entraîner la sélection d’une fonction complexe. sqrt(-1.0) seul ne sélectionne pas csqrt. Mélanger des types flottants standard et décimaux dans des arguments génériques entraîne un comportement indéfini. L’exemple vérifie les types avec _Generic et calcule une racine carrée.

Exemples

#include <stdio.h>
#include <tgmath.h>

int main(void)
{
    printf("float: %d\n", _Generic(sqrt(4.0f), float: 1, default: 0));
    printf("double: %d\n", _Generic(sqrt(4), double: 1, default: 0));
    printf("long double: %d\n", _Generic(sqrt(4.0L), long double: 1, default: 0));
    printf("value: %.0f\n", (double)sqrt(4.0f));
    return 0;
}

Résultat

float: 1
double: 1
long double: 1
value: 2

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources