📘클린코드 (2022.01.26) - 함수 (1)

DAY 6

오늘 읽은 범위

3장 함수 ~ 54p

😃 책에서 기억하고 싶은 내용을 써보세요.

• 작게 만들어라

  • 글쓴이의 오랜 경험을 통한 결론은 함수는 20줄도 길다!
  • 중첩 구조는 1단이나 2단을 넘어서면 안된다.

• 한 가지만 해라!

  • 1장부터 꾸준히 나온 말이지만 한 가지 함수는 한 가지를 해야하고 그것을 잘해야한다.
  • 한 가지라는 것은 추상화 수준이 하나인 단계만을 수행한다는 것이다.
  • 한 가지 작업만 하는 함수는 여러 섹션으로 나눌 수 없으므로 이런 방식으로 판단하는 것도 좋다.

• 함수 당 추상화 수준은 하나로!

  • 한 함수에서 추상화 수준이 높은(예.getfunc()) 코드와 추상화 수준이 낮은(예. console.log(text)) 코드가 같이 있으면 좋지 않다.
  • 위에서 아래로 코드 읽기 : 내려가기 규칙
    • 코드는 위에서 아래로 이야기처럼 읽혀야 좋다.
    • 이러기 위해선 함수 추상화 수준이 위에서부터 한단계씩 낮아져야 한다.

• Switch문

  • Switch문은 본질적으로 N가지를 처리하게 만들어 졌기 때문에 switch문을 완전히 피할 방법은 없다.
  • 하지만 저차원 클래스 문에 Switch 구문을 구현하고 절대 반복하지 않는 방법은 있다.

• 서술적인 이름을 사용하라!

  • 코드의 이름을 읽고 기능을 짐작했을 때 실제로 코드가 그 기능을 수행한다면 좋은 이름이다.
  • 길고 서술적인 이름이 짧고 어려운 이름보다 좋고, 길고 서술적인 주석보다 좋다.
  • 함수 이름을 정할때엔 여러 단어가 쉽게 읽히는 명명법을 사용하고 그 다음 여러 단어를 사용해 함수 기능을 잘 표현하는 이름을 지어야 한다.
  • 이름을 붙일 때엔 일관성이 있어야 한다.

• 함수 인수

  • 함수에서 이상적인 인수의 개수는 적을 수록 좋다. (0개 > 1개 > 2개... 4개부턴 금지!)
  • 인수는 함수의 의미를 이해하기 어렵게 만든다.
  • 단항 형식
    • 인수에 질문을 던질 때(fileExists("File"))
    • 인수를 뭔가로 변환하고 싶을 때(fileOpen("File"))
    • 이벤트 함수
    • 이 세가지가 아니라면 단항 함수는 가급적 피해야 한다.
  • 플래그 인수
    • 플래그 인수는 인자의 값에 따라 함수가 다른 연산을 하게 만든다.
    • 이 말은 '함수는 한 가지 역할을 해야한다'는 규칙에 위배 되기 때문에 플래그 인수는 되도록이면 사용하면 안된다.
  • 이항 함수
    • 만약 x, y좌표를 필요로 하는 함수라면 2개의 인수를 받는것이 더 일반적일 것이다.
      이 두 좌표에는 자연적인 순서도 있어 헷갈일 일이 없다.
    • 그런데 assertEquals(expected, actual) 같은 함수는 인수 사이에 자연적인 순서가 없다.
      때문에 expected, actual 의 순서를 기억해야하고 이런 부분에서 오류가 발생하기 쉽다.
  • 인수 객체
    • function makeCircle(x, y, radius) ==> function makeCircle(center, radius)
    • 위 예시처럼 x, y를 객체로 만들어 인수를 줄이는 방법도 있다.

🙄오늘 읽은 소감은? 떠오르는 생각을 가볍게 적어보세요

• 인수는 어렵다. 함수를 이해하려 인수를 보면 인수를 건네준 함수를 또 이해하고 기억해야한다. 나는 이게 어쩔 수 없는 일이라 생각했는데 책에선 이러한 코드를 구현하지 않는 것이 좋다고 한다. 아직 어떤식으로 구현하면 이를 해결 할 수 있을지 감이 오지 않지만 계속 공부하다보면 언젠간 이해하게 될 것이라 생각한다.

• 책이 점점 어려워진다.. 글쓴이가 주장하는 내용 자체는 쉽게 납득할 수 있지만 예시로 드는 코드들을 보면 잘 읽히지 않는다. 또한 영어실력이 부족해서 글쓴이가 이름의 의미를 쉽게 표현한 것도 하나하나 사전에서 찾아 의미를 이해해야한다. 아직 갈길이 멀지만 확실히 배우는점은 있는 것 같다.

🔎 궁금한 내용이 있거나, 잘 이해되지 않는 내용이 있다면 적어보세요.

• 글쓴이는 p.24에선 '서로 흡사한 이름을 사용하지 말라' 말했지만 p.50에선 '이름을 붙일 때는 일관성이 있어야 한다'라고 한다. 예시로 적어놓은 함수명들도 정말 서로 흡사한 이름을 가지고 있다.. 잘 이해가 가지 않는다.

• 플래그 인수란? ==> A flag argument is a kind of function argument that tells the function to carry out a different operation depending on its value.
  즉, 인자의 값에 따라서 함수가 다른 연산(기능)을 하게 만드는 것이 플래그 인수입니다.
  (https://martinfowler.com/bliki/FlagArgument.html)

✏ 소감 3줄 요약

• 계속 강조하지만 함수는 한가지 기능만, 또한 줄일 수 있으면 최대한 줄여야 한다.
• https://velog.io/@eddy_song/alan-kay-OOP 오늘 읽었던 객체 지향을 설명하는 매우 좋은 포스터였다. 이 블로그의 내용과 오늘 책에서 읽은 내용을 같이보니 뭔가 더 깊은 이해를 할 수 있었다.
• 지금까지 프로그램을 작성할때엔 매개변수를 받지 않는 함수는 거의 구현하지 않았었다. 그런데 인수가 0개인 함수가 가장 좋다니.. 충격이다.