본문 바로가기
Coding/Book

클린코드 1장

by broheat 2022. 3. 2.

의미 있는 이름 [21-38]

변수, 함수, 클래스의 존재 이유? 수행 기능? 사용방법에 대한 답을 할수 있는 이름으로 짓자.

코드만 봐도 맥락이 보이도록 하자.

코드의 의미를 흐리는 단어를 넣지 말자.

이름이 달라야 한다면 의미도 달라야 한다.

루프에서 반복 횟수를 세는 변수 i, j, k 는 괜찮다.

클래스와 객체 이름은 명사나 명사구가 적합하다.

[32] Manager, Processor, Data, Info 등과 같은 단어는 피하자.

? = 위 단어는 명사나 명사구 인데 왜 피해야 하는 걸까?

 

메서드 이름은 동사나 동사구가 적합하다.

[32] 생성자를 중복정의 할 때는 정적 팩토리 메서드를 사용한다. 메서드는 인수를 설명하는 이름을 사용한다.

Complex fulcrumPoint = Complex.FromRealNumber(23.0);
// 위 코드가 아래 코드 보다 좋다.
Complex fulcrumPoint = new Complex(23.0);

? = 무슨 뜻인지 모르겠다.

 

접두어를 사용하면 맥락이 좀 더 분명해지지만, 클래스를 생성하여 클래스 내에 변수를 넣자.

💡 addrFirstName, addrLastName, addrState 도 좋지만,
그것보다 더 좋은 것은 addr 클래스를 생성하고 클래스 변수에 firstName을 넣는 것이다.

 

 

댓글