2.3.4 오타 이상의 타입

코드에 주석을 남기는 것은 꽤나 귀찮은 일이기 때문에 나는 주석을 다는 것을 반대한다. 잠깐, 내게 키보드를 집어던지기 전에 뒤에 나올 부분까지 읽어주길 바란다. 코드에 주석을 달지 않더라도 코드 자체만으로 충분히 설명할 수 있다. 특히 데이터 타입은 코드 설명에 도움을 줄 수 있다.

거대한 지하 감옥과 같은 여러분의 프로젝트 코드 베이스에서 다음과 같은 코드를 만났다고 생각해 보자.

public int Move(int from, int to) {
    // 실제 코드
    return 0;
}

이 함수는 무슨 작업을 위한 걸까? 무엇이 움직인다는 것일까? 매개변수는 무엇을 의미할까? 함수의 반환 결과는 무엇을 의미할까? 타입에 대해 명시하지 않으면 이러한 질문에 대한 답을 얻기가 어려울 것이다. 코드를 분석해 보거나 이를 포함하고 있는 클래스를 찾아 볼 수도 있다. 하지만 시간이 걸릴 것이다. 경험으로 비추어 볼 때 이름을 더 잘 짓는다면 훨씬 더 나아진다.

public int MoveContents(int fromTopicId, int toTopicId) {
    // 실제 코드
    return 0;
}