Visual C++. Описание стандартных классов - Format

ОГЛАВЛЕНИЕ


Format

void Format(LPCTSTR lpszFormat, ...);
void Format(UINT nFormatID, ...);

Аргументы

  • lpszFormat - строка форматирования.
  • nFormatID - идентификатор строкового ресурса, содержащий строку форматирования.

Описание

Данная функция позволяет записать в объект класса CString форматированную строку аналогично тому, как это делает функция sprintf для символьных массивов. В результате выполнения данной функции в объекте класса CString сохраняется форматированная последовательность символов и значений величин. Каждый дополнительный аргумент, если он присутствует, преобразуется и выводится в соответствии со спецификациями формата, содержащимися в аргументе lpszFormat или в строковом ресурсе, определяемом идентификатором nFormatID. Функция аварийно завершит свою работу, если в качестве аргумента функции Format будет указана сама строка. Например, выполнение следующего программного кода приведет к непредсказуемым результатам:
CString str = "Some Data";
str.Format("%s%d", str, 345);
Если в качестве дополнительного аргумента передается строка символов, ее необходимо явным образом преобразовать к типу LPCTSTR. Строка форматирования имеет ту же форму и функцию, что и формат аргументов функции printf. В конец записанной строки символов добавляется нулевой символ.