System.AnsiStrings.FormatBuf

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function FormatBuf(var Buffer; BufLen: Cardinal; const Format; FmtLen: Cardinal; const Args: array of const): Cardinal;
function FormatBuf(var Buffer; BufLen: Cardinal; const Format; FmtLen: Cardinal; const Args: array of const; const AFormatSettings: TFormatSettings): Cardinal;

C++

extern DELPHI_PACKAGE unsigned __fastcall FormatBuf(void *Buffer, unsigned BufLen, const void *Format, unsigned FmtLen, System::TVarRec const *Args, const int Args_High)/* overload */;

Eigenschaften

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

Beschreibung

Formatiert die in einem Array übergebenen Argumente und schreibt das Ergebnis in einen Puffer.

Die Funktion formatiert die Argumente in dem angegebenen offenen Array in einen Textpuffer.

Buffer ist der Textpuffer, der die Ergebnisse aufnimmt.

BufLen ist die Anzahl der Byte in Buffer.

Format ist der Format-String, der festlegt, wie die Argumente formatiert werden soll. Weitere Informationen zu den verschiedenen Formatierungsmöglichkeiten finden Sie unter Format-Strings.

FmtLen ist die Anzahl der Byte in Format.

Args sind die Argumente, die die Formatbezeichner in Format ersetzen.

Anmerkung: Args_Size ist der Index des letzten Eintrags in Args (der Wert ist um eins kleiner als die Anzahl der Argumente).

FormatBuf gibt die Länge in Byte des Ergebnis-Strings zurück.

Die erste Form von FormatBuf ist nicht Thread-sicher, da die landesspezifischen Informationen der globalen Variablen verwendet werden. Der Thread-sicheren zweiten Form werden die landesspezifischen Informationen im Parameter AFormatSettings übergeben. Bevor Sie diese Form von FormatBuf aufrufen, müssen Sie die Informationen in den Parameter AFormatSettings schreiben. Die landesspezifischen Standardinformationen können AFormatSettings mit TFormatSettings.Create zugewiesen werden.

Siehe auch