Fonctions numériques

Le tableau suivant décrit les fonctions numériques incluses dans le jeu de fonctions scalaires ODBC. En appelant SQLGetInfo avec un type d’informations de SQL_NUMERIC_FUNCTIONS, une application peut déterminer les fonctions numériques prises en charge par un pilote.

Toutes les fonctions numériques retournent des valeurs de type de données SQL_FLOAT à l’exception de ABS, ROUND, TRUNCATE, SIGN, FLOOR et CEILING, qui retournent les valeurs du même type de données que les paramètres d’entrée.

Les arguments indiqués comme numeric_exp peuvent être le nom d’une colonne, le résultat d’une autre fonction scalaire ou d’un litre numériquel, où le type de données sous-jacent peut être représenté en tant que SQL_NUMERIC, SQL_DECIMAL, SQL_TINYINT, SQL_SMALLINT, SQL_INTEGER, SQL_BIGINT, SQL_FLOAT, SQL_REAL ou SQL_DOUBLE.

Les arguments indiqués comme float_exp peuvent être le nom d’une colonne, le résultat d’une autre fonction scalaire ou d’un littéral numérique, où le type de données sous-jacent peut être représenté en tant que SQL_FLOAT.

Les arguments indiqués comme integer_exp peuvent être le nom d’une colonne, le résultat d’une autre fonction scalaire ou d’un littéral numérique, où le type de données sous-jacent peut être représenté en tant que SQL_TINYINT, SQL_SMALLINT, SQL_INTEGER ou SQL_BIGINT.

Les fonctions scalaires CURRENT_DATE, CURRENT_TIME et CURRENT_TIMESTAMP ont été ajoutées dans ODBC 3.0 pour s’aligner sur SQL-92.

Fonction	Description
ABS( numeric_exp ) (ODBC 1.0)	Retourne la valeur absolue de numeric_exp.
ACOS( float_exp ) (ODBC 1.0)	Retourne l’arccosine de float_exp sous forme d’angle, exprimée en radians.
ASIN( float_exp ) (ODBC 1.0)	Retourne l’arcsin de float_exp sous forme d’angle, exprimé en radians.
ATAN( float_exp ) (ODBC 1.0)	Retourne l’arctangente de float_exp sous forme d’angle, exprimée en radians.
ATAN2( float_exp1, float_exp2) (ODBC 2.0)	Retourne l’arctangente des coordonnées x et y , spécifiées par float_exp1 et float_exp2, respectivement, sous forme d’angle, exprimées en radians.
CEILING( numeric_exp ) (ODBC 1.0)	Retourne le plus petit entier supérieur ou égal à numeric_exp. La valeur de retour est du même type de données que le paramètre d’entrée.
COS( float_exp ) (ODBC 1.0)	Retourne le cosinus de float_exp, où float_exp est un angle exprimé en radians.
COT( float_exp ) (ODBC 1.0)	Retourne la cotangente de float_exp, où float_exp est un angle exprimé en radians.
DEGREES( numeric_exp ) (ODBC 2.0)	Retourne le nombre de degrés convertis à partir de numeric_exp radians.
EXP( float_exp ) (ODBC 1.0)	Retourne la valeur exponentielle de float_exp.
FLOOR( numeric_exp ) (ODBC 1.0)	Retourne le plus grand entier inférieur ou égal à numeric_exp. La valeur de retour est du même type de données que le paramètre d’entrée.
LOG( float_exp ) (ODBC 1.0)	Retourne le logarithme naturel de float_exp.
LOG10( float_exp ) (ODBC 2.0)	Retourne le logarithme de base 10 de float_exp.
MOD( integer_exp1, integer_exp2) (ODBC 1.0)	Retourne le reste (module) de integer_exp1 divisé par integer_exp2.
PI( ) (ODBC 1.0)	Retourne la valeur constante de pi comme valeur à virgule flottante.
POWER( numeric_exp, integer_exp) (ODBC 2.0)	Retourne la valeur de numeric_exp à la puissance de integer_exp.
RADIANS( numeric_exp ) (ODBC 2.0)	Retourne le nombre de radians convertis à partir de numeric_exp degrés.
RAND([integer_exp]) (ODBC 1.0)	Retourne une valeur à virgule flottante aléatoire à l’aide de integer_exp comme valeur initiale facultative.
ROUND( numeric_exp, integer_exp) (ODBC 2.0)	Retourne numeric_exp arrondi à integer_exp place à droite de la virgule décimale. Si integer_exp est négative, numeric_exp est arrondi à |integer_exp| place à gauche du point décimal.
SIGN( numeric_exp ) (ODBC 1.0)	Retourne un indicateur du signe de numeric_exp. Si numeric_exp est inférieur à zéro, -1 est retourné. Si numeric_exp est égal à zéro, 0 est retourné. Si numeric_exp est supérieur à zéro, 1 est retourné.
SIN( float_exp ) (ODBC 1.0)	Retourne le sinus de float_exp, où float_exp est un angle exprimé en radians.
SQRT( float_exp ) (ODBC 1.0)	Retourne la racine carrée de float_exp.
TAN( float_exp ) (ODBC 1.0)	Retourne la tangente de float_exp, où float_exp est un angle exprimé en radians.
TRUNCATE( numeric_exp, integer_exp) (ODBC 2.0)	Retourne numeric_exp tronqué à integer_exp place à droite de la virgule décimale. Si integer_exp est négative, numeric_exp est tronquée à |integer_exp| place à gauche du point décimal.