System.Classes.BinToHex

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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::DynamicArray<System::Byte> Buffer, int BufOffset, System::DynamicArray<System::Byte> &Text, int TextOffset, int Count)/* overload */;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
 public
System.Classes.pas
System.Classes.hpp
 System.Classes System.Classes

Beschreibung

Konvertiert einen binären Wert in einen String mit der hexadezimalen Entsprechung.

Mit BinToHex können Sie den Binärwert Buffer in einen String konvertieren, der den Hexadezimalwert darstellt.

Diese Prozedur erhält die folgenden Parameter:

Parameter Beschreibung

Buffer

Zeiger auf ein Byte-Array.

Zum Beispiel: 00011101 11101100 10101111.

BufOffset
(optional)

Anzahl der Bytes, die am Anfang des Eingabe-Byte-Arrays übersprungen werden sollen.

Wenn Buffer beispielsweise 00011101 11101100 10101111 und BufOffset 2 ist, wird nur 00011101 11101100 in einen hexadezimalen Wert konvertiert.

Text

Zeiger auf den String, der den Wert der Eingabe-Bytes als String mit hexadezimalen Zeichen erhält.

Beispielsweise würde für die Eingabe-Bytes 00011101 11101100 10101111 der Ausgabe-String "1decaf" lauten.

Hinweise:

TextOffset
(optional)

Anzahl der Zeichen, die am Anfang des Eingabe-Strings übersprungen werden sollen.

Wenn zum Beispiel Text vor dem Aufruf von BinToHex "608da975" enthält und TextOffset 4 ist, beginnt BinToHex mit dem Schreiben des Ausgabewertes ab dem fünften Zeichen, und die ersten 4 Zeichen ("608d") bleiben unverändert.

BufSize oder
Count

Anzahl der Bytes (Paare von hexadezimalen Zeichen) aus dem Eingabe-Byte-Array, die in den Ausgabe-String konvertiert werden sollen.

Hinweis: Dieser Wert muss gleich oder kleiner als die Länge des Eingabe-Byte-Arrays sowie gleich oder kleiner als die halbe Länge des Eingabe-Strings sein. Zum Beispiel:
  • Wenn das Eingabe-Array 8 Byte lang ist, muss dieser Wert 8 oder kleiner sein.
  • Wenn der Ausgabe-String 8 Zeichen lang ist, muss dieser Wert 4 oder kleiner sein.
  • Wenn das Eingabe-Array 8 Byte und der Ausgabe-String 8 Zeichen lang ist, muss diese Zahl 4 oder kleiner sein (wegen der Stringlänge).

Sie können BinToHex mit oder ohne Angabe eines Offsets für den Eingabe-String (TextOffset) oder den Ausgabepuffer (BufOffset) aufrufen. Sie müssen jedoch entweder beide Offsets oder keinen angeben.

Siehe auch

Codebeispiele

Abgerufen von „https://docwiki.embarcadero.com/Libraries/Alexandria/d/index.php?title=System.Classes.BinToHex&oldid=706305“