literal (C + +/CLI)literal (C++/CLI)

컴파일에서로 표시 된 변수 (데이터 멤버)는 literal /clr 컴파일 타임 상수입니다.A variable (data member) marked as literal in a /clr compilation is a compile-time constant. C # 변수에 해당 하는 네이티브 항목입니다 const .It's the native equivalent of a C# const variable.

모든 플랫폼All Platforms


(이 언어 기능에는 모든 런타임에 적용되는 설명이 없습니다.)(There are no remarks for this language feature that apply to all runtimes.)

Windows 런타임Windows Runtime


(이 언어 기능에는 Windows 런타임에만 적용되는 설명이 없습니다.)(There are no remarks for this language feature that apply to only the Windows Runtime.)

공용 언어 런타임Common Language Runtime


로 표시 된 데이터 멤버는 literal 선언 될 때 초기화 되어야 합니다.A data member marked as literal must be initialized when declared. 및 값은 상수 정수 계열, 열거형 또는 문자열 형식 이어야 합니다.And, the value must be a constant integral, enum, or string type. 초기화 식의 형식에서 데이터 멤버의 형식으로 변환 하려면 literal 사용자 정의 변환이 필요 하지 않습니다.Conversion from the type of the initialization expression to the type of the literal data member can't require a user-defined conversion.

런타임에 필드에 대해 메모리가 할당 되지 않습니다. literal 컴파일러는 클래스에 대 한 메타 데이터에 해당 값을 삽입 합니다.No memory is allocated for the literal field at runtime; the compiler only inserts its value in the metadata for the class. literal 값은 컴파일 시간 상수로 취급 됩니다.The literal value is treated as a compile-time constant. 표준 c + +에서 가장 유사한 것은 constexpr 이지만 데이터 멤버는 constexpr c + +/cli 일 수 없습니다.The closest equivalent in Standard C++ is constexpr, but a data member can't be constexpr in C++/CLI.

로 표시 된 변수가 표시 되는 변수와 literal 다릅니다 static const .A variable marked as literal differs from one marked static const. static const 데이터 멤버는 다른 컴파일러에 대 한 메타 데이터에서 사용할 수 없습니다.A static const data member isn't made available in metadata to other compilers. 자세한 내용은 staticconst을 참조하세요.For more information, see static and const.

literal 는 상황에 맞는 키워드입니다.literal is a context-sensitive keyword. 자세한 내용은 상황에 맞는 키워드를 참조 하세요.For more information, see Context-sensitive keywords.


이 예에서는 변수가를 의미 함을 보여 줍니다 literal static .This example shows that a literal variable implies static.

// mcppv2_literal.cpp
// compile with: /clr
ref struct X {
   literal int i = 4;

int main() {
   int value = X::i;

다음 샘플에서는 메타 데이터의 효과를 보여 줍니다 literal .The following sample shows the effect of literal in metadata:

// mcppv2_literal2.cpp
// compile with: /clr /LD
public ref struct A {
   literal int lit = 0;
   static const int sc = 1;

sclit에 대한 메타데이터에서의 차이점을 확인할 수 있습니다. modopt 지시문은 sc에 적용되어, 다른 컴파일러에서 무시될 수 있습니다.Notice the difference in the metadata for sc and lit: the modopt directive is applied to sc, meaning it can be ignored by other compilers.

.field public static int32 modopt([mscorlib]System.Runtime.CompilerServices.IsConst) sc = int32(0x00000001)
.field public static literal int32 lit = int32(0x00000000)

C #으로 작성 된 다음 샘플은 이전 샘플에서 만든 메타 데이터를 참조 하 고 및 변수의 효과를 보여 줍니다 literal static const .The following sample, authored in C#, references the metadata created in the previous sample and shows the effect of literal and static const variables:

// mcppv2_literal3.cs
// compile with: /reference:mcppv2_literal2.dll
// A C# program
class B {
   public static void Main() {
      // OK

      // C# does not enforce C++ const = 9;

      // C# enforces const for a literal
      A.lit = 9;   // CS0131

      // you can assign a C++ literal variable to a C# const variable
      const int i = A.lit;

      // but you cannot assign a C++ static const variable
      // to a C# const variable
      const int j =;   // CS0133

요구 사항Requirements

컴파일러 옵션: /clrCompiler option: /clr

참고 항목See also

.NET 및 UWP 용 구성 요소 확장Component Extensions for .NET and UWP