Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

<tgmath.h> — matematica generica in base al tipo

L’header <tgmath.h> fornisce macro che selezionano le funzioni matematiche in base ai tipi degli argomenti.

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

Sintassi

#include <tgmath.h>

<tgmath.h> include <math.h> e <complex.h>. Macro come sqrt selezionano la funzione appropriata senza richiedere un suffisso esplicito.

Per i normali tipi reali, sqrt(float) seleziona sqrtf, sqrt(double) seleziona sqrt e sqrt(long double) seleziona sqrtl. Una chiamata a sqrt con un argomento intero seleziona la variante per double. Alla selezione partecipano solo gli argomenti che corrispondono a parametri generici. Le macro seguono regole di selezione proprie, distinte dalle consuete conversioni aritmetiche. Se l’implementazione supporta i tipi decimali a virgola mobile, la macro pow con un argomento di tipo _Decimal32 e un argomento intero seleziona la variante per _Decimal64, anche se le consuete conversioni aritmetiche danno _Decimal32 come tipo comune per operandi di quei tipi.

Un argomento complesso può selezionare una funzione complessa. sqrt(-1.0) da solo non seleziona csqrt. Mescolare tipi a virgola mobile standard e decimali negli argomenti generici provoca un comportamento indefinito. L’esempio controlla i tipi con _Generic e calcola una radice quadrata.

Esempi

#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;
}

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti