Microsoft C++ learn: 주석(Comments)

참고 문서

• learn.microsoft.com: Comments

이 문서의 내용

주석(Comments)

주석(Comments)은 컴파일러에서 실행되지 않고 프로그래머의 참고를 위한 텍스트입니다.

컴파일러는 이를 공백으로 처리하기 때문에 특정 코드 라인을 비활성화하기 위한 목적으로도 사용됩니다.

다른 대부분의 언어와 마찬가지로 C++ 주석은 단일 행 주석과 다행 주석이 존재합니다.

단일 행 주석

대부분의 언어처럼 두 개의 연속된 슬래시(/)로 시작되는 행은 주석으로 취급됩니다.

// 이 행은 주석입니다.
int a = 10;
int b = 20;
int c = 30;

특정 코드 라인을 비활성화 하기 위한 목적으로 사용 될 수 있습니다.

int a = 10;
// int b = 20; 이 행은 주석입니다.
int c = 30;

단일 행 주석으로 시작되는 토큰은 이미 주석의 의미를 갖기 때문에 다음과 같이 연속된 슬래시(/) 구문 또한 주석으로 취급됩니다.

//// 마찬가지로 주석입니다.

단일 행 주석의 경우 // 이후부터 행의 종료 지점까지를 주석으로 취급합니다.

따라서 예시와 같이 단일 행 주석 이전의 토큰은 모두 유효합니다.

int a = 10;
int b = 20; // 변수 b는 컴파일러에 의해 실행됩니다.
int c = 30;

이는 컴파일러 관점에서 // 전후 행을 서로 다른 행으로 재해석 할 수 있습니다.

int a = 10;
int b = 20; 
// 변수 b는 컴파일러에 의해 실행됩니다.
int c = 30;

다행 주석

여러 행을 주석 처리하려면 슬래시(/)와 별표(*)의 쌍으로 구성된 블록(Code block)을 생성합니다.

다행 주석을 의미하는 코드 블록의 시작은 /*이며 종료 지점은 */입니다.

int a = 10;
/*
    다행 주석의 시작입니다.

    int b = 20;
    int c = 30;

    다행 주석의 종료입니다.
*/
int d = 40;

단일 행 주석과 다행 주석의 혼합 사용

일반적으로 IDE는 선택된 행의 개수에 따라서 주석 단축키를 실행하면 자동으로 단일 행 또는 다행 주석이 삽입 및 해제됩니다.

하지만 사용자 편의성에 따라서 다음과 같이 혼합된 형태의 주석을 구성 할 수 있습니다.

///*
int a = 10;
int b = 20;
int c = 30;
//*/

코드		비고
Line 1	///*	단일 행 주석(//)이 다행 주석의 시작(/*) 토큰을 포함합니다.
Line 5	//*/	단일 행 주석(//)이 다행 주석의 종료(*/) 토큰을 포함합니다.

전체 주석을 활성화 및 비활성화하려면 단일 행 주석을 삽입 및 해제합니다.

/*
int a = 10;
int b = 20;
int c = 30;
*/

전체 주석을 비활성화하고 의도된 다행 주석 블록 내의 특정 행을 다시 주석 처리하기 용이하다는 장점이 있습니다.

///*
int a = 10;
// int b = 20;
int c = 30;
//*/