System.UnicodeToUtf8

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function UnicodeToUtf8(Dest: _PAnsiChr; Source: PWideChar; MaxBytes: Integer): Integer;
function UnicodeToUtf8(Dest: _PAnsiChr; MaxDestBytes: Cardinal; Source: PWideChar; SourceChars: Cardinal): Cardinal;

C++

extern DELPHI_PACKAGE int __fastcall UnicodeToUtf8 _DEPRECATED_ATTRIBUTE0 (char * Dest, WideChar * Source, int MaxBytes)/* overload */;

Eigenschaften

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


Beschreibung

Konvertiert einen String mit Unicode-Zeichen in einen UTF-8-String.

Mit UnicodeToUtf8 wandeln Sie einen Unicode-String in eine nullterminierte Folge von UTF-8-Zeichen um. Verwenden Sie die zweite Syntax. Die veraltete Syntax ist nur aus Gründen der Abwärtskompatibilität enthalten.

Dest nimmt das resultierende nullterminierte Array mit UTF-8-Zeichen auf.

MaxDestBytes oder MaxBytes gibt die Anzahl der Bytes zurück, die im mit Dest angegebenen Puffer verfügbar sind, einschließlich des Bytes für den Null-Begrenzer.

Source ist ein Array mit Unicode-Zeichen.

SourceChars ist die Anzahl der Zeichen in Source. Wurde SourceChars nicht angegeben, muss Source nullterminiert sein.

UnicodeToUtf8 gibt die Anzahl der Bytes an, die in Dest geschrieben wurden.

Wenn die Umwandlung fehlschlägt, gibt UnicodeToUtf8 0 zurück.

Hinweis: Ein häufiger Grund für das Fehlschlagen von UnicodeToUtf8 ist, dass der Zielpuffer nicht über ausreichend Arbeitsspeicher verfügt. In diesem Szenario gibt UnicodeToUtf8 0 zurück und der Zielpuffer enthält einen Teilstring.

Siehe auch


Codebeispiele