System.Classes.BinToHex

• Aller au parent : System.Classes

Delphi

procedure BinToHex(const Buffer: TBytes; BufOffset: Integer;
var Text: TBytes; TextOffset: Integer; Count: Integer);
procedure BinToHex(Buffer: Pointer; Text: PWideChar; BufSize: Integer);
procedure BinToHex(const Buffer; Text: PWideChar; BufSize: Integer);
procedure BinToHex(Buffer: PAnsiChar; Text: PAnsiChar; BufSize: Integer);
procedure BinToHex(Buffer: PAnsiChar; Text: PWideChar; BufSize: Integer);
procedure BinToHex(const Buffer; Text: PAnsiChar; BufSize: Integer);
procedure BinToHex(Buffer: Pointer; Text: PAnsiChar; BufSize: Integer);

C++

extern DELPHI_PACKAGE void __fastcall BinToHex(const System::Sysutils::TBytes Buffer, int BufOffset, System::Sysutils::TBytes &Text, int TextOffset, int Count)/* overload */;

Propriétés

Type	Visibilité	Source	Unité	Parent
procedure function	public	System.Classes.pas System.Classes.hpp	System.Classes	System.Classes

Description

Convertit une valeur binaire en chaîne, ce qui correspond à sa représentation hexadécimale.

Appelez BinToHex pour convertir la valeur binaire Buffer en une chaîne qui est sa représentation hexadécimale.

Cette procédure reçoit les paramètres suivants :

Paramètre	Description
Buffer	Pointeur sur un tableau d'octets. Par exemple : 00011101 11101100 10101111.
BufOffset (facultatif)	Nombre d'octets à ignorer au début du tableau d'octets en entrée. Par exemple, si Buffer vaut 00011101 11101100 10101111 et que BufOffset vaut 2, seul 00011101 11101100 est converti en hexadécimal.
Text	Pointeur sur la chaîne qui recevra la valeur des octets en entrée sous la forme d'une chaîne de caractères hexadécimaux. Par exemple, pour les octets en entrée 00011101 11101100 10101111, la chaîne en sortie serait "1decaf". Remarques : Le nombre hexadécimal en sortie est en caractères majuscules. BinToHex écrit la chaîne de sortie sous la forme d'une chaîne terminée par null.
TextOffset (facultatif)	Nombre de caractères à ignorer au début de la chaîne d'entrée. Par exemple, si Text vaut "608da975" avant que vous appeliez BinToHex et que TextOffset vaut 4, BinToHex commence l'écriture de la valeur de sortie sur le cinquième caractère, et les 4 premiers caractères ("608d") sont inchangés.
BufSize ou Count	Nombre d'octets (paires de caractères hexadécimaux) du tableau d'octets en entrée à convertir en chaîne de sortie. Remarque : Cette valeur doit être égale ou inférieure à la longueur du tableau d'octets en entrée ou à la moitié de la longueur de la chaîne d'entrée. Par exemple : Si le tableau d'entrée a une longueur de 8 octets, ce nombre doit être 8 ou être inférieur à 8. Si la chaîne de sortie a une longueur de 8 caractères, ce nombre doit être 4 ou être inférieur à 4. Si le tableau en entrée a une longueur de 8 octets, et que la chaîne en sortie a une longueur de 8 caractères, ce nombre doit être égal à 4 ou être inférieur (à cause de la longueur de la chaîne).

Vous pouvez appeler BinToHex en spécifiant ou en ne spécifiant pas le décalage utilisé pour la chaîne d'entrée (TextOffset) ou pour le tampon de sortie (BufOffset). Toutefois, vous devez spécifier les deux décalages ou n'en spécifier aucun.

Voir aussi

• HexToBin

• IntToHex

• Routines de conversion des types

Exemples de code

• BinHexMethods (C++)
• BinHexMethods (Delphi)
• HexEncoding (C++)
• HexEncoding (Delphi)