EXAMPLES_LIST.md - Examples

  1# 작성된 예제 코드 목록
  2
  3## C 프로그램 (데스크톱/콘솔)
  4
  5### ✅ 02. 계산기
  6- **파일**: `02_calculator/calculator.c`
  7- **컴파일**: `gcc calculator.c -o calculator`
  8- **실행**: `./calculator`
  9- **내용**: 기본 사칙연산 계산기, 함수와 switch-case 사용
 10
 11### ✅ 03. 숫자 맞추기 게임
 12- **파일**: `03_number_guess/number_guess.c`
 13- **컴파일**: `gcc number_guess.c -o number_guess`
 14- **실행**: `./number_guess`
 15- **내용**: 1-100 사이 숫자 맞추기, rand() 사용
 16
 17### ✅ 05. 동적 배열
 18- **파일**: `05_dynamic_array/dynamic_array.c`
 19- **컴파일**: `gcc dynamic_array.c -o dynamic_array`
 20- **실행**: `./dynamic_array`
 21- **내용**: malloc/realloc을 이용한 동적 배열 구현
 22
 23**실행 결과 예시:**
 24```
 25=== 동적 배열 테스트 ===
 26
 27요소 추가: 10, 20, 30, 40, 50
 28용량 확장: 2 -> 4
 29용량 확장: 4 -> 8
 30배열: [10, 20, 30, 40, 50]
 31크기: 5, 용량: 8
 32```
 33
 34### ✅ 06. 연결 리스트
 35- **파일**: `06_linked_list/linked_list.c`
 36- **컴파일**: `gcc linked_list.c -o linked_list`
 37- **실행**: `./linked_list`
 38- **내용**: 단일 연결 리스트 구현, 추가/삭제/검색
 39
 40### ✅ 12. 멀티스레드
 41- **파일**: `12_multithread/thread_basic.c`
 42- **컴파일**: `gcc thread_basic.c -o thread_basic -pthread`
 43- **실행**: `./thread_basic`
 44- **내용**: pthread를 이용한 기본 멀티스레딩
 45
 46### ✅ 14. 비트 연산
 47- **파일**: `14_bit_operations/bit_manipulation.c`
 48- **컴파일**: `gcc bit_manipulation.c -o bit_manipulation`
 49- **실행**: `./bit_manipulation`
 50- **내용**: 비트 마스킹, SET/CLEAR/TOGGLE/GET
 51
 52**실행 결과 예시:**
 53```
 54=== 비트 조작 예제 ===
 55
 56초기값: 1011 0010 (0xB2, 178)
 57
 58비트 3 설정 (SET_BIT):
 59  결과: 1011 1010 (0xBA)
 60
 61비트 5 해제 (CLEAR_BIT):
 62  결과: 1001 1010 (0x9A)
 63```
 64
 65---
 66
 67## Arduino 프로그램 (.ino)
 68
 69### ✅ 13. LED 깜빡이기 (Blink)
 70- **파일**: `13_embedded_basic/blink.ino`
 71- **플랫폼**: Arduino Uno
 72- **시뮬레이터**: https://wokwi.com
 73- **내용**: 가장 기본적인 Arduino 프로그램, LED 1초 간격 깜빡임
 74
 75**Wokwi 실행 방법:**
 761. https://wokwi.com 접속
 772. New Project → Arduino Uno
 783. 코드 복사/붙여넣기
 794. Start Simulation
 80
 81### ✅ 15. 버튼으로 LED 제어
 82- **파일**: `15_gpio_control/button_led.ino`
 83- **플랫폼**: Arduino Uno
 84- **내용**: 버튼 누를 때마다 LED 토글, 디바운싱 포함
 85
 86**회로 구성 (Wokwi):**
 87- 버튼: 핀 2 ↔ GND
 88- LED: 핀 13 (내장 LED)
 89
 90### ✅ 16. 시리얼 계산기
 91- **파일**: `16_serial_comm/serial_calculator.ino`
 92- **플랫폼**: Arduino Uno
 93- **내용**: 시리얼 모니터로 수식 입력받아 계산
 94
 95**사용 예시:**
 96```
 97Simple Serial Calculator
 98Enter expression (e.g., 10 + 5)
 99---------------------------------
10010 + 5
10110 + 5 = 15.00
102---------------------------------
10320 * 3
10420 * 3 = 60.00
105```
106
107---
108
109## 일괄 컴파일
110
111### 모든 C 프로그램 컴파일
112```bash
113cd examples
114make c-programs
115```
116
117### 멀티스레드 프로그램만 컴파일
118```bash
119make thread-programs
120```
121
122### 모두 컴파일
123```bash
124make
125```
126
127### 정리
128```bash
129make clean
130```
131
132### 개별 실행
133```bash
134make run-calculator   # 계산기 실행
135make run-guess        # 숫자 맞추기 실행
136make run-array        # 동적 배열 실행
137make run-list         # 연결 리스트 실행
138make run-bit          # 비트 연산 실행
139make run-thread       # 스레드 실행
140```
141
142---
143
144## 추가 예정 예제
145
146다음 예제들은 학습 문서에 있지만 아직 코드 파일로 작성되지 않았습니다:
147
148### 예정 목록
149- [ ] 04. 주소록 (address_book.c)
150- [ ] 07. 파일 암호화 (file_crypto.c)
151- [ ] 08. 스택과 큐 (stack_queue.c)
152- [ ] 09. 해시 테이블 (hash_table.c)
153- [ ] 10. 뱀 게임 (snake_game.c)
154- [ ] 11. 미니 쉘 (minishell.c)
155
156이 예제들은 학습 문서의 전체 코드를 참고하여 작성할 수 있습니다.
157
158---
159
160## 테스트 완료 상태
161
162| 예제 | 컴파일 | 실행 | 상태 |
163|------|--------|------|------|
164| calculator | ✅ | ✅ | 정상 동작 |
165| number_guess | ✅ | ⏸️ | 인터랙티브 |
166| dynamic_array | ✅ | ✅ | 정상 동작 |
167| linked_list | ✅ | ✅ | 정상 동작 |
168| thread_basic | ✅ | ⏸️ | pthread 필요 |
169| bit_manipulation | ✅ | ✅ | 정상 동작 |
170| blink.ino | - | 🌐 | Wokwi 시뮬레이터 |
171| button_led.ino | - | 🌐 | Wokwi 시뮬레이터 |
172| serial_calculator.ino | - | 🌐 | Wokwi 시뮬레이터 |
173
174✅ = 테스트 완료
175⏸️ = 인터랙티브/특수 환경 필요
176🌐 = 웹 시뮬레이터