Partager via


CStringT::Format

Écrit aux données mises en forme à CStringT de la même façon les données de formats de sprintf_s dans le tableau de style c.

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

Paramètres

  • nFormatID
    L'identificateur de ressource de type chaîne contenant la chaîne de format.

  • pszFormat
    Une chaîne de format.

  • argument
    Arguments facultatifs.

Notes

Cette fonction met en forme et stocke un ensemble de caractères et des valeurs dans CStringT.Chaque argument facultatif (le cas échéant) est converti et de sortie en fonction de la spécification du format correspondante dans pszFormat ou de la ressource de type chaîne reconnue par nFormatID.

L'appel échoue si l'objet String lui-même est offert comme paramètre à Format.Par exemple, le code suivant provoque des résultats imprévisibles :

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

Pour plus d'informations, consultez Syntaxe de spécification de format : fonctions printf et wprintf.

Exemple

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

Configuration requise

Header: cstringt.h

Voir aussi

Référence

Classe de CStringT

sprintf_s, _sprintf_s_l, swprintf_s, _swprintf_s_l