UnicodeString::cat_sprintf Method

Appends result of given format string and its arguments to end of System::UnicodeString.

Pascal

function cat_sprintf(const format: wchar_t*; : ...): UnicodeString&; cdecl;

C++

__cdecl UnicodeString& cat_sprintf(const wchar_t* format, ...);

Description

Use System::UnicodeString::cat_sprintf to append to the value of the System::UnicodeString object, given a standard C++ format specifier. Pass the values to any arguments in the format specifier as additional parameters following the format parameter.

For example, the following code

Copy Code

UnicodeString Salutation = "Mr."
UnicodeString s = "";
s.cat_sprintf("Dear %s ", Salutation);
s.cat_sprintf("%s,", "Smith");

results in an System::UnicodeString object with the value

Copy Code

Dear Mr. Smith,

This method returns a reference to the System::UnicodeString object (*this) with the resulting value.