22.03.10 [읽기 좋은 코드가 좋은 코드다] - 더스틴 보즈웰, 트레버 파우커

📍 책을 읽게 된 계기

 

팀 프로젝트 진행에 앞서 팀 규칙을 정하게 된다.

이때 변수명, 파일명 등 얕은 코드 스타일을 통일시켜놓고 시작할 수 있는데,

어떤 걸 기준으로 정해야되는지 모르겠더라.

읽기 편하다는 기준도 엉망이고 ..!!

팀 단위 작업을 할때 적어도 좋은 규칙을 제안할 수는 있어야겠다는 생각에 읽게 되었다.

 

---

💡 목차

1. 표면적 수준에서의 개선
     ✔ 이름에 정보 담기
     ✔ 오해할 수 없는 이름들
     ✔ 미학
     ✔ 주석에 담아야 하는 대상
     ✔ 명확하고 간결한 주석 달기 
2. 루프와 논리를 단순화하기
     ✔ 읽기 쉽게 흐름제어 만들기
     ✔ 거대한 표현을 잘게 쪼개기
     ✔ 변수와 가독성
3. 코드 재작성하기
     ✔ 상관없는 하위 문제 추출하기
     ✔ 한 번에 하나씩
     ✔ 생각을 코드로 만들기
     ✔ 코드 분량 줄이기
4. 선택된 주제들
     ✔ 테스트와 가독성
     ✔ 분/시간 카운터를 설계하고 구현하기

 

 

 ✔ 오해할 수 없는 이름들 

 

본인이 지은 이름을 "다른 사람들이 다른 의미로 해석할 수 있을까?" 라는 질문을 던지면서 항상 철저히 확인해야 한다.
--> 영어 공부 열심히 해야겠다 로 귀결 ...

 

 

• 경계가 포함된 한계값을 다룰 땐 min / max 사용

 

# 제한받는 대상의 이름 앞에 max_나 min_을 붙이면 좋음. 뜻이 명확해짐.
MAX_ITEMS_IN_CART = 10

if shopping_cart.num_items() > MAX_ITEMS_IN_CART:
  Error("Too many items in cart.")

 

 

• 경계가 포함된 범위에는 first / last 사용

 

# 범위 명시할 때 first/last 는 확실히 포함하고 있다는 느낌을 준다.
set.PrintKeys(first="Bart", last="Maggie")

 

 

• 경계 포함 or 배제하는 범위에는 begin / end 사용

 

# 10월 16일에 일어난 일을 모두 출력하고 싶을 때 !!
PrintEventsInRange("OCT 16 12:00am", "OCT 17 12:00am")

 

 

• 불리언 변수