execution_character_set pragma

Hiermee geeft u de uitvoeringstekenset op die wordt gebruikt voor letterlijke tekenreeksen en tekens. Deze richtlijn is niet nodig voor letterlijke tekens die zijn gemarkeerd met het voorvoegsel u8.

Syntaxis

#pragma execution_character_set( 'target' )

Parameters

target
Hiermee geeft u de tekenset voor de doeluitvoering op. Momenteel wordt de enige ondersteunde doeluitvoeringsset "utf-8".

Opmerkingen

Deze compilerrichtlijn is verouderd in Visual Studio 2015 Update 2 en nieuwere versies. U wordt aangeraden de opties voor /execution-charset:utf-8 of /utf-8 compiler samen met het u8 voorvoegsel te gebruiken voor smalle tekens en letterlijke tekenreeksen die uitgebreide tekens bevatten. Zie letterlijke tekenreeks en tekenreeksvoor meer informatie over het voorvoegsel u8. Zie /execution-charset (Uitvoeringstekenset instellen) en /utf-8 (Bron- en uitvoeringstekensets instellen op UTF-8)voor meer informatie over de compileropties.

De #pragma execution_character_set("utf-8")-instructie vertelt de compiler om smalle teken- en smalle letterlijke tekenreeksen in uw broncode te coderen als UTF-8 in het uitvoerbare bestand. Deze uitvoercodering is onafhankelijk van hoe het bronbestand wordt gecodeerd.

Wanneer de compiler smalle tekens en smalle tekenreeksen codeert, wordt standaard de huidige codepagina gebruikt als uitvoeringstekenset. Unicode- of DBCS-tekens buiten het bereik van de huidige codepagina worden geconverteerd naar het standaard vervangende teken in de uitvoer. Unicode- en DBCS-tekens worden afgekapt tot hun byte met lage volgorde. Dit is bijna nooit wat u van plan bent. Als u de UTF-8-codering wilt opgeven voor letterlijke gegevens in het bronbestand, gebruikt u een u8 voorvoegsel. De compiler geeft deze gecodeerde UTF-8-tekenreeksen door aan de uitvoer ongewijzigd. Letterlijke tekens beperken die worden voorafgegaan door u8 moeten in een byte passen, of ze worden afgekapt in de uitvoer.

Visual Studio gebruikt standaard de huidige codepagina als de brontekenset die wordt gebruikt om de broncode voor uitvoer te interpreteren. Wanneer een bestand wordt gelezen, interpreteert Visual Studio het op basis van de huidige codepagina, tenzij het bestand een codepagina heeft ingesteld. Of, tenzij aan het begin van het bestand een byte-ordermarkering (BOM) of UTF-16 tekens worden gedetecteerd. UTF-8 kunt u niet instellen als de huidige codepagina in sommige versies van Windows. Wanneer met automatische detectie met UTF-8 gecodeerde bronbestanden worden gevonden zonder stuklijst in die versies, wordt ervan uitgegaan dat deze zijn gecodeerd op de huidige codepagina. Tekens in het bronbestand die buiten het bereik van de opgegeven of automatisch gedetecteerde codepagina vallen, kunnen compilerwaarschuwingen en -fouten veroorzaken.

Zie ook

Pragma-instructies en de __pragma en _Pragma trefwoorden
/execution-charset (uitvoeringstekenset instellen)
/utf-8 (bron- en uitvoeringstekensets instellen op UTF-8)