CStringT::FormatMessage
Formata uma cadeia de mensagem.
void __cdecl FormatMessage(
UINT nFormatID,
[, argument]...
);
void __cdecl FormatMessage(
PCXSTR pszFormat,
[, argument]...
);
Parâmetros
nFormatID
O identificador do recurso de cadeia de caracteres que contém o texto da mensagem sem formatação.pszFormat
Aponta para a cadeia de caracteres de formato - controle.Será digitalizada para inserções e formatado de acordo.A cadeia de caracteres de formato é semelhante à função printfde tempo de execução - estilo cadeias de caracteres de formato, a não ser que permite que os parâmetros ser inserido em uma ordem arbitrário.argument
Argumentos opcionais.
Comentários
A função requer uma definição de mensagem como entrada.A definição de mensagem é determinada por pszFormat ou de cadeia de caracteres de recurso identificado por nFormatID.A função copia texto de mensagem formatado para um objeto de CStringT , processando todas as seqüências inseridos de inserção se solicitada.
.gif "Observação") Observação |
|---|
FormatMessage tenta atribuir a memória do sistema para a cadeia de caracteres formatada recentemente.Se essa tentativa falhar, uma exceção é lançada de memória automaticamente. |
Cada inserção deve ter um parâmetro correspondente que segue o parâmetro de pszFormat ou de nFormatID .Dentro do texto de mensagem, várias seqüências de escape são suportadas dinamicamente formatando a mensagem.Para obter mais informações, consulte a função de FormatMessage do windows em Windows SDK.
Exemplo
// typedef CStringT<TCHAR, StrTraitATL<TCHAR, ChTraitsCRT<TCHAR>>> CAtlString;
CAtlString str;
int nAsked = 5;
int nAgree = 4;
str.FormatMessage(_T("%1!d! of %2!d! writers agree: Soccer is %3%!"),
nAgree, nAsked, _T("Best"));
ASSERT(str == _T("4 of 5 writers agree: Soccer is Best!"));
Requisitos
Cabeçalho: cstringt.h