구조체와 열거형은 Swift 프로그래밍에서 중요한 부분을 차지합니다. 제대로 된 컨벤션과 스타일 가이드를 준수하여 코드를 작성하면, 코드의 가독성과 유지보수성을 향상시킬 수 있습니다. 이번 포스트에서는 구조체와 열거형을 사용할 때 준수해야하는 컨벤션과 스타일 가이드에 대해 알아보겠습니다.
1. 네이밍 컨벤션
1.1 Camel Case
구조체와 열거형의 이름은 camel case를 사용해야 합니다. 이는 각 단어의 첫 글자를 대문자로 쓰고, 나머지는 소문자로 쓰되 단어와 단어 사이에는 대문자를 사용하는 방식입니다. 예를 들면 someStructure, anotherEnumeration 등이 있습니다.
1.2 명사 사용
구조체와 열거형의 이름은 명사로 지어야 합니다. 그렇기 때문에 클래스와 유사하게 명사로 표현되어야 하며, Upper Camel Case를 사용해야 합니다.
1.3 명확하고 간결한 이름 사용
구조체와 열거형의 이름은 명확하고 간결하게 작성되어야 합니다. 이름을 들여다봄으로써 해당 항목이 대략적으로 어떤 역할을 하는지 유추가 가능해야 합니다.
2. 멤버와 타입 선언
2.1 속성과 메소드
구조체와 열거형 내부의 속성과 메소드는 네이밍 컨벤션과 일관되게 작성되어야 합니다. 속성과 메소드의 이름 또한 camel case를 사용해야 하며, 명사의 역할을 하는 속성에는 명사를, 동작을 하는 메소드에는 동사를 사용해야 합니다.
2.2 의미 있는 이름 사용
멤버와 타입의 선언은 의미 있는 이름을 사용해야 합니다. 다른 개발자가 코드를 읽고 해당 멤버 또는 타입이 하는 일에 대해 명확하게 이해할 수 있어야 합니다.
3. 코드 스타일
3.1 들여쓰기
구조체와 열거형 내부의 코드는 깊이에 따라 들여쓰기를 해야 합니다. 일반적으로는 공백 4개 또는 탭을 사용하여 들여쓰기를 해야 합니다.
3.2 중괄호 위치
중괄호는 항상 새 줄에 시작해야 합니다. 그리고 중괄호는 여는 중괄호 바로 뒤에 공백을 넣어야 하며 닫는 중괄호는 같은 레벨에서 시작해야 합니다.
위의 컨벤션과 스타일 가이드를 준수하여 구조체와 열거형을 작성하면, 보다 명확하고 가독성 있는 코드를 얻을 수 있습니다. 이러한 컨벤션과 스타일 가이드는 Swift 커뮤니티에서 권장되는 것으로, 항상 이를 준수하기를 권장합니다.
참고자료: