Share via


CStringT::Format

Escribe dio formato datos a CStringT de la misma manera que sprintf_s dé formato a los datos del c. diseña la matriz de caracteres.

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

Parámetros

  • nFormatID
    El identificador de recurso de cadena que contiene la cadena de la formato-CONTROL.

  • pszFormat
    una cadena de la formato-CONTROL.

  • argument
    argumentos opcionales.

Comentarios

Esta función da formato y almacena una serie de caracteres y valores en CStringT. Cada argumento opcional (si existe) se convierte y salida según la especificación correspondiente de formato en pszFormat o de recursos de cadena identificado por nFormatID.

La llamada producirá un error si el objeto string en sí se proporciona como parámetro a Format. Por ejemplo, el código siguiente genera resultados imprevisibles:

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

Para obtener más información, vea Sintaxis de especificación de formato: Funciones printf y wprintf.

Ejemplo

// 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

encabezado: cstringt.h

Vea también

Referencia

CStringT Class

sprintf_s, _sprintf_s_l, swprintf_s, _swprintf_s_l