System.SysUtils.TEncoding.GetBytes

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function GetBytes(Chars: PChar; CharCount: Integer; Bytes: PByte; ByteCount: Integer): Integer; overload; virtual; abstract;
function GetBytes(const Chars: Char): TBytes; overload; inline;
function GetBytes(const Chars: array of Char): TBytes; overload;
function GetBytes(const Chars: TCharArray): TBytes; overload;
function GetBytes(const Chars: array of Char; CharIndex, CharCount: Integer): TBytes; overload;
function GetBytes(const Chars: TCharArray; CharIndex, CharCount: Integer): TBytes; overload;
function GetBytes(const Chars: array of Char; CharIndex, CharCount: Integer;  const Bytes: TBytes; ByteIndex: Integer): Integer; overload;
function GetBytes(const Chars: TCharArray; CharIndex, CharCount: Integer;  const Bytes: TBytes; ByteIndex: Integer): Integer; overload;
function GetBytes(const S: string): TBytes; overload;
function GetBytes(const S: string; CharIndex, CharCount: Integer;  const Bytes: TBytes; ByteIndex: Integer): Integer; overload; inline;
function GetBytes(const S: string; CharIndex, CharCount: Integer;  const Bytes: TBytes; ByteIndex: Integer; const StringBaseIndex: Integer): Integer; overload; // new

C++

virtual int __fastcall GetBytes(System::WideChar * Chars, int CharCount, System::PByte Bytes, int ByteCount) = 0 /* overload */;
System::DynamicArray<System::Byte> __fastcall GetBytes(const System::WideChar Chars)/* overload */;
System::DynamicArray<System::Byte> __fastcall GetBytes(const System::WideChar *Chars, const int Chars_High)/* overload */;
System::DynamicArray<System::Byte> __fastcall GetBytes(const System::DynamicArray<System::WideChar> Chars)/* overload */;
System::DynamicArray<System::Byte> __fastcall GetBytes(const System::WideChar *Chars, const int Chars_High, int CharIndex, int CharCount)/* overload */;
System::DynamicArray<System::Byte> __fastcall GetBytes(const System::DynamicArray<System::WideChar> Chars, int CharIndex, int CharCount)/* overload */;
int __fastcall GetBytes(const System::WideChar *Chars, const int Chars_High, int CharIndex, int CharCount, const System::DynamicArray<System::Byte> Bytes, int ByteIndex)/* overload */;
int __fastcall GetBytes(const System::DynamicArray<System::WideChar> Chars, int CharIndex, int CharCount, const System::DynamicArray<System::Byte> Bytes, int ByteIndex)/* overload */;
System::DynamicArray<System::Byte> __fastcall GetBytes(const System::UnicodeString S)/* overload */;
int __fastcall GetBytes(const System::UnicodeString S, int CharIndex, int CharCount, const System::DynamicArray<System::Byte> Bytes, int ByteIndex)/* overload */;
int __fastcall GetBytes(const System::UnicodeString S, int CharIndex, int CharCount, const System::DynamicArray<System::Byte> Bytes, int ByteIndex, const int StringBaseIndex)/* overload */;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.SysUtils.pas
System.SysUtils.hpp
System.SysUtils TEncoding


Beschreibung

Codiert Zeichen aus dem angegebenen String oder den angegebenen Zeichen.

  • function GetBytes(Chars: PChar; CharCount: Integer; Bytes: PByte; ByteCount: Integer): Integer; overload; virtual; abstract;
Diese überladene Version ist eine abstrakte Methode in dieser Klasse. Die eigentliche Implementierung wird erst später in einer abgeleiteten Klasse durchgeführt.
  • function GetBytes(const Chars: Char): TBytes; overload;
Codiert Chars-Zeichen als Folge von Bytes und gibt diese zurück.
  • Chars: Ein UNICODE-Zeichen, das codiert werden soll.
Der Rückgabewert ist ein Byte-Array, das die Ergebnisse der Codierung der angegebenen Zeichenfolge enthält.
  • function GetBytes(const Chars: array of Char): TBytes; overload;
  • function GetBytes(const Chars: TCharArray): TBytes; overload;
Codiert die Zeichenfolge des Chars-Arrays als Folge von Bytes und gibt diese zurück.
  • Chars: char-Array, das die zu codierenden Zeichen enthält.
Der Rückgabewert ist ein Byte-Array, das die Ergebnisse der Codierung der angegebenen Zeichenfolge enthält.
  • function GetBytes(const Chars: array of Char; CharIndex, CharCount: Integer): TBytes; overload;
  • function GetBytes(const Chars: TCharArray; CharIndex, CharCount: Integer): TBytes; overload;
Codiert die Folge von CharCount Zeichen aus dem CharIndex des Chars-Arrays als Folge von Bytes und gibt diese zurück.
  • Chars: char-Array, das die zu codierenden Zeichen enthält.
  • CharIndex: Index des ersten im Chars-Array zu codierenden Zeichens.
  • CharCount: Parameter, der die Anzahl der zu codierenden Zeichen angibt.
Der Rückgabewert ist ein Byte-Array, das die Ergebnisse der Codierung der angegebenen Zeichenfolge enthält.
  • function GetBytes(const Chars: array of Char; CharIndex, CharCount: Integer; const Bytes: TBytes; ByteIndex: Integer): Integer; overload;
  • function GetBytes(const Chars: TCharArray; CharIndex, CharCount: Integer; const Bytes: TBytes; ByteIndex: Integer): Integer; overload;
Codiert die Folge von CharCount Zeichen aus CharIndex von Chars in Bytes als Folge von Bytes.
  • Chars: char-Array, das die zu codierenden Zeichen enthält.
  • CharIndex: Index des ersten im Chars-Array zu codierenden Zeichens.
  • CharCount: Parameter, der die Anzahl der zu codierenden Zeichen angibt.
  • Bytes: Byte-Array, das die resultierende Folge von Bytes enthält. Gibt die Position an, an der die Folge der Bytes erfasst wird.
Der Rückgabewert ist die tatsächliche Anzahl der Bytes, die in Bytes geschrieben wurden.
  • function GetBytes(const S: string): TBytes; overload;
Codiert den String S als Folge von Bytes und gibt diese zurück.
  • S: String, der die zu codierenden Zeichen enthält.
Der Rückgabewert ist ein Byte-Array, das die Ergebnisse der Codierung des angegebenen Strings enthält.
  • function GetBytes(const S: string; CharIndex, CharCount: Integer; const Bytes: TBytes; ByteIndex: Integer): Integer; overload;
Codiert CharCount Zeichen am Index CharIndex des Strings S in das Array Bytes mit dem Offset ByteIndex als Folge von Bytes. CharIndex ist auf Desktop-Plattformen, wie Windows, Mac OS X und Linux, eins-basiert und auf mobilen Plattformen, wie iOS und Android, nullbasiert.
  • S: String, der die zu codierenden Zeichen enthält.
  • CharIndex: Index des ersten zu codierenden Zeichens. Auf Desktop-Plattformen, wie Windows, Mac OS X und Linux, ist CharIndex eins-basiert. Auf mobilen Plattformen, wie iOS und Android, ist CharIndex nullbasiert.
  • CharCount: Parameter, der die Anzahl der zu codierenden Zeichen angibt.
  • Bytes: Byte-Array, das die resultierende Folge von Bytes enthält. Gibt die Position an, an der die Folge der Bytes erfasst wird.
  • ByteIndex: Index, ab dem die resultierende Folge von Bytes erfasst wird.
Der Rückgabewert ist die tatsächliche Anzahl der Bytes, die in Bytes geschrieben wurden.
  • function GetBytes(const S: string; CharIndex, CharCount: Integer; const Bytes: TBytes; ByteIndex: Integer; const StringBaseIndex: Integer): Integer; overload;
Codiert CharCount Zeichen am Index CharIndex des Strings S in das Array Bytes mit dem Offset ByteIndex als Folge von Bytes. StringBaseIndex ist die Zahl der Indexbasis; 0 oder 1 des CharIndex von String S.
  • S: String, der die zu codierenden Zeichen enthält.
  • CharIndex: Index des ersten zu codierenden Zeichens. Die Indexbasis wird von StringBaseIndex gesteuert.
  • CharCount: Parameter, der die Anzahl der zu codierenden Zeichen angibt.
  • Bytes: Byte-Array, das die resultierende Folge von Bytes enthält. Gibt die Position an, an der die Folge der Bytes erfasst wird.
  • ByteIndex: Index, ab dem die resultierende Folge von Bytes erfasst wird.
  • StringBaseIndex: Zahl der Indexbasis von CharIndex für den String S. Dieser Wert ist 0 oder 1. Wenn eine andere Zahl angegeben ist, wird die Exception EEncodingError ausgelöst.
Der Rückgabewert ist die tatsächliche Anzahl der Bytes, die in Bytes geschrieben wurden.


Siehe auch


Codebeispiele