C언어 초급 - 2장: C 프로그램의 구조 (2.2 주석(Comment))

2.2 주석(Comment)

C 언어에서 주석(Comment)은 프로그램의 가독성을 높이고 코드의 이해를 돕기 위해 사용됩니다.
주석은 컴파일러가 무시하며, 실행 파일에는 포함되지 않습니다.
즉, 프로그램의 동작에는 영향을 주지 않지만 개발자 간 협업이나 코드 유지보수에 중요한 역할을 합니다.

---

1. 주석(Comment)의 필요성

주석을 사용하면 다음과 같은 장점이 있습니다.

1.1 코드의 가독성 향상

• 코드에 대한 설명을 추가하여, 개발자가 쉽게 이해할 수 있도록 도와줍니다.

1.2 유지보수 및 협업 용이

• 다른 개발자가 코드를 수정하거나 유지보수할 때, 주석이 있으면 코드의 목적과 동작을 빠르게 파악할 수 있습니다.

1.3 특정 코드 비활성화 (디버깅)

• 특정 부분의 코드를 실행하지 않도록 주석을 사용하여 임시로 비활성화할 수 있습니다.

---

2. 단일 행 주석 (//)

2.1 개념

단일 행 주석은 // 기호를 사용하여 작성합니다.
// 뒤에 작성된 모든 내용은 해당 줄에서만 주석으로 처리됩니다.

2.2 단일 행 주석 예제

#include <stdio.h>

int main() {
    // 이 줄은 주석입니다. 컴파일러는 무시합니다.
    printf("Hello, World!\n");  // 화면에 "Hello, World!"를 출력합니다.

    return 0;  // 프로그램을 정상적으로 종료합니다.
}

출력 결과

Hello, World!

💡 // 뒤에 오는 모든 내용은 무시되며, 실행 파일에는 포함되지 않습니다.

---

3. 다중 행 주석 (/* */)

3.1 개념

다중 행 주석은 /*로 시작하고 */로 끝나는 방식으로 작성됩니다.
주석을 여러 줄에 걸쳐 사용할 때 유용합니다.

3.2 다중 행 주석 예제

#include <stdio.h>

int main() {
    /*
       이 부분은 주석입니다.
       여러 줄에 걸쳐 작성할 수 있습니다.
       주석이 종료되려면 반드시 "*/" 기호가 필요합니다.
    */
    printf("Hello, World!\n");

    return 0;
}

출력 결과

Hello, World!

💡 /*와 */ 사이에 있는 모든 내용은 컴파일러가 무시합니다.

---

4. 주석 활용 예제

4.1 코드 설명용 주석

주석을 사용하여 코드의 기능을 설명할 수 있습니다.

#include <stdio.h>

int main() {
    // 변수 선언 및 초기화
    int a = 10;  // 정수형 변수 a에 10을 저장
    int b = 20;  // 정수형 변수 b에 20을 저장

    // 두 변수의 합 출력
    printf("a + b = %d\n", a + b);

    return 0;
}

출력 결과

a + b = 30

---

4.2 디버깅을 위한 코드 비활성화

개발 중 특정 코드 실행을 막고 싶을 때, 주석을 사용하여 비활성화할 수 있습니다.

#include <stdio.h>

int main() {
    printf("이 부분은 실행됩니다.\n");

    // printf("이 부분은 실행되지 않습니다.\n");  // 이 줄은 주석 처리됨

    return 0;
}

출력 결과

이 부분은 실행됩니다.

---

5. 주의할 점

5.1 중첩된 다중 행 주석 사용 금지

C 언어에서는 다중 행 주석을 중첩해서 사용할 수 없습니다.
아래 예제처럼 /* 안에 또 다른 /* */을 포함하면 컴파일 오류가 발생합니다.

#include <stdio.h>

int main() {
    /* 
       printf("출력되지 않습니다.\n");  
       /* 중첩된 주석 */  
    */
    return 0;
}

🔴 오류 발생: "nested comment" (중첩된 주석)

✔ 해결 방법: 다중 행 주석 내부에 추가 주석이 필요할 경우, //을 사용해야 합니다.

/*
   여러 줄 주석
   // 여기는 한 줄 주석
*/

---

6. 정리

주석 종류	기호	설명
단일 행 주석	//	해당 줄의 나머지 부분이 주석 처리됨
다중 행 주석	/* */	여러 줄에 걸쳐 주석을 작성할 수 있음
중첩 주석 불가능	/* /* */ */	다중 행 주석은 중첩 사용 불가

C 언어에서 주석을 적절히 활용하면 코드 가독성이 향상되고, 유지보수 및 디버깅이 용이해집니다.