C언어 프로그램 구조: main 함수, #include, 세미콜론, 주석, 반환값 | C언어 강좌 2강
C 프로그램의 뼈대인 #include, main 함수, 세미콜론과 중괄호 블록, 주석, return 반환값의 역할을 예제로 하나씩 정리합니다. 세미콜론 누락이나 중괄호 짝 오류처럼 초보자가 자주 만나는 컴파일 오류와 해결법도 함께 다룹니다.
1강에서 Hello World를 실행해 봤다면, 이번에는 그 몇 줄이 각각 어떤 역할을 하는지 하나씩 살펴볼 차례예요. #include, main 함수, 세미콜론과 중괄호 블록, 주석, 반환값은 앞으로 작성할 거의 모든 C 프로그램에 등장하는 뼈대예요.
이 뼈대를 정확히 이해해 두면 컴파일 오류 메시지를 읽는 것도 훨씬 쉬워지고, 이후 강의에서 새 문법을 배울 때도 어디에 코드를 써야 하는지 헷갈리지 않아요.
C 프로그램의 기본 뼈대
먼저 1강에서 만든 프로그램을 다시 보면서 전체 모양을 확인해요. 각 줄 오른쪽에 주석으로 역할을 적어 두었어요.
#include <stdio.h> // 표준 입출력 헤더를 포함해요
int main(void) // 프로그램이 시작되는 곳이에요
{
printf("Hello, World!\n"); // 화면에 문자열을 출력해요
return 0; // 운영체제에 '정상 종료'를 알려요
}
실행 결과
Hello, World!
겨우 일곱 줄이지만 C 프로그램을 이루는 핵심 요소가 모두 들어 있어요. 각 부분을 표로 정리하면 다음과 같아요.
| 부분 | 이름 | 역할 |
|---|---|---|
#include <stdio.h> |
전처리 지시문 | printf 같은 기능의 선언을 가져와요 |
int main(void) |
함수 머리 | 프로그램의 시작점인 main 함수를 정의해요 |
{ ... } |
블록(함수 본문) | 실행할 문장들을 하나로 묶어요 |
printf(...); |
문장(statement) | 실제로 일을 하는 명령이에요. 세미콜론으로 끝나요 |
// ... |
주석 | 사람을 위한 메모예요. 컴파일러는 무시해요 |
return 0; |
반환문 | 프로그램의 결과를 운영체제에 알려요 |
이제 위에서부터 차례대로 자세히 살펴봐요.
#include: 필요한 도구 가져오기
#include는 다른 파일의 내용을 현재 소스 파일에 그대로 끼워 넣으라는 명령이에요. #으로 시작하는 줄은 컴파일 전에 전처리기가 먼저 처리하는데, 1강에서 본 전처리 단계가 바로 이 일을 해요.
stdio.h는 standard input/output(표준 입출력)의 줄임말이에요. 이 헤더 파일 안에 printf가 어떤 모양의 함수인지 알려 주는 선언이 들어 있어서, 이걸 포함해야 컴파일러가 printf를 제대로 이해할 수 있어요.
꺾쇠괄호와 큰따옴표
헤더 이름을 감싸는 방법은 두 가지예요. <stdio.h>처럼 꺾쇠괄호를 쓰면 컴파일러에 딸려 오는 표준 헤더 폴더에서 찾고, "myheader.h"처럼 큰따옴표를 쓰면 보통 현재 소스 파일이 있는 폴더부터 찾아요.
직접 헤더 파일을 만드는 방법은 나중에 여러 파일로 프로그램을 나누는 강에서 배워요. 지금은 표준 헤더는 꺾쇠괄호로 쓴다는 것만 기억하면 충분해요.
자주 쓰는 표준 헤더
| 헤더 | 들어 있는 주요 기능 |
|---|---|
stdio.h |
printf, scanf 등 입출력 |
stdlib.h |
EXIT_SUCCESS, 메모리 할당, 난수 등 |
string.h |
문자열 길이 구하기, 복사 등 |
math.h |
제곱근, 거듭제곱 같은 수학 함수 |
필요한 헤더가 여러 개라면 한 줄에 하나씩 #include를 쓰면 돼요.
#include를 빠뜨리면
#include <stdio.h> 없이 printf를 쓰면 컴파일러는 printf가 무엇인지 모른다고 알려 줘요. 최근 gcc(14 이상)에서는 다음처럼 오류가 나고, 예전 버전에서는 경고만 나오고 넘어가기도 해요.
hello.c: In function 'main':
hello.c:3:5: error: implicit declaration of function 'printf' [-Wimplicit-function-declaration]
hello.c:1:1: note: include '<stdio.h>' or provide a declaration of 'printf'
친절하게도 note에 어떤 헤더를 포함하면 되는지까지 알려 줘요. 경고만 나왔더라도 무시하지 말고 꼭 헤더를 추가하세요.
main 함수: 프로그램의 시작점
C 프로그램은 실행되면 항상 main이라는 이름의 함수부터 시작해요. 파일 안에 함수가 여러 개 있어도 운영체제가 자동으로 불러 주는 것은 main 하나뿐이에요.
int main(void)를 조각내서 보면 다음과 같아요.
int: 이 함수가 끝날 때 정수(integer) 값을 돌려준다는 뜻이에요. 자료형은 3강에서 자세히 배워요.main: 함수 이름이에요. 반드시 소문자main이어야 해요.(void): 이 함수는 외부에서 받는 값(매개변수)이 없다는 뜻이에요.{ ... }: 함수 본문이에요. 여기에 실행할 문장을 적어요.
명령줄 인자를 받는 int main(int argc, char *argv[]) 형태도 있는데, 이것은 포인터와 배열을 배운 뒤에 다시 다뤄요.
문장은 위에서 아래로 실행돼요
main 안의 문장들은 특별한 지시가 없으면 적힌 순서대로 하나씩 실행돼요.
#include <stdio.h>
int main(void)
{
printf("1. 아침에 일어나요\n");
printf("2. 세수를 해요\n");
printf("3. 아침을 먹어요\n");
return 0;
}
실행 결과
1. 아침에 일어나요
2. 세수를 해요
3. 아침을 먹어요
세 개의 printf가 위에서 아래 순서로 실행되었어요. 문자열 끝의 \n은 줄을 바꾸라는 뜻이고, 이런 특수 문자와 서식은 4강에서 자세히 다뤄요.
main이 없거나 이름이 틀리면
main을 Main이나 mian으로 잘못 쓰면 컴파일 자체는 되지만, 마지막 링크 단계에서 시작점을 찾지 못해 실패해요.
/usr/bin/ld: ... in function `_start':
(.text+0x1b): undefined reference to `main'
collect2: error: ld returned 1 exit status
undefined reference to 'main'이 보이면 함수 이름의 철자와 대소문자부터 확인하세요. C는 대소문자를 구별하기 때문에 Main과 main은 완전히 다른 이름이에요.
세미콜론: 문장의 끝 표시
C에서 세미콜론(;)은 문장이 끝났다는 표시예요. 줄바꿈은 문장의 끝으로 인정되지 않기 때문에, 문장마다 반드시 세미콜론을 붙여야 해요.
반대로 말하면, 세미콜론만 제대로 있으면 줄을 어떻게 나누든 컴파일러는 상관하지 않아요.
#include <stdio.h>
int main(void)
{
// 한 줄에 문장 두 개
printf("A\n"); printf("B\n");
// 문장 하나를 여러 줄에 걸쳐 쓰기
printf(
"C\n"
);
return 0;
}
실행 결과
A
B
C
두 문장을 한 줄에 써도, 한 문장을 세 줄로 나눠도 정상적으로 동작해요. 다만 읽기 좋은 코드를 위해 보통은 한 줄에 한 문장을 쓰는 것이 관례예요.
세미콜론을 붙이지 않는 곳
모든 줄에 세미콜론을 붙이는 것은 아니에요. 다음 세 곳에는 세미콜론을 쓰지 않아요.
| 위치 | 예 | 이유 |
|---|---|---|
| 전처리 지시문 뒤 | #include <stdio.h> |
문장이 아니라 전처리기 명령이에요 |
| 함수 머리 뒤 | int main(void) |
바로 뒤에 본문 블록이 이어져요 |
| 함수 본문의 닫는 중괄호 뒤 | } |
블록은 그 자체로 끝이 분명해요 |
특히 int main(void);처럼 함수 머리 뒤에 세미콜론을 붙이면, 컴파일러는 이것을 함수 선언으로 해석하고 그다음 {를 이해하지 못해요. 이때 expected identifier or '(' before '{' token 같은 오류가 나요.
세미콜론을 빠뜨리면
초보자가 가장 많이 만나는 오류예요. 다음 코드는 printf 줄 끝에 세미콜론이 없어요.
#include <stdio.h>
int main(void)
{
printf("Hello\n") // 세미콜론이 빠졌어요
return 0;
}
gcc로 컴파일하면 다음과 같은 오류가 나요.
hello.c: In function 'main':
hello.c:5:22: error: expected ';' before 'return'
5 | printf("Hello\n") // 세미콜론이 빠졌어요
| ^
| ;
6 | return 0;
| ~~~~~~
메시지를 그대로 읽으면 return 앞에 ;이 있어야 한다는 뜻이에요. 컴파일러는 다음 단어를 만나고 나서야 문장이 안 끝났다는 걸 알아차리기 때문에, 오류 위치가 실제로 빠뜨린 곳보다 한 줄 아래로 표시되는 경우가 많아요.
오류 줄 번호를 보면 그 바로 윗줄도 함께 확인하는 습관을 들이세요.
블록: 중괄호로 묶은 문장 모음
중괄호 { }로 감싼 부분을 블록(block)이라고 해요. 블록은 여러 문장을 하나의 묶음으로 만들어 주고, main 함수의 본문도 하나의 블록이에요.
블록 안에 또 블록을 넣을 수도 있어요. 실행 흐름은 그대로 위에서 아래로 진행돼요.
#include <stdio.h>
int main(void)
{
printf("바깥 블록 시작\n");
{
// 안쪽 블록
printf(" 안쪽 블록\n");
}
printf("바깥 블록 끝\n");
return 0;
}
실행 결과
바깥 블록 시작
안쪽 블록
바깥 블록 끝
지금은 안쪽 블록이 특별한 일을 하지 않지만, 블록은 이후 조건문(if)과 반복문(for, while)에서 '이 조건일 때 실행할 문장 묶음'을 표현하는 데 쓰여요. 블록 안에서 만든 변수가 어디까지 유효한지(범위) 역시 나중에 블록과 연결해서 배워요.
들여쓰기는 사람을 위한 것
안쪽 블록의 문장을 오른쪽으로 들여 쓴 것은 순전히 읽기 편하게 하기 위해서예요. C 컴파일러는 들여쓰기와 공백을 무시하므로, 들여쓰기를 엉망으로 해도 컴파일은 돼요.
하지만 들여쓰기가 일정하지 않으면 어느 중괄호가 어느 블록에 속하는지 알아보기 어려워져요. 블록이 한 단계 깊어질 때마다 공백 4칸(또는 탭 하나)씩 들여 쓰는 습관을 들이세요.
중괄호 짝이 맞지 않으면
여는 중괄호와 닫는 중괄호는 반드시 짝이 맞아야 해요. 닫는 중괄호를 빠뜨리면 파일 끝까지 읽은 뒤에 다음과 같은 오류가 나요.
hello.c: In function 'main':
hello.c:6:5: error: expected declaration or statement at end of input
at end of input, 즉 '입력이 끝났는데 아직 기대하는 것이 있다'는 메시지가 보이면 중괄호 짝부터 세어 보세요. 대부분의 코드 편집기는 괄호에 커서를 올리면 짝이 되는 괄호를 강조해 주니 적극적으로 활용하면 좋아요.
주석: 컴파일러가 무시하는 메모
주석(comment)은 코드를 읽는 사람을 위한 설명이에요. 컴파일 과정에서 완전히 제거되므로 프로그램 동작에는 아무 영향을 주지 않아요.
C에는 두 가지 주석이 있어요.
| 형태 | 범위 | 주 용도 |
|---|---|---|
// 내용 |
//부터 그 줄 끝까지 |
짧은 설명 |
/* 내용 */ |
/*부터 */까지, 여러 줄 가능 |
긴 설명, 파일 머리말 |
#include <stdio.h>
/*
* 주석 연습 프로그램
* 작성일: 2026-11-16
*/
int main(void)
{
// 한 줄 주석: 이 줄 끝까지가 주석이에요
printf("첫 번째 줄\n");
/* printf("이 줄은 실행되지 않아요\n"); */
printf("두 번째 줄\n"); // 코드 뒤에도 쓸 수 있어요
printf("// 문자열 안은 주석이 아니에요\n");
return 0;
}
실행 결과
첫 번째 줄
두 번째 줄
// 문자열 안은 주석이 아니에요
/* */로 감싼 printf는 주석이 되어 실행되지 않았어요. 이렇게 코드를 지우지 않고 잠시 꺼 두는 것을 '주석 처리한다'고 해요.
마지막 줄처럼 큰따옴표 안에 있는 //는 주석이 아니라 그냥 문자열의 일부라서 그대로 출력돼요.
/* */ 주석은 겹칠 수 없어요
/* */ 주석 안에 또 /* */를 넣으면 첫 번째 */에서 주석이 끝나 버려요. 그 뒤에 남은 글자는 코드로 해석되어 엉뚱한 오류가 생겨요.
/* 바깥 주석 /* 안쪽 주석 */ 여기는 이제 코드로 취급돼요 */
여러 줄을 한꺼번에 주석 처리할 때 이미 /* */가 섞여 있다면, 줄마다 //를 붙이는 편이 안전해요. 대부분의 편집기에는 선택한 줄 전체에 //를 붙여 주는 단축키(보통 Ctrl + /)가 있어요.
좋은 주석 쓰는 법
printf("Hello\n"); // Hello를 출력한다처럼 코드를 그대로 다시 읽어 주는 주석은 도움이 되지 않아요. 코드만 봐서는 알기 어려운 '왜 이렇게 했는지'를 적는 것이 좋은 주석이에요.
이 강좌의 예제에는 학습을 위해 설명형 주석을 많이 달지만, 실무 코드에서는 꼭 필요한 곳에만 간결하게 남기는 것이 좋아요.
반환값: 운영체제에 보내는 결과 보고
main 함수 앞의 int는 '정수 하나를 돌려준다'는 약속이었어요. 그 정수를 실제로 돌려주는 문장이 return이고, main이 돌려준 값은 프로그램을 실행한 운영체제(또는 셸)에 전달돼요.
이 값을 종료 코드(exit code)라고 불러요.
관례상 0은 정상 종료, 0이 아닌 값은 무언가 문제가 생겼다는 뜻이에요. 여러 프로그램을 이어서 실행하는 스크립트는 이 값을 보고 다음 단계를 진행할지 결정해요.
종료 코드 확인하기
다음 프로그램은 일부러 3을 돌려줘요.
#include <stdio.h>
int main(void)
{
printf("오류가 난 것처럼 3을 돌려줘요\n");
return 3;
}
Linux나 macOS 터미널에서는 실행 직후 echo $?로 방금 끝난 프로그램의 종료 코드를 볼 수 있어요.
$ gcc exit_code.c -o exit_code
$ ./exit_code
오류가 난 것처럼 3을 돌려줘요
$ echo $?
3
Windows 명령 프롬프트에서는 echo %ERRORLEVEL%, PowerShell에서는 $LASTEXITCODE로 같은 값을 확인할 수 있어요. 참고로 Linux와 macOS에서는 종료 코드가 0~255 범위로 잘려서 전달되므로 그 범위 안의 값을 쓰는 것이 좋아요.
EXIT_SUCCESS와 EXIT_FAILURE
stdlib.h를 포함하면 숫자 대신 의미가 분명한 이름을 쓸 수 있어요. EXIT_SUCCESS는 성공, EXIT_FAILURE는 실패를 뜻하고, 대부분의 시스템에서 각각 0과 1이에요.
#include <stdio.h>
#include <stdlib.h>
int main(void)
{
printf("return 전\n");
return EXIT_SUCCESS;
printf("return 후\n"); // 이 줄은 실행되지 않아요
}
실행 결과
return 전
return을 만나는 순간 main 함수가 끝나고 프로그램이 종료돼요. 그래서 그 뒤에 있는 printf는 실행될 기회가 없어요.
return 0을 생략하면
C99 표준부터는 main 함수에 한해서 return을 생략하고 끝까지 도달하면 return 0;을 한 것과 똑같이 처리해요. 그래도 의도를 분명히 드러내기 위해 직접 써 주는 것을 권장해요.
오래된 책이나 블로그에서 void main()이라는 형태를 볼 수도 있는데, 이것은 표준 C가 아니에요. 일부 컴파일러에서만 허용될 뿐이니 항상 int main(void)를 쓰세요.
자주 하는 실수 한눈에 보기
| 실수 | 대표 증상(gcc 기준) | 해결 |
|---|---|---|
| 문장 끝 세미콜론 누락 | expected ';' before ... |
오류 줄과 그 윗줄 끝을 확인 |
int main(void);처럼 함수 머리에 세미콜론 |
expected identifier or '(' before '{' token |
함수 머리 뒤 세미콜론 삭제 |
| 닫는 중괄호 누락 | expected declaration or statement at end of input |
중괄호 짝 세어 보기 |
#include <stdio.h> 누락 |
implicit declaration of function 'printf' |
필요한 헤더 추가 |
Main, mian 등 오타 |
undefined reference to 'main' |
소문자 main으로 수정 |
/* */ 주석 중첩 |
예상치 못한 문법 오류 | // 주석으로 바꾸기 |
오류 메시지가 여러 개 쏟아질 때는 맨 위의 첫 번째 오류부터 고치세요. 첫 오류 하나 때문에 뒤따라 생긴 가짜 오류인 경우가 많아서, 하나만 고쳐도 나머지가 한꺼번에 사라지곤 해요.
연습 문제
문제 1: 자기소개 프로그램
다음 조건을 지켜 자기소개를 세 줄로 출력하는 프로그램을 작성하세요.
- 파일 맨 위에
/* */주석으로 프로그램 설명을 적어요. printf문장마다//주석을 하나씩 달아요.return 0;으로 정상 종료해요.
문제 2: 오류 찾아 고치기
다음 코드에는 구조상 잘못된 곳이 네 군데 있어요. 모두 찾아 고쳐서 정상적으로 컴파일되게 만드세요.
#include <stdio.h>;
int main(void);
{
printf("C 프로그램 구조\n")
printf("완벽 이해!\n");
return 0;
문제 3: 실패를 알리는 프로그램
"설정 파일을 찾을 수 없어요"라는 문장을 출력한 뒤, stdlib.h의 상수를 사용해 실패를 뜻하는 종료 코드를 돌려주는 프로그램을 작성하세요. 실행 후 echo $?로 종료 코드도 확인해 보세요.
정답 예시
문제 1 정답
/*
* 자기소개 프로그램
* 이름, 취미, 목표를 차례로 출력해요
*/
#include <stdio.h>
int main(void)
{
printf("이름: 김코딩\n"); // 이름 출력
printf("취미: 프로그래밍\n"); // 취미 출력
printf("목표: C언어 정복\n"); // 목표 출력
return 0;
}
실행 결과
이름: 김코딩
취미: 프로그래밍
목표: C언어 정복
주석은 #include보다 위에 있어도 괜찮아요. 주석은 어디에 있든 컴파일 전에 제거되기 때문이에요.
문제 2 정답
#include <stdio.h> // 1. #include 뒤 세미콜론 삭제
int main(void) // 2. 함수 머리 뒤 세미콜론 삭제
{
printf("C 프로그램 구조\n"); // 3. 빠진 세미콜론 추가
printf("완벽 이해!\n");
return 0;
} // 4. 닫는 중괄호 추가
실행 결과
C 프로그램 구조
완벽 이해!
#include <stdio.h>;는 gcc에서 extra tokens at end of #include directive라는 경고로 끝나기도 하지만, 전처리 지시문 뒤에는 세미콜론을 쓰지 않는 것이 올바른 문법이에요. 나머지 세 곳은 모두 컴파일 오류의 원인이에요.
문제 3 정답
#include <stdio.h>
#include <stdlib.h> // EXIT_FAILURE를 쓰기 위해 필요해요
int main(void)
{
printf("설정 파일을 찾을 수 없어요\n");
return EXIT_FAILURE; // 실패를 알리는 종료 코드
}
실행 결과
$ ./config_check
설정 파일을 찾을 수 없어요
$ echo $?
1
대부분의 시스템에서 EXIT_FAILURE는 1이라서 echo $?의 결과로 1이 나와요. stdlib.h를 빠뜨리면 EXIT_FAILURE가 정의되지 않았다는 오류가 나요.
핵심 정리
#include <헤더>는 전처리기가 헤더 파일 내용을 끼워 넣게 하는 지시문이에요.printf를 쓰려면stdio.h가 필요하고, 뒤에 세미콜론을 붙이지 않아요.- 모든 C 프로그램은
main함수에서 시작해요. 표준 형태는int main(void)이고, 이름은 반드시 소문자main이에요. - 문장은 세미콜론으로 끝나요. 줄바꿈은 문장의 끝이 아니며, 세미콜론 누락 오류는 보통 다음 줄 위치로 보고돼요.
- 중괄호
{ }는 문장들을 블록으로 묶어요. 짝이 반드시 맞아야 하고, 들여쓰기는 사람이 읽기 위한 것이에요. - 주석은
//(한 줄)과/* */(여러 줄) 두 가지예요./* */는 중첩할 수 없고, 문자열 안의//는 주석이 아니에요. main의 반환값은 운영체제에 전달되는 종료 코드예요.0(또는EXIT_SUCCESS)은 성공, 그 외 값(EXIT_FAILURE등)은 실패를 뜻해요.return을 만나면main은 즉시 끝나고, 그 뒤의 문장은 실행되지 않아요.
강좌 이어 보기
- 이전 강좌: 1강 C언어란? 개발 환경과 첫 프로그램
- 다음 강좌: 3강 변수와 자료형 (곧 올라옵니다)
- C언어 강좌 전체 목차 보기