Freigeben über


CStringT::Format

Schreibt formatierte Daten zu CStringT genauso, dass sprintf_s Daten in ein Zeichenarray eine formatiert.

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

Parameter

  • nFormatID
    Der Zeichenfolgenressourcenbezeichner, der die Formatsteuerzeichenfolge enthält.

  • pszFormat
    Eine Formatsteuerzeichenfolge.

  • argument
    Optionale Argumente.

Hinweise

Diese Funktion formatiert und speichert eine Reihe von Zeichen und Werte in CStringT. Ein optionales Argument (falls vorhanden) wird und Ausgabe entsprechend der entsprechenden Formatangabe in pszFormat oder von der Zeichenfolgenressource konvertiert, die von nFormatID identifiziert wird.

Der Aufruf schlägt fehl, wenn das Zeichenfolgenobjekt selbst als Parameter Format bereitgestellt wird. Beispielsweise verursacht der folgende Code unvorhersehbare Ergebnisse:

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

Weitere Informationen finden Sie unter Syntax der Formatangabe: printf- und wprintf-Funktionen.

Beispiel

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

Anforderungen

Header: cstringt.h

Siehe auch

Referenz

CStringT Class

sprintf_s, _sprintf_s_l, swprintf_s, _swprintf_s_l