System.SysUtils.FormatBuf

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function FormatBuf(var Buffer; BufLen: Cardinal; const Format; FmtLen: Cardinal; const Args: array of const): Cardinal;
function FormatBuf(Buffer: PWideChar; BufLen: Cardinal; const Format; FmtLen: Cardinal; const Args: array of const): Cardinal;
function FormatBuf(Buffer: PWideChar; BufLen: Cardinal; const Format; FmtLen: Cardinal; const Args: array of const; const AFormatSettings: TFormatSettings): Cardinal;
function FormatBuf(var Buffer: UnicodeString; BufLen: Cardinal; const Format; FmtLen: Cardinal; const Args: array of const): Cardinal;
function FormatBuf(var Buffer: UnicodeString; BufLen: Cardinal; const Format; FmtLen: Cardinal; const Args: array of const; const AFormatSettings: TFormatSettings): 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 _DEPRECATED_ATTRIBUTE1("Moved to the AnsiStrings unit") (void *Buffer, unsigned BufLen, const void *Format, unsigned FmtLen, const System::TVarRec *Args, const int Args_High)/* overload */;

Propriétés

Type Visibilité  Source Unité  Parent
function public
System.SysUtils.pas
System.SysUtils.hpp
System.SysUtils System.SysUtils


Description

Avertissement : La version ANSI de FormatBuf est obsolète. Veuillez utiliser l’unité AnsiStrings.

Formate les arguments depuis un tableau et place le résultat dans un tampon.

Cette fonction formate la série d'arguments du tableau ouvert spécifié dans un tampon de texte.

Buffer est le tampon de texte qui reçoit les résultats.

BufLen représente le nombre de caractères dans Buffer.

Format représente la chaîne de format qui détermine comment formater les arguments. Pour plus d'informations sur les chaînes de format, voir chaînes de format.

FmtLen représente le nombre de caractères dans la fonction Format.

Args représente les arguments qui remplacent les spécificateurs dans la fonction Format.

Remarque : Args_Size représente les arguments qui remplacent les spécificateurs de Args (nombre d'arguments moins un).

La fonction FormatBuf renvoie le nombre de caractères stockés dans Buffer.

La première forme de FormatBuf n'est pas adaptée aux threads car elle utilise les informations de localisation contenues dans les variables globales. La seconde forme de FormatBuf, qui est adaptée aux threads, fait référence aux informations de localisation contenues dans le paramètre AFormatSettings. Avant d'appeler la forme adaptée aux threads de FormatBuf, vous devez placer les informations de localisation dans AFormatSettings. Pour placer un ensemble de valeurs locales par défaut dans AFormatSettings, appelez TFormatSettings.Create.

Voir aussi