System.Utf8ToUnicode

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function Utf8ToUnicode(Dest: PWideChar; Source: _PAnsiChr; MaxChars: Integer): Integer;
function Utf8ToUnicode(Dest: PWideChar; MaxDestChars: Cardinal; Source: _PAnsiChr; SourceBytes: Cardinal): Cardinal;

C++

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

Eigenschaften

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


Beschreibung

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

Rufen Sie Utf8ToUnicode auf, um einen UTF-8-String in Unicode zu konvertieren.  Verwenden Sie die zweite Syntax.  Die veraltete Syntax ist nur aus Gründen der Abwärtskompatibilität enthalten. 
Dest erhält das resultierende null-terminierte Array mit Unicode-Zeichen.
MaxDestChars oder MaxChars gibt die maximale Anzahl der Unicode-Zeichen an, die der von Dest angegebene Puffer speichern kann, wobei der Null-Begrenzer mitgezählt wird. 
Source ist ein Array mit UTF-8-Zeichen.
SourceBytes ist die Anzahl der Bytes in Source.  Wenn SourceBytes nicht angegeben ist, muss Source null-terminiert sein.


Utf8ToUnicode gibt die Anzahl der Zeichen zurück, die in Dest geschrieben werden, einschließlich des Null-Begrenzers.

Im Fehlerfall gibt die Variante Utf8ToUnicode ...  : Cardinal Cardinal(-1) == $FFFFFFFF zurück, während Utf8ToUnicode ...  : Integer -1 zurückgibt.

Siehe auch