warning pragma

Permite a modificação seletiva do comportamento das mensagens de aviso do compilador.

Sintaxe

#pragma warning(
  warning-specifier : warning-number-list , justification : string-literal[ ]
  ; warning-specifier : warning-number-list [ ... ])
#pragma warning( push ,[ n ])
#pragma warning( pop )

Comentários

Os seguintes parâmetros especificadores de aviso estão disponíveis.

A instrução de código a seguir ilustra que um parâmetro warning-number-list pode conter vários números de aviso e que vários parâmetros de warning-specifier podem ser especificados na mesma diretiva pragma.

#pragma warning( disable : 4507 4034; once : 4385; error : 164 )

No entanto, quando o justification campo está presente, apenas um número de aviso pode ser especificado. A instrução de código a seguir ilustra o uso do justification campo.

#pragma warning( disable : 4507, justification : "This warning is disabled" )

Os justification campos permitem explicar por que um aviso está sendo desativado ou suprimido. O justification campo é suportado apenas para o disable e suppresswarning-specifier. Esse valor aparecerá na saída SARIF quando a /analyze:log:includesuppressed opção for especificada. Seu valor é um literal de cadeia estreita codificada em UTF-8.

Esta diretiva é funcionalmente equivalente ao seguinte código:

// Disable warning messages 4507 and 4034.
#pragma warning(disable : 4507 4034)

// Issue warning C4385 only once.
#pragma warning(once : 4385)

// Report warning C4164 as an error.
#pragma warning(error : 164)

O compilador adiciona 4000 a qualquer número de aviso que esteja entre 0 e 999.

Os números de aviso no intervalo 4700-4999 estão associados à geração de código. Para esses avisos, o estado do aviso em vigor quando o compilador atinge a definição da função permanece em vigor para o resto da função. O uso do warningpragma na função para alterar o estado de um número de aviso maior que 4699 só entra em vigor após o final da função. O exemplo a seguir mostra o posicionamento correto de um warningpragma desabilitar uma mensagem de aviso de geração de código e, em seguida, restaurá-la.

// pragma_warning.cpp
// compile with: /W1
#pragma warning(disable:4700)
void Test()
{
   int x;
   int y = x; // no C4700 here
   #pragma warning(default:4700)   // C4700 enabled after compiling Test()
}

int main()
{
   int x;
   int y = x; // C4700
}

Observe que em todo um corpo de função, a última configuração do warningpragma estará em vigor para toda a função.

Empurrar e estourar

O warningpragma também suporta a sintaxe a seguir, onde o parâmetro opcional n representa um nível de aviso (1 a 4).

#pragma warning( push [ , n ] )

#pragma warning( pop )

O pragmawarning( push ) armazena o estado de aviso atual para cada aviso. O pragmawarning( push, n ) armazena o estado atual de cada aviso e define o nível de alerta global como n.

O pragmawarning( pop ) exibe o último estado de aviso empurrado para a pilha. Todas as alterações feitas no estado de aviso entre push e pop serão desfeitas. Considere este exemplo:

#pragma warning( push )
#pragma warning( disable : 4705 )
#pragma warning( disable : 4706 )
#pragma warning( disable : 4707 )
// Some code
#pragma warning( pop )

No final deste código, pop restaura o estado de cada aviso (inclui 4705, 4706 e 4707) para o que era no início do código.

Ao escrever arquivos de cabeçalho, você pode usar push e pop para garantir que as alterações de estado de aviso feitas por um usuário não impeçam que os cabeçalhos sejam compilados corretamente. Use push no início do cabeçalho e pop no final. Por exemplo, você pode ter um cabeçalho que não compila corretamente no nível de aviso 4. O código a seguir altera o nível de aviso para 3 e, em seguida, restaura o nível de aviso original no final do cabeçalho.

#pragma warning( push, 3 )
// Declarations/definitions
#pragma warning( pop )

Para obter mais informações sobre as opções do compilador que ajudam a suprimir avisos, consulte /FI e /w.

Ver também

diretivas Pragma e as palavras-chave __pragma e _Pragma