README.md - Examples

  1# C 프로그래밍 예제 코드
  2
  3이 폴더에는 C 프로그래밍 학습 문서의 모든 예제 코드가 포함되어 있습니다.
  4
  5## 디렉토리 구조
  6
  7```
  8examples/
  9├── 02_calculator/          # 계산기
 10├── 03_number_guess/        # 숫자 맞추기 게임
 11├── 04_address_book/        # 주소록
 12├── 05_dynamic_array/       # 동적 배열
 13├── 06_linked_list/         # 연결 리스트
 14├── 07_file_crypto/         # 파일 암호화
 15├── 08_stack_queue/         # 스택과 큐
 16├── 09_hash_table/          # 해시 테이블
 17├── 10_snake_game/          # 뱀 게임
 18├── 11_minishell/           # 미니 쉘
 19├── 12_multithread/         # 멀티스레드
 20├── 13_embedded_basic/      # 임베디드 기초 (Arduino)
 21├── 14_bit_operations/      # 비트 연산
 22├── 15_gpio_control/        # GPIO 제어 (Arduino)
 23└── 16_serial_comm/         # 시리얼 통신 (Arduino)
 24```
 25
 26## 컴파일 방법
 27
 28### C 프로그램 (데스크톱)
 29
 30```bash
 31# 기본 컴파일
 32gcc program.c -o program
 33
 34# 경고 포함
 35gcc -Wall -Wextra program.c -o program
 36
 37# 디버그 정보 포함
 38gcc -g program.c -o program
 39
 40# 최적화
 41gcc -O2 program.c -o program
 42```
 43
 44### 멀티스레드 프로그램
 45
 46```bash
 47# Linux
 48gcc program.c -o program -pthread
 49
 50# macOS
 51gcc program.c -o program -lpthread
 52```
 53
 54### Arduino 프로그램
 55
 56Arduino 프로그램(.ino)은 다음 방법으로 실행:
 57
 581. **Arduino IDE**
 59   - 파일 열기
 60   - 보드 선택 (Tools → Board → Arduino Uno)
 61   - 업로드 버튼 클릭
 62
 632. **Wokwi 시뮬레이터** (권장)
 64   - https://wokwi.com 접속
 65   - New Project → Arduino Uno
 66   - 코드 복사/붙여넣기
 67   - Start Simulation
 68
 693. **PlatformIO (VS Code)**
 70   ```bash
 71   pio run
 72   pio run --target upload
 73   ```
 74
 75## 각 프로젝트 설명
 76
 77| 프로젝트 | 난이도 | 주요 개념 |
 78|----------|--------|-----------|
 79| 02. 계산기 | ⭐ | 함수, switch-case, scanf |
 80| 03. 숫자 맞추기 | ⭐ | 반복문, 랜덤, 조건문 |
 81| 04. 주소록 | ⭐⭐ | 구조체, 배열, 파일 I/O |
 82| 05. 동적 배열 | ⭐⭐ | malloc, realloc, free |
 83| 06. 연결 리스트 | ⭐⭐⭐ | 포인터, 동적 자료구조 |
 84| 07. 파일 암호화 | ⭐⭐ | 파일 처리, 비트 연산 |
 85| 08. 스택/큐 | ⭐⭐ | 자료구조, LIFO/FIFO |
 86| 09. 해시 테이블 | ⭐⭐⭐ | 해싱, 충돌 처리 |
 87| 10. 뱀 게임 | ⭐⭐⭐ | 터미널 제어, 게임 루프 |
 88| 11. 미니 쉘 | ⭐⭐⭐⭐ | fork, exec, 파이프 |
 89| 12. 멀티스레드 | ⭐⭐⭐⭐ | pthread, 동기화 |
 90| 13. 임베디드 기초 | ⭐ | Arduino, GPIO |
 91| 14. 비트 연산 | ⭐⭐ | 비트 마스킹, 레지스터 |
 92| 15. GPIO 제어 | ⭐⭐ | LED, 버튼, 디바운싱 |
 93| 16. 시리얼 통신 | ⭐⭐ | UART, 명령어 파싱 |
 94
 95## 학습 순서
 96
 97### 초급
 981. 계산기
 992. 숫자 맞추기
1003. 주소록
101
102### 중급
1034. 동적 배열
1045. 연결 리스트
1056. 파일 암호화
1067. 스택과 큐
1078. 해시 테이블
108
109### 고급
1109. 뱀 게임
11110. 미니 쉘
11211. 멀티스레드
113
114### 임베디드 (Arduino)
11512. 임베디드 기초
11613. 비트 연산
11714. GPIO 제어
11815. 시리얼 통신
119
120## 실행 예시
121
122### 계산기
123```bash
124cd 02_calculator
125gcc calculator.c -o calculator
126./calculator
127```
128
129### 멀티스레드
130```bash
131cd 12_multithread
132gcc thread_basic.c -o thread_basic -pthread
133./thread_basic
134```
135
136### Arduino (Wokwi)
1371. 코드 복사
1382. https://wokwi.com 에서 새 프로젝트
1393. 붙여넣기 후 실행
140
141## 문제 해결
142
143### 컴파일 오류
144- `undefined reference to 'pthread_create'`: `-pthread` 플래그 추가
145- `implicit declaration of function`: 헤더 파일 추가
146- `permission denied`: `chmod +x program`
147
148### 실행 오류
149- Segmentation fault: 포인터 확인, valgrind 사용
150- Bus error: 잘못된 메모리 접근
151- Memory leak: valgrind로 확인
152
153## 추가 자료
154
155- [C Reference](https://en.cppreference.com/w/c)
156- [Arduino Reference](https://www.arduino.cc/reference/en/)
157- [Wokwi Simulator](https://wokwi.com)