feat(ko): add the Korean online edition (#2006)

* feat(ko): add the complete Korean online edition

* Use UTF-8 for Python CI output on Windows

* Remove print-book promotion from the Korean site

* fix(ko): preserve emphasis before Korean particles
This commit is contained in:
Yudong Jin
2026-10-29 03:46:43 +08:00
committed by GitHub
parent 71a773df64
commit 2f561d3d51
2072 changed files with 110884 additions and 102 deletions
@@ -0,0 +1,129 @@
"""
File: array_deque.py
Created Time: 2023-03-01
Author: krahets ([email protected])
"""
class ArrayDeque:
"""원형 배열로 구현한 덱"""
def __init__(self, capacity: int):
"""생성자"""
self._nums: list[int] = [0] * capacity
self._front: int = 0
self._size: int = 0
def capacity(self) -> int:
"""덱의 용량 반환"""
return len(self._nums)
def size(self) -> int:
"""덱의 길이 반환"""
return self._size
def is_empty(self) -> bool:
"""덱이 비어 있는지 판단"""
return self._size == 0
def index(self, i: int) -> int:
"""원형 배열 인덱스 계산"""
# 나머지 연산을 통해 배열의 처음과 끝을 연결한다
# i가 배열의 끝을 넘어가면 처음으로 돌아온다
# i가 배열의 처음을 넘어가면 끝으로 돌아온다
return (i + self.capacity()) % self.capacity()
def push_first(self, num: int):
"""맨 앞에 삽입"""
if self._size == self.capacity():
print("덱이 가득 찼다")
return
# 맨 앞 포인터를 왼쪽으로 한 칸 이동한다
# 나머지 연산을 통해 front가 배열의 처음을 넘어가면 끝으로 돌아오게 한다
self._front = self.index(self._front - 1)
# num을 맨 앞에 추가한다
self._nums[self._front] = num
self._size += 1
def push_last(self, num: int):
"""맨 뒤에 삽입"""
if self._size == self.capacity():
print("덱이 가득 찼다")
return
# 맨 뒤 인덱스 + 1을 가리키는 맨 뒤 포인터를 계산한다
rear = self.index(self._front + self._size)
# num을 맨 뒤에 추가한다
self._nums[rear] = num
self._size += 1
def pop_first(self) -> int:
"""맨 앞에서 꺼내기"""
num = self.peek_first()
# 맨 앞 포인터를 뒤로 한 칸 이동한다
self._front = self.index(self._front + 1)
self._size -= 1
return num
def pop_last(self) -> int:
"""맨 뒤에서 꺼내기"""
num = self.peek_last()
self._size -= 1
return num
def peek_first(self) -> int:
"""맨 앞 원소 접근"""
if self.is_empty():
raise IndexError("덱이 비어 있다")
return self._nums[self._front]
def peek_last(self) -> int:
"""맨 뒤 원소 접근"""
if self.is_empty():
raise IndexError("덱이 비어 있다")
# 마지막 원소의 인덱스를 계산한다
last = self.index(self._front + self._size - 1)
return self._nums[last]
def to_array(self) -> list[int]:
"""출력에 사용할 배열 반환"""
# 유효한 길이 범위 안의 리스트 원소만 변환한다
res = []
for i in range(self._size):
res.append(self._nums[self.index(self._front + i)])
return res
"""실행 코드"""
if __name__ == "__main__":
# 덱 초기화
deque = ArrayDeque(10)
deque.push_last(3)
deque.push_last(2)
deque.push_last(5)
print("덱 deque =", deque.to_array())
# 원소 접근
peek_first: int = deque.peek_first()
print("맨 앞 원소 peek_first =", peek_first)
peek_last: int = deque.peek_last()
print("맨 뒤 원소 peek_last =", peek_last)
# 큐에 원소 삽입
deque.push_last(4)
print("원소 4를 맨 뒤에 삽입한 후 deque =", deque.to_array())
deque.push_first(1)
print("원소 1을 맨 앞에 삽입한 후 deque =", deque.to_array())
# 큐에서 원소 꺼내기
pop_last: int = deque.pop_last()
print("맨 뒤에서 꺼낸 원소 =", pop_last, ", 맨 뒤에서 꺼낸 후 deque =", deque.to_array())
pop_first: int = deque.pop_first()
print("맨 앞에서 꺼낸 원소 =", pop_first, ", 맨 앞에서 꺼낸 후 deque =", deque.to_array())
# 덱의 길이 반환
size: int = deque.size()
print("덱 길이 size =", size)
# 덱이 비어 있는지 판단
is_empty: bool = deque.is_empty()
print("덱이 비어 있는가 =", is_empty)
@@ -0,0 +1,98 @@
"""
File: array_queue.py
Created Time: 2022-12-01
Author: Peng Chen ([email protected])
"""
class ArrayQueue:
"""원형 배열로 구현한 큐"""
def __init__(self, size: int):
"""생성자"""
self._nums: list[int] = [0] * size # 큐의 원소를 저장하는 배열
self._front: int = 0 # 맨 앞 원소를 가리키는 맨 앞 포인터
self._size: int = 0 # 큐 길이
def capacity(self) -> int:
"""큐의 용량 반환"""
return len(self._nums)
def size(self) -> int:
"""큐의 길이 반환"""
return self._size
def is_empty(self) -> bool:
"""큐가 비어 있는지 판단"""
return self._size == 0
def push(self, num: int):
"""큐에 삽입"""
if self._size == self.capacity():
raise IndexError("큐가 가득 찼다")
# 맨 뒤 인덱스 + 1을 가리키는 맨 뒤 포인터를 계산한다
# 나머지 연산을 통해 rear가 배열의 끝을 넘어가면 처음으로 돌아오게 한다
rear: int = (self._front + self._size) % self.capacity()
# num을 맨 뒤에 추가한다
self._nums[rear] = num
self._size += 1
def pop(self) -> int:
"""큐에서 꺼내기"""
num: int = self.peek()
# 맨 앞 포인터를 뒤로 한 칸 이동하고, 끝을 넘어가면 배열의 처음으로 돌아온다
self._front = (self._front + 1) % self.capacity()
self._size -= 1
return num
def peek(self) -> int:
"""맨 앞 원소 접근"""
if self.is_empty():
raise IndexError("큐가 비어 있다")
return self._nums[self._front]
def to_list(self) -> list[int]:
"""출력에 사용할 리스트 반환"""
res = [0] * self.size()
j: int = self._front
for i in range(self.size()):
res[i] = self._nums[(j % self.capacity())]
j += 1
return res
"""실행 코드"""
if __name__ == "__main__":
# 큐 초기화
queue = ArrayQueue(10)
# 큐에 원소 삽입
queue.push(1)
queue.push(3)
queue.push(2)
queue.push(5)
queue.push(4)
print("큐 queue =", queue.to_list())
# 맨 앞 원소 접근
peek: int = queue.peek()
print("맨 앞 원소 peek =", peek)
# 큐에서 원소 꺼내기
pop: int = queue.pop()
print("큐에서 꺼낸 원소 pop =", pop)
print("큐에서 꺼낸 후 queue =", queue.to_list())
# 큐의 길이 반환
size: int = queue.size()
print("큐 길이 size =", size)
# 큐가 비어 있는지 판단
is_empty: bool = queue.is_empty()
print("큐가 비어 있는가 =", is_empty)
# 원형 배열 테스트
for i in range(10):
queue.push(i)
queue.pop()
print("반복", i, "회에서 삽입 + 꺼내기를 수행한 후 queue = ", queue.to_list())
@@ -0,0 +1,72 @@
"""
File: array_stack.py
Created Time: 2022-11-29
Author: Peng Chen ([email protected])
"""
class ArrayStack:
"""배열로 구현한 스택"""
def __init__(self):
"""생성자"""
self._stack: list[int] = []
def size(self) -> int:
"""스택의 길이 반환"""
return len(self._stack)
def is_empty(self) -> bool:
"""스택이 비어 있는지 판단"""
return self.size() == 0
def push(self, item: int):
"""스택에 삽입"""
self._stack.append(item)
def pop(self) -> int:
"""스택에서 꺼내기"""
if self.is_empty():
raise IndexError("스택이 비어 있다")
return self._stack.pop()
def peek(self) -> int:
"""스택 맨 위 원소 접근"""
if self.is_empty():
raise IndexError("스택이 비어 있다")
return self._stack[-1]
def to_list(self) -> list[int]:
"""출력에 사용할 리스트 반환"""
return self._stack
"""실행 코드"""
if __name__ == "__main__":
# 스택 초기화
stack = ArrayStack()
# 스택에 원소 삽입
stack.push(1)
stack.push(3)
stack.push(2)
stack.push(5)
stack.push(4)
print("스택 stack =", stack.to_list())
# 스택 맨 위 원소 접근
peek: int = stack.peek()
print("스택 맨 위 원소 peek =", peek)
# 스택에서 원소 꺼내기
pop: int = stack.pop()
print("스택에서 꺼낸 원소 pop =", pop)
print("스택에서 꺼낸 후 stack =", stack.to_list())
# 스택의 길이 반환
size: int = stack.size()
print("스택의 길이 size =", size)
# 비어 있는지 판단
is_empty: bool = stack.is_empty()
print("스택이 비어 있는가 =", is_empty)
@@ -0,0 +1,42 @@
"""
File: deque.py
Created Time: 2022-11-29
Author: Peng Chen ([email protected])
"""
from collections import deque
"""실행 코드"""
if __name__ == "__main__":
# 덱 초기화
deq: deque[int] = deque()
# 큐에 원소 삽입
deq.append(2) # 맨 뒤에 추가한다
deq.append(5)
deq.append(4)
deq.appendleft(3) # 맨 앞에 추가한다
deq.appendleft(1)
print("덱 deque =", deq)
# 원소 접근
front: int = deq[0] # 맨 앞 원소
print("맨 앞 원소 front =", front)
rear: int = deq[-1] # 맨 뒤 원소
print("맨 뒤 원소 rear =", rear)
# 큐에서 원소 꺼내기
pop_front: int = deq.popleft() # 맨 앞 원소를 꺼낸다
print("맨 앞에서 꺼낸 원소 pop_front =", pop_front)
print("맨 앞에서 꺼낸 후 deque =", deq)
pop_rear: int = deq.pop() # 맨 뒤 원소를 꺼낸다
print("맨 뒤에서 꺼낸 원소 pop_rear =", pop_rear)
print("맨 뒤에서 꺼낸 후 deque =", deq)
# 덱의 길이 반환
size: int = len(deq)
print("덱 길이 size =", size)
# 덱이 비어 있는지 판단
is_empty: bool = len(deq) == 0
print("덱이 비어 있는가 =", is_empty)
@@ -0,0 +1,154 @@
"""
File: linkedlist_deque.py
Created Time: 2023-03-01
Author: krahets ([email protected])
"""
class ListNode:
"""이중 연결 리스트 노드"""
def __init__(self, val: int):
"""생성자"""
self.val: int = val
self.next: ListNode | None = None # 다음 노드 참조
self.prev: ListNode | None = None # 이전 노드 참조
class LinkedListDeque:
"""이중 연결 리스트로 구현한 덱"""
def __init__(self):
"""생성자"""
self._front: ListNode | None = None # 머리 노드 front
self._rear: ListNode | None = None # 꼬리 노드 rear
self._size: int = 0 # 덱의 길이
def size(self) -> int:
"""덱의 길이 반환"""
return self._size
def is_empty(self) -> bool:
"""덱이 비어 있는지 판단"""
return self._size == 0
def push(self, num: int, is_front: bool):
"""큐 삽입 연산"""
node = ListNode(num)
# 연결 리스트가 비어 있으면 front와 rear가 모두 node를 가리키게 한다
if self.is_empty():
self._front = self._rear = node
# 맨 앞에 삽입하는 연산
elif is_front:
# node를 연결 리스트의 맨 앞에 추가한다
self._front.prev = node
node.next = self._front
self._front = node # 머리 노드를 갱신한다
# 맨 뒤에 삽입하는 연산
else:
# node를 연결 리스트의 맨 뒤에 추가한다
self._rear.next = node
node.prev = self._rear
self._rear = node # 꼬리 노드를 갱신한다
self._size += 1 # 큐 길이를 갱신한다
def push_first(self, num: int):
"""맨 앞에 삽입"""
self.push(num, True)
def push_last(self, num: int):
"""맨 뒤에 삽입"""
self.push(num, False)
def pop(self, is_front: bool) -> int:
"""큐에서 꺼내는 연산"""
if self.is_empty():
raise IndexError("덱이 비어 있다")
# 큐의 길이가 1이면 머리와 꼬리가 같은 노드를 가리킨다
if self._size == 1:
val: int = self._front.val
self._front = None
self._rear = None
# 맨 앞에서 꺼내는 연산
elif is_front:
val: int = self._front.val # 머리 노드의 값을 임시로 저장한다
# 머리 노드를 삭제한다
fnext: ListNode | None = self._front.next
fnext.prev = None
self._front.next = None
self._front = fnext # 머리 노드를 갱신한다
# 맨 뒤에서 꺼내는 연산
else:
val: int = self._rear.val # 꼬리 노드의 값을 임시로 저장한다
# 꼬리 노드를 삭제한다
rprev: ListNode | None = self._rear.prev
rprev.next = None
self._rear.prev = None
self._rear = rprev # 꼬리 노드를 갱신한다
self._size -= 1 # 큐 길이를 갱신한다
return val
def pop_first(self) -> int:
"""맨 앞에서 꺼내기"""
return self.pop(True)
def pop_last(self) -> int:
"""맨 뒤에서 꺼내기"""
return self.pop(False)
def peek_first(self) -> int:
"""맨 앞 원소 접근"""
if self.is_empty():
raise IndexError("덱이 비어 있다")
return self._front.val
def peek_last(self) -> int:
"""맨 뒤 원소 접근"""
if self.is_empty():
raise IndexError("덱이 비어 있다")
return self._rear.val
def to_array(self) -> list[int]:
"""출력에 사용할 배열 반환"""
node = self._front
res = [0] * self.size()
for i in range(self.size()):
res[i] = node.val
node = node.next
return res
"""실행 코드"""
if __name__ == "__main__":
# 덱 초기화
deque = LinkedListDeque()
deque.push_last(3)
deque.push_last(2)
deque.push_last(5)
print("덱 deque =", deque.to_array())
# 원소 접근
peek_first: int = deque.peek_first()
print("맨 앞 원소 peek_first =", peek_first)
peek_last: int = deque.peek_last()
print("맨 뒤 원소 peek_last =", peek_last)
# 큐에 원소 삽입
deque.push_last(4)
print("원소 4를 맨 뒤에 삽입한 후 deque =", deque.to_array())
deque.push_first(1)
print("원소 1을 맨 앞에 삽입한 후 deque =", deque.to_array())
# 큐에서 원소 꺼내기
pop_last: int = deque.pop_last()
print("맨 뒤에서 꺼낸 원소 =", pop_last, ", 맨 뒤에서 꺼낸 후 deque =", deque.to_array())
pop_first: int = deque.pop_first()
print("맨 앞에서 꺼낸 원소 =", pop_first, ", 맨 앞에서 꺼낸 후 deque =", deque.to_array())
# 덱의 길이 반환
size: int = deque.size()
print("덱 길이 size =", size)
# 덱이 비어 있는지 판단
is_empty: bool = deque.is_empty()
print("덱이 비어 있는가 =", is_empty)
@@ -0,0 +1,97 @@
"""
File: linkedlist_queue.py
Created Time: 2022-12-01
Author: Peng Chen ([email protected])
"""
import sys
from pathlib import Path
sys.path.append(str(Path(__file__).parent.parent))
from modules import ListNode
class LinkedListQueue:
"""연결 리스트로 구현한 큐"""
def __init__(self):
"""생성자"""
self._front: ListNode | None = None # 머리 노드 front
self._rear: ListNode | None = None # 꼬리 노드 rear
self._size: int = 0
def size(self) -> int:
"""큐의 길이 반환"""
return self._size
def is_empty(self) -> bool:
"""큐가 비어 있는지 판단"""
return self._size == 0
def push(self, num: int):
"""큐에 삽입"""
# 꼬리 노드 뒤에 num을 추가한다
node = ListNode(num)
# 큐가 비어 있으면 머리와 꼬리 노드가 모두 해당 노드를 가리키게 한다
if self._front is None:
self._front = node
self._rear = node
# 큐가 비어 있지 않으면 해당 노드를 꼬리 노드 뒤에 추가한다
else:
self._rear.next = node
self._rear = node
self._size += 1
def pop(self) -> int:
"""큐에서 꺼내기"""
num = self.peek()
# 머리 노드를 삭제한다
self._front = self._front.next
self._size -= 1
return num
def peek(self) -> int:
"""맨 앞 원소 접근"""
if self.is_empty():
raise IndexError("큐가 비어 있다")
return self._front.val
def to_list(self) -> list[int]:
"""출력에 사용할 리스트로 변환"""
queue = []
temp = self._front
while temp:
queue.append(temp.val)
temp = temp.next
return queue
"""실행 코드"""
if __name__ == "__main__":
# 큐 초기화
queue = LinkedListQueue()
# 큐에 원소 삽입
queue.push(1)
queue.push(3)
queue.push(2)
queue.push(5)
queue.push(4)
print("큐 queue =", queue.to_list())
# 맨 앞 원소 접근
peek: int = queue.peek()
print("맨 앞 원소 front =", peek)
# 큐에서 원소 꺼내기
pop_front: int = queue.pop()
print("큐에서 꺼낸 원소 pop =", pop_front)
print("큐에서 꺼낸 후 queue =", queue.to_list())
# 큐의 길이 반환
size: int = queue.size()
print("큐 길이 size =", size)
# 큐가 비어 있는지 판단
is_empty: bool = queue.is_empty()
print("큐가 비어 있는가 =", is_empty)
@@ -0,0 +1,89 @@
"""
File: linkedlist_stack.py
Created Time: 2022-11-29
Author: Peng Chen ([email protected])
"""
import sys
from pathlib import Path
sys.path.append(str(Path(__file__).parent.parent))
from modules import ListNode
class LinkedListStack:
"""연결 리스트로 구현한 스택"""
def __init__(self):
"""생성자"""
self._peek: ListNode | None = None
self._size: int = 0
def size(self) -> int:
"""스택의 길이 반환"""
return self._size
def is_empty(self) -> bool:
"""스택이 비어 있는지 판단"""
return self._size == 0
def push(self, val: int):
"""스택에 삽입"""
node = ListNode(val)
node.next = self._peek
self._peek = node
self._size += 1
def pop(self) -> int:
"""스택에서 꺼내기"""
num = self.peek()
self._peek = self._peek.next
self._size -= 1
return num
def peek(self) -> int:
"""스택 맨 위 원소 접근"""
if self.is_empty():
raise IndexError("스택이 비어 있다")
return self._peek.val
def to_list(self) -> list[int]:
"""출력에 사용할 리스트로 변환"""
arr = []
node = self._peek
while node:
arr.append(node.val)
node = node.next
arr.reverse()
return arr
"""실행 코드"""
if __name__ == "__main__":
# 스택 초기화
stack = LinkedListStack()
# 스택에 원소 삽입
stack.push(1)
stack.push(3)
stack.push(2)
stack.push(5)
stack.push(4)
print("스택 stack =", stack.to_list())
# 스택 맨 위 원소 접근
peek: int = stack.peek()
print("스택 맨 위 원소 peek =", peek)
# 스택에서 원소 꺼내기
pop: int = stack.pop()
print("스택에서 꺼낸 원소 pop =", pop)
print("스택에서 꺼낸 후 stack =", stack.to_list())
# 스택의 길이 반환
size: int = stack.size()
print("스택의 길이 size =", size)
# 비어 있는지 판단
is_empty: bool = stack.is_empty()
print("스택이 비어 있는가 =", is_empty)
@@ -0,0 +1,39 @@
"""
File: queue.py
Created Time: 2022-11-29
Author: Peng Chen ([email protected])
"""
from collections import deque
"""실행 코드"""
if __name__ == "__main__":
# 큐 초기화
# Python에서는 일반적으로 덱 클래스 deque를 큐로 사용한다
# queue.Queue()는 전용 큐 클래스이지만 사용하기가 그다지 편리하지 않다
que: deque[int] = deque()
# 큐에 원소 삽입
que.append(1)
que.append(3)
que.append(2)
que.append(5)
que.append(4)
print("큐 que =", que)
# 맨 앞 원소 접근
front: int = que[0]
print("맨 앞 원소 front =", front)
# 큐에서 원소 꺼내기
pop: int = que.popleft()
print("큐에서 꺼낸 원소 pop =", pop)
print("큐에서 꺼낸 후 que =", que)
# 큐의 길이 반환
size: int = len(que)
print("큐 길이 size =", size)
# 큐가 비어 있는지 판단
is_empty: bool = len(que) == 0
print("큐가 비어 있는가 =", is_empty)
@@ -0,0 +1,36 @@
"""
File: stack.py
Created Time: 2022-11-29
Author: Peng Chen ([email protected])
"""
"""실행 코드"""
if __name__ == "__main__":
# 스택 초기화
# Python에는 내장 스택 클래스가 없으므로 list를 스택으로 사용할 수 있다
stack: list[int] = []
# 스택에 원소 삽입
stack.append(1)
stack.append(3)
stack.append(2)
stack.append(5)
stack.append(4)
print("스택 stack =", stack)
# 스택 맨 위 원소 접근
peek: int = stack[-1]
print("스택 맨 위 원소 peek =", peek)
# 스택에서 원소 꺼내기
pop: int = stack.pop()
print("스택에서 꺼낸 원소 pop =", pop)
print("스택에서 꺼낸 후 stack =", stack)
# 스택의 길이 반환
size: int = len(stack)
print("스택의 길이 size =", size)
# 비어 있는지 판단
is_empty: bool = len(stack) == 0
print("스택이 비어 있는가 =", is_empty)