system_header pragma

Behandel de rest van het bestand als extern voor diagnostische rapporten.

Syntaxis

#pragma system_header

Opmerkingen

De system_headerpragma vertelt de compiler om diagnostische gegevens weer te geven op het niveau dat is opgegeven door de /external:Wn optie voor de rest van het huidige bronbestand. Zie /externalvoor meer informatie over het opgeven van externe bestanden en het externe waarschuwingsniveau voor de compiler.

De system_headerpragma is niet van toepassing voorbij het einde van het huidige bronbestand. Met andere woorden, het is niet van toepassing op bestanden die dit bestand bevatten. De system_headerpragma is van toepassing, zelfs als er geen andere bestanden zijn opgegeven als extern voor de compiler. Als er echter geen /external:Wn optieniveau is opgegeven, kan de compiler een diagnose uitvoeren en hetzelfde waarschuwingsniveau gebruiken dit van toepassing is op niet-externe bestanden. Andere pragma richtlijnen die van invloed zijn op waarschuwingsgedrag, zijn nog steeds van toepassing na een system_headerpragma. Het effect van #pragma system_header is vergelijkbaar met de warning pragma:

// If n represents the warning level specified by /external:Wn,
// #pragma system_header is roughly equivalent to:
#pragma warning( push, n )

// . . .

// At the end of the file:
#pragma warning( pop )

De system_headerpragma is beschikbaar vanaf Visual Studio 2019 versie 16.10.

Voorbeeld

Deze voorbeeldkoptekst laat zien hoe u de inhoud van een bestand markeert als extern:

// library.h
// Use /external:Wn to set the compiler diagnostics level for this file's contents

#pragma once
#ifndef _LIBRARY_H // include guard for 3rd party interop
#define _LIBRARY_H
#pragma system_header
// The compiler applies the /external:Wn diagnostic level from here to the end of this file.

// . . .

// You can still override the external diagnostic level for warnings locally:
#pragma warning( push )
#pragma warning( error : 4164 )

// . . .

#pragma warning(pop)

// . . .

#endif

Zie ook

/external
warning pragma
/Wn (waarschuwingsniveau compileren)
Pragma-instructies en de __pragma en _Pragma trefwoorden