Partilhar via


CStringT::Format

Grava dados para um formatadosCStringT da mesma maneira que sprintf formata dados em uma matriz de caractere de estilo C.

void __cdecl Format(
   UINT nFormatID,
   [, argument]...
);
void __cdecl Format(
   PCXSTR pszFormat,
   [, argument]...
);

Parâmetros

  • nFormatID
    O identificador de recurso de seqüência de caracteres que contém a seqüência de caracteres de controle de formato.

  • pszFormat
    Uma seqüência de caracteres de controle de formato.

  • argument
    Argumentos opcionais.

Comentários

Essa função formata e armazena uma seqüência de caracteres e valores no CStringT. Cada argumento opcional (se houver) é convertido e saído de acordo com a especificação de formato correspondente em pszFormat ou da seqüência de caracteres do recurso identificado por nFormatID.

A telefonar falhará se o próprio objeto de seqüência de caracteres é oferecido sistema autônomo um parâmetro para Format. Por exemplo, o código a seguir causará resultados imprevisíveis:

CAtlString str = _T("Some Data");
str.Format(_T("%s%d"), str, 123);   
// Attention: str is also used in the parameter list.   

Para obter mais informações, consulte Campos de especificação de Formatarar: Funções printf e wprintf e sprintf _sprintf_l swprintf, _swprintf_l, __swprintf_l.

Exemplo

// typedef CStringT<TCHAR, StrTraitATL<TCHAR, ChTraitsCRT<TCHAR>>> CAtlString;
CAtlString str;

str.Format(_T("Floating point: %.2f\n"), 12345.12345);
_tprintf_s(_T("%s"), (LPCTSTR) str);

str.Format(_T("Left-justified integer: %.6d\n"), 35);
_tprintf_s(_T("%s"), (LPCTSTR) str);

Requisitos

Cabeçalho: cstringt.h

Consulte também

Referência

Classe CStringT

Outros recursos

CStringT membros