C++ 코드 스타일

Qt Creator 은 Clang LibFormat 라이브러리를 사용하여 C++ 코드의 서식을 자동으로 지정하고 들여쓰기합니다. 프로젝트 또는 전체 조직에 코딩 스타일을 적용합니다.

C++ 에디터의 전역 들여쓰기 설정을 지정하려면 다음과 같이 하세요:

1. 환경설정 > C++ > Code Style 로 이동합니다.

   

2. Formatting mode 에서
   • Indenting Only 를 선택하면 코드만 들여쓰기됩니다.
   • Full Formatting 키보드 단축키 Ctrl+I를 사용하여 들여쓰기 대신 코드 서식을 지정하려면: 를 선택합니다.
   • Use Built-In Indenter 를 클릭하여 ClangFormat을 끕니다.
3. 큰 파일을 무시하여 구문 분석 속도를 높이려면 Ignore files greater than 을 선택합니다. 구문 분석할 파일의 최대 크기를 지정합니다.
4. 입력하는 동안 서식을 적용하려면 Format while typing 을 선택합니다.
5. 파일을 저장할 때 편집한 코드에 서식을 적용하려면 Format edited code on file save 을 선택합니다.

   파일을 저장하는 동안 이 설정을 일시적으로 비활성화하려면 File 으로 이동하여 Save Without Formatting 을 선택합니다.

6. 모든 프로젝트에 대해 ClangFormat 스타일을 전역적으로 변경하려면 Use custom settings 을 선택합니다.
7. Custom settings 에서 변경할 설정을 선택한 다음 Copy 을 선택합니다.
8. 설정에 이름을 지정하고 OK 을 선택합니다.
9. ClangFormat 에서 ClangFormat 스타일 옵션을 편집합니다. 실시간 미리보기는 환경설정이 들여쓰기를 어떻게 변경하는지 보여줍니다. 잘못된 값을 입력하면 경고 메시지가 표시됩니다.

내장 들여쓰기 사용

Formatting mode 에서 Use Built-In Indenter 을 선택하면 방법을 지정할 수 있습니다:

• Tab 및 백스페이스 키 누름을 해석합니다.
• 들여쓰기가 끝에 세미콜론이 필요 없는 완전한 문으로 해석하는 매크로를 추가합니다.
• 클래스, 함수, 블록 및 네임스페이스의 내용을 들여쓰기합니다.
• 클래스, 네임스페이스, 열거형, 함수 및 블록에서 중괄호를 들여쓰기합니다.
• 스위치 문과 그 내용을 제어합니다.
• 연속 줄을 정렬합니다.
• 유형 및 선언에서 포인터(*) 및 참조(&)를 식별자, 유형 이름 또는 왼쪽 또는 오른쪽 const 또는 volatile 키워드에 바인딩합니다.

콘텐츠에 대한 설정 지정

클래스 내에서 공개, 보호, 비공개 문과 이와 관련된 선언을 들여쓰기할 수 있습니다.

함수 내의 문과 블록 및 네임스페이스 내의 선언도 들여쓰기할 수 있습니다.

중괄호 설정 지정

클래스, 네임스페이스, 열거형, 함수 선언 및 코드 블록을 들여쓰기할 수 있습니다.

스위치 문에 대한 설정 지정

스위치 문 내에서 대/소문자 또는 기본 문이나 이와 관련된 문 또는 블록을 들여쓰기할 수 있습니다.

맞춤 지정

= 또는 += 과 같이 할당 뒤의 토큰에 연속 줄을 정렬하려면 Align after assignments 을 선택합니다. General 탭에서 연속 줄 정렬에 대한 추가 설정을 지정할 수 있습니다.

조건문에 공백을 추가하여 다음 줄과 정렬되지 않도록 할 수도 있습니다. 일반적으로 이는 if 문에만 영향을 줍니다.

바인딩 포인터 및 참조

유형 및 선언의 포인터(*)와 참조(&)를 식별자, 유형 이름 또는 왼쪽 또는 오른쪽 const 또는 volatile 키워드에 바인딩하려면 Pointers and References 탭에서 확인란을 선택합니다.

* 및 & 문자는 함수에 대한 포인터와 배열에 대한 포인터의 식별자에 자동으로 바인딩됩니다.

명령줄에서 ClangFormat 파일 만들기

명령줄에서 미리 정의된 특정 스타일의 구성 옵션이 있는 .clang-format 파일을 만들 수 있습니다. 예를 들어 LLVM 스타일에 대한 포맷 파일을 만들려면 다음 명령을 입력합니다:

clang-format -style=llvm -dump-config > .clang-format