Partager via

Fonctions Dec2Hex et Hex2Dec

  • Article

S’applique à : Applications canevas Dataverse plug-ins low-code Flux de bureau Applications pilotées par modèle Power Pages Power Platform CLI

Conversion entre des chaînes de texte hexadécimales et des nombres.

Description

Utilisez la fonction Dec2Hex pour convertir un nombre en chaîne de texte hexadécimale. Dec2Hex émet les caractères 0 à 9 et les caractères majuscules A à F ; utilisez la fonction Lower pour convertir le résultat en minuscules si vous le souhaitez. Dec2Hex tronque le nombre saisi en nombre entier comme si la fonction Trunc avait été appliquée en premier. Utilisez Places pour compléter un nombre positif avec des 0 (zéros) non significatifs et limiter la longueur du résultat ; Places est ignoré si l’entrée est négative.

Utilisez la fonction Hex2Dec pour convertir une chaîne de texte contenant des chiffres hexadécimaux (0 à 9 et A à F) en nombre. Les caractères majuscules et minuscules sont acceptés. Un maximum de 10 caractères hexadécimaux peuvent être transmis à Hex2Dec.

Ces deux fonctions fonctionnent avec un nombre entier de 40 bits, en complément de deux. La plage de valeurs acceptées pour les deux fonctions va du nombre hexadécimal 8000000000 ou du nombre décimal -549755813888 au nombre hexadécimal 7FFFFFFFFF ou au nombre décimal 549755813887.

Si vous transmettez un nombre unique ou une chaîne de texte à ces fonctions, la valeur renvoyée est un résultat unique. Si vous transmettez une table à une seule colonne, la valeur renvoyée est une table de résultats à une seule colonne, avec un résultat pour chaque enregistrement dans la table de l’argument. Si vous avez une table à plusieurs colonnes, vous pouvez la convertir en table à une seule colonne, comme Utilisation des tables le décrit.

Si la valeur d’entrée est en dehors de la plage ou inclut des caractères hexadécimaux non valides, une erreur ErrorKind.Numeric est renvoyée. Si l’entrée était une table à une seule colonne, l’erreur est intégrée dans la table de sortie.

Syntaxe

Dec2Hex( Number [, Places] )

  • Number : obligatoire. Nombre à convertir en hexadécimal.
  • Places : facultatif. Nombre de caractères à utiliser si le nombre est positif. Si Places est omis, Dec2Hex utilise le nombre minimal de caractères nécessaires. Si ce paramètre est fourni et que le résultat ne rentre pas dans l’espace fourni, une erreur ErrorKind.Numeric est renvoyée. Places est ignoré si le nombre à convertir est négatif.

Hex2Dec( HexString )

  • HexString : obligatoire. Chaîne de chiffres hexadécimaux à convertir en nombre.

Exemples

Utilisation de base de Hex2Dec

Formule Résultat
Hex2Dec( "A5" ) 165
Hex2Dec( "FFFFFFFF5B") -165
Hex2Dec( "c8d" ) 3213
Hex2Dec( "fffffff373" ) -3213
Hex2Dec( "ffffffffff" ) -1
Hex2Dec( "ffffffffffff" ) error (out of range)
Hex2Dec( "43j" ) error (invalid hexadecimal character)
Hex2Dec( [ "A", "12", "FFFF" ] ) [ 10, 18, 65535 ]
Hex2Dec( [ "3", "E", "I", "B" ] ) [ 3, 14, error (invalid hexadecimal character), 11 ]

Utilisation de base de Dec2Hex

Formule Résultat
Dec2Hex( 165 ) "A5"
Dec2Hex( -165 ) "FFFFFFFF5B"
Dec2Hex( 3213 ) "c8d"
Dec2Hex( -3213 ) "FFFFFFF373"
Dec2Hex( -1 ) "FFFFFFFFFF"
Dec2Hex( 3.74 ) "3"
Dec2Hex( -3.74 ) "FFFFFFFFFD"
Dec2Hex( [ 10, 255, -16 ] ) [ "A", "FF", "FFFFFFFFF0" ]
Dec2Hex( 1e45 ) error (out of range)
Dec2Hex( [ 1, 1e-45, 1e45, 2 ] ) [ "1", "0", error (out of range), "2" ]

Utilisation de base de Dec2Hex avec l’argument Places

Formule Résultat
Dec2Hex( 45780 ) "B2D4"
Dec2Hex( 45780, 4 ) "B2D4"
Dec2Hex( 45780, 5 ) "0B2D4"
Dec2Hex( 45780, 6 ) "00B2D4"
Dec2Hex( 45780, 3 ) error (not enough space)
Dec2Hex( 45780, 11 ) error (out of range)
Dec2Hex( -45780 ) "FFFFFF4D2C"
Dec2Hex( -45780, 4 ) "FFFFFF4D2C"
Dec2Hex( -45780, 6 ) "FFFFFF4D2C"
Dec2Hex( -45780, 10 ) "FFFFFF4D2C"
Dec2Hex( -45780, 11 ) error (out of range)

Utilisation de base de Dec2Hex avec des tables à une seule colonne et un argument Places

Formule Résultat
Dec2Hex( [ 10, 255, -16 ], [ 1, 2, 3 ] ) [ "A", "FF", "FFFFFFFFF0" ]
Dec2Hex( [ 10, 255, -16 ], 4 ) [ "000A", "00FF", "FFFFFFFFF0" ]
Dec2Hex( 255, [0, 1, 2, 3] ) [ error (not enough space), error (not enough space), "FF", "0FF" ]