warning pragma

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

Sintaxe

#pragma warning(
 [ ]
 [... ]
[ n ]
#pragma warning( pop )

Observações

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

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

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

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

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

Use o campo para explicar por que um aviso está sendo desabilitado ou suprimido. O campo só tem suporte para o e . A justificativa aparece na saída SARIF (Formato de Intercâmbio de Resultados de Análise Estática) quando a opção é especificada. Seu valor é um literal de cadeia de caracteres estreita codificado em UTF-8. Para gerar um arquivo SARIF, use a opção do compilador.

Essa 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 de função permanece em vigor para o restante da função. O uso do 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 para desabilitar uma mensagem de aviso de geração de código e 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 o corpo da função, a última configuração do estará em vigor para toda a função.

Efetuar push e pop

O também dá suporte à sintaxe a seguir, em que o parâmetro opcional n representa um nível de aviso (1 a 4).

#pragma warning( push [ , n ] )

#pragma warning( pop )

O armazena o estado de aviso atual para cada aviso. O armazena o estado atual para cada aviso e define o nível de aviso global como n.

O exibe o último estado de aviso enviado para a pilha. Todas as alterações feitas no estado de aviso entre e sã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 desse código, 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 e 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 no início do cabeçalho e no final. Por exemplo, você pode ter um cabeçalho que não é compilado de forma limpa no nível de aviso 4. O código a seguir altera o nível de aviso para 3 e restaura o nível de aviso original no final do cabeçalho.

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

Escolhendo entre e

Ambos e oferecem controle refinado sobre a supressão de aviso:

• [[gsl::suppress]] suprime apenas os avisos emitidos pelo microsoft C++ Code Analysis. Use-o com as verificações de Diretrizes principais do C++, que podem ser aplicadas a um escopo ou a uma declaração específica.
• pode ser usado para qualquer aviso do compilador. É útil quando você precisa suprimir um aviso em um bloco de código específico sem alterar significativamente a estrutura do código.

Sempre que possível, use [[gsl::suppress]] para suprimir avisos de Code Analysis do Microsoft C++.

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

Consulte também

diretivas Pragma e as palavras-chave e