<QtGlobal> - Global Qt Declarations
<QtGlobal> 헤더 파일에는 다양한 다른 헤더가 포함되어 있습니다. 더 보기...
| Header: | #include <QtGlobal> |
Macros
(since 6.8) | QT_ENABLE_STRICT_MODE_UP_TO |
(since 6.0) | QT_NO_FOREACH |
| QT_NO_KEYWORDS |
자세한 설명
Qt 6.5까지, 대부분의 Qt 헤더 파일은 <QtGlobal>을 포함했습니다. Qt 6.5 이전에는 <QtGlobal>이 여러 가지 전역 선언을 정의했습니다. Qt 6.5에서는 이 대부분이 별도의 헤더로 옮겨져 소스 코드가 전체 구색이 아닌 필요한 것만 포함할 수 있게 되었습니다. 현재로서는 <QtGlobal>에 다른 헤더들이 포함되어 있지만(다음 섹션 참조), 향후 Qt 릴리스에서는 이러한 헤더 중 일부가 <QtGlobal>에서 제거되거나 버전 검사에 따라 포함 여부가 결정될 수 있습니다. 마찬가지로, 향후 릴리스에서는 현재 <QtGlobal>을 포함하는 일부 Qt 헤더가 더 이상 포함되지 않을 수도 있습니다. 이를 통해 사용하지 않는 전역 선언을 피함으로써 컴파일 시간을 개선할 수 있을 것으로 기대합니다.
<QtGlobal>에서 추출된 헤더 목록
| Header | 요약 |
|---|---|
| <QFlags> | 열거형 값을 결합하는 타입 안전 방식 |
| <QForeach> | Qt의 포리치 및 포에버 루프 구현 |
| <QFunctionPointer> | 포인터-함수 형을 위한 Typedef |
| <QApplicationStatic> | For Q_APPLICATION_STATIC |
| <QGlobalStatic> | 전역 정적 객체의 스레드 안전 초기화 |
| <QOverload> | 멤버 함수 과부하 해결을 위한 헬퍼 |
| <QSysInfo> | 시스템 정보를 얻기 위한 헬퍼 클래스 |
| <QTypeInfo> | 타입 정보를 얻기 위한 헬퍼 |
| <QtAssert> | Q_ASSERT 및 기타 런타임 검사 |
| <QtClassHelperMacros> | Qt 클래스 헬퍼 매크로 |
| <QtCompilerDetection> | 컴파일러 전용 매크로 정의 |
| <QtDeprecationMarkers> | 폐지 헬퍼 매크로 |
| <QtEnvironmentVariables> | 환경 변수 작업을 위한 헬퍼 |
| <QtExceptionHandling> | 예외 처리를 위한 헬퍼 |
| <QtLogging> | Qt 로깅 헬퍼 |
| <QtMalloc> | 메모리 할당 헬퍼 |
| <QtMinMax | 값 비교를 위한 헬퍼 |
| <QtNumeric> | 다양한 숫자 함수 |
| <QtPreprocessorSupport> | 전처리기 매크로 헬퍼 |
| <QtProcessorDetection> | 아키텍처별 매크로 정의 |
| <QtResource> | 리소스 초기화 및 정리를 위한 헬퍼 |
| <QtSwap> | qSwap()의 구현 |
| <QtSystemDetection> | 플랫폼별 매크로 정의 |
| <QtTranslation> | Qt 번역 헬퍼 |
| <QtTypeTraits> | Qt 형 특성 |
| <QtTypes> | Qt 기본 유형 선언 |
| <QtVersionChecks> | QT_VERSION_CHECK 및 관련 검사 |
| <QtVersion> | QT_VERSION_STR 와 qVersion() |
매크로 문서
[since 6.8] QT_ENABLE_STRICT_MODE_UP_TO
이 매크로를 정의하면 최적이 아니거나 위험한 것으로 간주되는 여러 Qt API가 비활성화됩니다.
이 매크로의 값은 QT_VERSION_CHECK 의 인코딩을 사용하여 Qt 버전으로 설정해야 합니다. 예를 들어, Qt 6.6으로 설정하려면 QT_ENABLE_STRICT_MODE_UP_TO=0x060600 을 정의합니다. 이렇게 하면 지정된 Qt 버전까지(그리고 그 버전 포함) 버전에서 도입된 API만 비활성화됩니다.
QT_DISABLE_DEPRECATED_UP_TO 매크로가 정의되어 있지 않으면 QT_ENABLE_STRICT_MODE_UP_TO도 동일한 값으로 정의됩니다.
이 매크로는 항상 프로젝트에서 지원하고자 하는 최소 Qt 버전으로 설정해야 합니다.
이 매크로로 비활성화된 API는 아래 표에 비활성화를 위해 사용해야 하는 최소값과 함께 나열되어 있습니다.
| 버전 | 비활성화된 API |
|---|---|
| 6.0.0 | foreach ( QT_NO_FOREACH 참조 ) |
| 6.0.0 | QString const char * / QByteArray 로의 전환 ( QT_NO_CAST_TO_ASCII 참조 ) |
| 6.0.0 | QByteArray const char * 로의 암시적 전환 ( QT_NO_CAST_FROM_BYTEARRAY 참조 ) |
| 6.0.0 | QUrl QString 에서의 암시적 전환 ( QT_NO_URL_CAST_FROM_STRING 참조 ) |
| 6.0.0 | 신호 슬롯 연결에서 좁은 변환 허용 ( QT_NO_NARROWING_CONVERSIONS_IN_CONNECT 참조 ) |
| 6.0.0 | Qt 컨테이너를 위한 자바 스타일 이터레이터 |
| 6.6.0 | qExchange() 함수 ( QT_NO_QEXCHANGE 참조 ) |
| 6.7.0 | 컨텍스트 객체를 취하지 않는 QObject::connect 의 오버로드 ( QT_NO_CONTEXTLESS_CONNECT 참조 ) |
| 6.8.0 | qAsConst() 함수 ( QT_NO_QASCONST 참조 ) |
| 6.8.0 | 파일 관련 I/O 클래스에는 open() 함수가 [[nodiscard]] 로 표시되어 있습니다 ( QT_USE_NODISCARD_FILE_OPEN 참조 ). |
| 6.9.0 | qsnprintf() 및 qvnprintf() 함수( QT_NO_QSNPRINTF 참조 ). |
또한 개별 API는 QT_DISABLE_DEPRECATED_UP_TO 의 설정에 따라 비활성화될 수도 있습니다. 자세한 내용은 각 클래스의 설명서를 참조하세요.
이 매크로는 Qt 6.8에 도입되었습니다.
QT_DISABLE_DEPRECATED_UP_TO, QT_NO_KEYWORDS, QT_VERSION_CHECK 를참조하세요 .
[since 6.0] QT_NO_FOREACH
이 매크로를 정의하면 Qt의 foreach 루프를 사용할 수 없게 됩니다.
이 매크로는 Qt 6.0에 도입되었습니다.
QT_NO_KEYWORDS 를참조하십시오 .
QT_NO_KEYWORDS
이 매크로를 정의하여 signals 및 slots 과 같이 일반적으로 활성화되는 Qt 특정 키워드를 비활성화합니다. 대신 Q_SIGNALS 및 Q_SLOTS 을 사용하십시오.
라이브러리는 이 매크로를 정의하여 공개 헤더에 Q_ 접두사가 없는 일반 키워드를 사용하지 않도록 해야 합니다.
QT_NO_FOREACH도 참조하세요 .
© 2025 The Qt Company Ltd. 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.
