System.SysUtils.WideFmtStr

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

procedure WideFmtStr(var Result: WideString; const Format: WideString; const Args: array of const); overload;
procedure WideFmtStr(var Result: WideString; const Format: WideString; const Args: array of const; const AFormatSettings: TFormatSettings); overload;

C++

extern DELPHI_PACKAGE void __fastcall WideFmtStr(System::WideString &Result, const System::WideString Format, const System::TVarRec *Args, const int Args_High)/* overload */;

Properties

Type Visibility Source Unit Parent
procedure
function
public
System.SysUtils.pas
System.SysUtils.hpp
System.SysUtils System.SysUtils

Description

Assembles a formatted Unicode string using a format string and an array of arguments.

This function formats the series of arguments in the open array Args into a Unicode string. Formatting is controlled by the format string Format; the results are returned in the Result parameter.

For information on the format strings, see Format strings.

The first form of WideFmtStr is not thread-safe, because it uses localization information contained in global variables. The second form of WideFmtStr, which is thread-safe, refers to localization information contained in the AFormatSettings parameter. Before calling the thread-safe form of WideFmtStr, you must populate AFormatSettings with localization information. To populate AFormatSettings with a set of default locale values, call TFormatSettings.Create.

See Also