System.UnicodeToUtf8

提供: RAD Studio API Documentation
移動先: 案内検索

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 */;

プロパティ

種類 可視性 ソース ユニット
function public
System.pas
System.hpp
System System


説明

Unicode 文字からなる文字列を、UTF-8 文字列に変換します。

UnicodeToUtf8 を呼び出すと、Unicode 文字列を、null 終端の UTF-8 文字列のシーケンスに変換します。2 番目の構文を使用してください。非推奨の構文は下位互換性のためにのみ用意されています。

Dest 変換結果のヌル終端 UTF-8 文字配列を受け取ります。

MaxDestBytes または MaxBytes は、Dest で指定されたバッファに格納できるバイト数(null 終端文字のバイト数を含む)を示します。

Source は、Unicode 文字の配列です。

SourceChars は、Source 内の文字数です。SourceChars が指定されない場合、Source は null 終端でなければなりません。

UnicodeToUtf8 は、Dest に書き込まれたバイト数を返します。

変換に失敗した場合、 UnicodeToUtf8 は 0 を返します。

メモ: UnicodeToUtf8 が失敗する一般的な理由の 1 つは、対象バッファに十分なメモリがないことです。このシナリオでは、UnicodeToUtf8 は 0 を返し、対象バッファに部分文字列が保持されます。

関連項目


コード例