SGN

Syntaxe

Paramètres

Retour

Description

Cette fonction retourne le signe d'une valeur numérique.

Algorithme

Remarques

• La fonction détermine le signe d'une valeur numérique : La fonction Sgn permet d'indiquer si un nombre est négatif, nul ou positif. Elle ne retourne jamais la valeur d'origine, mais uniquement une indication sur son signe. Cette fonction est très utile pour effectuer rapidement des tests sur des valeurs numériques.
• Le résultat est toujours limité à trois valeurs possibles : Sgn retourne -1 lorsque le nombre est négatif, 0 lorsqu'il est égal à zéro et 1 lorsqu'il est positif. Il n'existe aucun autre résultat possible. Cette simplicité facilite son utilisation dans les structures conditionnelles et les expressions mathématiques.
• Elle accepte différents types numériques : Le paramètre peut être un entier, un nombre réel, une valeur monétaire ou toute expression numérique pouvant être évaluée par Access. Quel que soit le type utilisé, Sgn applique toujours la même logique de comparaison. Cette compatibilité permet de l'utiliser dans de nombreuses situations.
• Elle est utile pour simplifier les tests conditionnels : Plutôt que d'écrire plusieurs comparaisons comme If x < 0, If x = 0 et If x > 0, il est possible d'utiliser directement Sgn. Le résultat obtenu peut être testé avec une seule instruction. Cette approche rend le code plus compact et plus lisible.
• Elle est souvent utilisée dans les calculs mathématiques : Certaines formules nécessitent de connaître uniquement le signe d'une valeur sans tenir compte de sa grandeur. Sgn permet alors de déterminer rapidement le sens d'une variation, d'un déplacement ou d'un écart. Elle est également utilisée dans certains algorithmes numériques et scientifiques.
• Elle est complémentaire de la fonction Abs : Alors que Abs retourne toujours la valeur absolue d'un nombre, Sgn indique uniquement si ce nombre est positif, négatif ou nul. Les deux fonctions sont fréquemment utilisées ensemble lorsque l'on souhaite séparer le signe de la valeur numérique. Cette combinaison simplifie certains traitements mathématiques.
• Elle est disponible dans les requêtes et dans le code VBA : La fonction Sgn peut être utilisée dans les requêtes SQL, les formulaires, les états, les macros ainsi que dans les modules VBA. Elle permet d'évaluer directement le signe d'une expression dans une formule Access. Son comportement reste identique dans tous les contextes d'utilisation.
• Elle ne modifie jamais la valeur d'origine : Sgn retourne uniquement une information sur le signe de l'expression évaluée. Le nombre passé en paramètre n'est jamais modifié ni converti. Si la valeur d'origine doit être conservée, elle reste disponible après l'appel de la fonction.
• Elle peut être utilisée pour orienter un traitement : Dans certaines applications, le résultat de Sgn permet de déterminer automatiquement l'action à entreprendre selon que la valeur est positive, négative ou nulle. Par exemple, un programme peut appliquer une correction différente selon le sens d'un déplacement ou d'une variation. Cette approche simplifie l'écriture des algorithmes.
• La fonction est compatible avec toutes les versions modernes de Microsoft Access : La fonction Sgn est disponible depuis les premières versions de Microsoft Access intégrant VBA et son fonctionnement est demeuré stable au fil des années. Elle est compatible avec Access 2000, Access XP, Access 2003, Access 2007, Access 2010, Access 2013, Access 2016 ainsi qu'avec Microsoft 365. Cette stabilité garantit que les applications utilisant cette fonction continueront de produire les mêmes résultats lors des migrations vers des versions plus récentes d'Access.

Exemple

Voici un exemple de comment utiliser la fonction Sgn dans Microsoft Access :

Exemple de code VBA

La fonction Sgn peut être utilisée dans le code VBA de Microsoft Access.

Par exemple :

Dans cet exemple, la variable appelée LResult contiendrait désormais la valeur 1.