System.SysUtils.WideFormatBuf

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

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

C++

extern DELPHI_PACKAGE unsigned __fastcall WideFormatBuf(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

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

Cette fonction définit le format d'une série d'arguments du tableau Args. Le formatage est contrôlé par la chaîne de format Unicode Format (dont la taille est FmtLen) ; le résultat est renvoyé dans Buffer (dont la taille est BufLen). La fonction renvoie le nombre de caractères Unicode dans la chaîne formatée.

Remarque :  Les deux tampons contiennent des caractères étendus (Unicode). BufLen et FmtLen doivent indiquer le nombre de caractères Unicode dans leur tampon respectif, pas le nombre d'octets.

Pour plus d'informations sur les chaînes de format, voir Chaînes de Format.

La première forme de WideFormatBuf n'est pas adaptée aux threads car elle utilise les informations de localisation contenues dans les variables globales. La seconde forme de WideFormatBuf, 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 WideFormatBuf, vous devez placer les informations de localisation dans AFormatSettings. Pour placer un ensemble de valeurs locales par défaut dans AFormatSettings, appelez TFormatSettings.Create.