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.

Mit Utf8ToUnicode konvertieren Sie einen UTF-8-String in Unicode. Verwenden Sie die zweite Syntax. Die veraltete Syntax ist nur aus Gründen der Abwärtskompatibilität enthalten.

Dest nimmt das sich ergebende nullterminierte Array aus Unicode-Zeichen auf.

MaxDestChars oder MaxChars gibt die maximale Anzahl der Unicode-Zeichen an, die der von Dest angegebene Puffer speichern kann, wobei der Null-Begrenzer nicht gezählt wird.

Source ist ein Array aus UTF-8-Zeichen.

SourceBytes ist die Anzahl der Bytes in Source. Wurde SourceBytes nicht angegeben, muss Source nullterminiert sein.

Utf8ToUnicode gibt die Anzahl der Zeichen an, die in Dest geschrieben werden.

Im Falle von Fehlern gibt Utf8ToUnicode bei Kardinalvarianten Cardinal(-1) == $FFFFFFFF und bei Integervarianten -1 zurück.

Siehe auch