System.AnsiStrings.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(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, const System::TVarRec *Args, const int Args_High)/* overload */;

Propriétés

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

Description

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 d'octets 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 d'octets de Format.

Args représente les arguments qui remplacent les spécificateurs de Format.

Remarque :  Args_Size est l'indice du dernier élément de Args (nombre d'arguments moins un).

La fonction FormatBuf renvoie la taille en octets de la chaîne résultante.

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