이 페이지에서

C++ 코드 스타일

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

C++ 편집기의 전체 들여쓰기 설정을 지정하려면 ‘ Preferences ’ > ‘ C++ ’ > ‘ Code Style ’로 이동하십시오.

다음 표에는 사용 가능한 환경 설정이 설명되어 있습니다.

환경 설정설명
Formatting mode선택:
  • Indenting Only 코드만 들여쓰기하려면.
  • Full Formatting Ctrl+I 키보드 단축키를 사용하여 들여쓰기 대신 코드 서식을 지정하려면.
  • Use Built-In Indenter ClangFormat을 비활성화하려면.
Ignore files greater than대용량 파일을 무시하여 구문 분석 속도를 높입니다. 구문 분석할 파일의 최대 크기를 지정합니다.
Format while typing입력하는 동안 서식을 적용합니다.
Format edited code on file save파일을 저장할 때 편집된 코드에 서식을 적용합니다. 파일을 저장하는 동안 이 설정을 일시적으로 비활성화하려면, ‘ File ’로 이동하여 ‘ Save Without Formatting ’를 선택하십시오.
Use custom settings모든 프로젝트에 대해 ClangFormat 스타일을 전역적으로 변경합니다.
Custom settings변경할 설정을 선택한 다음, ‘ Copy ’를 선택합니다. 설정에 이름을 지정하고 ‘ OK ’를 선택합니다.
ClangFormatClangFormat 스타일 옵션을 편집합니다. 실시간 미리 보기에서 환경 설정이 들여쓰기를 어떻게 변경하는지 확인할 수 있습니다. 유효하지 않은 값을 입력하면 경고 메시지가 표시됩니다.

내장 인덴터 사용

내장 인덴터에 대한 코드 스타일 환경 설정

Formatting mode 에서 ‘ Use Built-In Indenter ’를 선택하면 다음을 지정할 수 있습니다:

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

내용에 대한 설정 지정

클래스 내에서 public, protected 및 private 문과 이와 관련된 선언의 들여쓰기를 지정할 수 있습니다.

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

C++ 환경 설정의 ‘코드 스타일’ 탭 내 ‘콘텐츠’ 탭

중괄호에 대한 설정 지정

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

C++ 환경 설정의 ‘코드 스타일’ 탭 내 ‘브레이스’ 탭

switch 문에 대한 설정 지정

switch 문 내에서 case 또는 default 문, 또는 이와 관련된 문이나 블록을 들여쓰기할 수 있습니다.

C++ 환경 설정의 ‘코드 스타일’ 탭 내 ‘switch’ 탭

정렬 설정

= 이나 += 과 같은 할당문 이후의 연속 행을 토큰과 정렬하려면 ‘ Align after assignments ’을 선택하십시오. ‘ General ’ 탭에서 연속 행 정렬에 대한 추가 설정을 지정할 수 있습니다.

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

C++ 환경 설정의 ‘코드 스타일’ 탭 내 ‘정렬’ 탭

포인터 및 참조 바인딩

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

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

C++ 환경 설정의 ‘코드 스타일’ 탭 내 ‘포인터 및 참조’ 탭

명령줄에서 ClangFormat 파일 생성

명령줄에서 미리 정의된 특정 스타일의 구성 옵션을 가진 .clang-format 파일을 생성할 수 있습니다. 예를 들어, LLVM 스타일의 포맷 파일을 생성하려면 다음 명령을 입력하십시오:

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

‘텍스트 또는 코드 들여쓰기’, ‘코드 스타일 지정’, ‘동작’, Qt Quick 코드 스타일 지정’ 및 ‘Nim’항목도 참조하십시오 .

Copyright © The Qt Company Ltd. and other contributors. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.