<QtTypes> - Qt Type Declarations

<QtTypes> 헤더 파일에는 Qt의 기본 데이터형 선언이 포함되어 있습니다. 더 보기...

Header: #include <QtTypes>

형

	qint8
	qint16
	qint32
	qint64
`(since 6.6)`	qint128
	qintptr
	qlonglong
	qptrdiff
	qreal
	qsizetype
	quint8
	quint16
	quint32
	quint64
`(since 6.6)`	quint128
	quintptr
	qulonglong
	uchar
	uint
	ulong
	ushort

매크로

`(since 6.2)`	PRIXQUINTPTR
`(since 6.2)`
`(since 6.2)`	PRIdQINTPTR
`(since 6.2)`
`(since 6.2)`	PRIdQPTRDIFF
`(since 6.2)`
`(since 6.2)`	PRIdQSIZETYPE
`(since 6.2)`	PRIiQINTPTR
`(since 6.2)`	PRIiQPTRDIFF
`(since 6.2)`	PRIiQSIZETYPE
`(since 6.2)`
`(since 6.2)`	PRIoQUINTPTR
`(since 6.2)`	PRIuQUINTPTR
`(since 6.2)`	PRIxQUINTPTR
`(since 6.6)`	QT_SUPPORTS_INT128
`(since 6.6)` qint128	Q_INT128_C(literal)
`(since 6.6)`	Q_INT128_MAX
`(since 6.6)`	Q_INT128_MIN
qint64	Q_INT64_C(literal)
`(since 6.6)` quint128	Q_UINT128_C(literal)
`(since 6.6)`	Q_UINT128_MAX
quint64	Q_UINT64_C(literal)

상세 설명

이 헤더 파일은 Qt가 지원하는 모든 플랫폼에서 다양한 기본 유형에 대해 지정된 비트 크기를 보장하는 여러 유형 정의를 선언합니다. 예를 들어, ` qint8 `는 Qt가 지원하는 모든 플랫폼에서 8비트임을 보장하는 부호 있는 char입니다. 또한 이 헤더 파일은 ` long long int`에 대한 ` qlonglong ` 유형 정의를 선언합니다.

몇 가지 편리한 유형 정의도 선언되어 있습니다: ` qreal `(` double ` 또는 ` float`용), ` uchar `(` unsigned char`용), ` uint `(` unsigned int`용), ` ulong `(` unsigned long `용), ` ushort `(` unsigned short`용).

또한 이 헤더는 printf()나 qDebug()과 같은 서식 지정 출력 기능을 통해 일부 Qt 유형 별칭(qsizetype, qintptr 등)을 서식 지정 경고 없이, 그리고 형 변환 없이 출력할 수 있게 해주는 일련의 매크로를 제공합니다.

유형 문서

qint8

signed char 에 대한 typedef입니다. 이 유형은 Qt가 지원하는 모든 플랫폼에서 8비트임을 보장합니다.

qint16

signed short 에 대한 typedef입니다. 이 유형은 Qt가 지원하는 모든 플랫폼에서 16비트임을 보장합니다.

qint32

signed int 에 대한 typedef입니다. 이 유형은 Qt가 지원하는 모든 플랫폼에서 32비트임을 보장합니다.

qint64

long long int 에 대한 typedef입니다. 이 유형은 Qt가 지원하는 모든 플랫폼에서 64비트임을 보장합니다.

이 유형의 리터럴은 Q_INT64_C() 매크로를 사용하여 생성할 수 있습니다:

qint64 value = Q_INT64_C(932838457459459);

Q_INT64_C(), quint64 및 qlonglong도 참조하십시오 .

`[since 6.6]` qint128

이를 지원하는 플랫폼에서 ` __int128 `에 대한 `typedef` (이 경우 Qt는 ` QT_SUPPORTS_INT128 ` 매크로를 정의합니다).

Q_INT128_C() 매크로를 사용하여 이 유형의 리터럴을 생성할 수 있습니다.

이 typedef는 Qt 6.6에서 도입되었습니다.

Q_INT128_C(), Q_INT128_MIN, Q_INT128_MAX, quint128 및 QT_SUPPORTS_INT128도 참조하십시오 .

qintptr

부호 있는 정수형에서 포인터를 표현하기 위한 통합형(해싱 등에 유용함).

qint32 또는 qint64를 위한 typedef입니다. 이 유형은 Qt가 지원하는 모든 플랫폼에서 포인터와 동일한 크기를 갖도록 보장됩니다. 32비트 포인터를 사용하는 시스템에서는 qintptr이 qint32에 대한 typedef이며, 64비트 포인터를 사용하는 시스템에서는 qintptr이 qint64에 대한 typedef입니다.

qintptr는 부호 있는 유형이라는 점에 유의하십시오. 부호 없는 값의 경우 quintptr를 사용하십시오.

printf(), qDebug(), QString::asprintf() 등과 같은 서식 지정 출력 기능을 사용하여 이 유형의 값을 출력하려면, PRIdQINTPTR 및 PRIiQINTPTR 매크로를 서식 지정자로 사용할 수 있습니다. 이 두 매크로 모두 값을 10진수로 출력합니다.

qintptr p = 123;
printf("The pointer is %" PRIdQINTPTR "\n", p);

qptrdiff, qint32 및 qint64도 참조하십시오 .

qlonglong

long long int (Windows에서는__int64 )에 대한 typedef입니다. 이는 qint64 과 동일합니다.

qulonglong 및 qint64도 참조하십시오 .

qptrdiff

포인터의 차이를 표현하기 위한 정수형.

qint32 또는 qint64 중 하나를 위한 typedef입니다. 이 타입은 Qt가 지원하는 모든 플랫폼에서 포인터와 동일한 크기를 갖도록 보장됩니다. 32비트 포인터를 사용하는 시스템에서는 quintptr이 quint32의 typedef이며, 64비트 포인터를 사용하는 시스템에서는 quintptr이 quint64의 typedef입니다.

qptrdiff는 부호 있는 유형이라는 점에 유의하십시오. 부호 없는 값의 경우 quintptr을 사용하십시오.

printf(), qDebug(), QString::asprintf() 등과 같은 서식 지정 출력 기능을 사용하여 이 유형의 값을 출력하려면, PRIdQPTRDIFF 및 PRIiQPTRDIFF 매크로를 서식 지정자로 사용할 수 있습니다. 이 두 매크로는 모두 값을 10진수로 출력합니다.

qptrdiff d = 123;
printf("The difference is %" PRIdQPTRDIFF "\n", d);

quintptr, qint32 및 qint64도 참조하십시오 .

qreal

Qt가 ‘ -qreal float ’ 옵션으로 구성되지 않은 경우, ` double `에 대한 `typedef`입니다.

`[alias]` qsizetype

모든 플랫폼에서 POSIX의 ` ssize_t `를 제공하는 통합형 데이터형입니다.

이 타입은 Qt가 지원하는 모든 플랫폼에서 ` size_t `와 동일한 크기를 가짐이 보장됩니다.

qsizetype은 부호 있는 유형이라는 점에 유의하십시오. 부호 없는 값의 경우 size_t 을 사용하십시오.

printf(), qDebug(), QString::asprintf() 등과 같은 서식 지정 출력 기능을 사용하여 이 유형의 값을 출력하려면, 서식 지정자로 PRIdQSIZETYPE 및 PRIiQSIZETYPE 매크로를 사용할 수 있습니다. 이 두 매크로는 모두 값을 10진수로 출력합니다.

qsizetype s = 123;
printf("The size is %" PRIdQSIZETYPE "\n", s);

qptrdiff도 참조하십시오 .

quint8

unsigned char 에 대한 typedef입니다. 이 유형은 Qt가 지원하는 모든 플랫폼에서 8비트임을 보장합니다.

quint16

unsigned short 에 대한 typedef입니다. 이 유형은 Qt가 지원하는 모든 플랫폼에서 16비트임을 보장합니다.

quint32

unsigned int 에 대한 typedef입니다. 이 유형은 Qt가 지원하는 모든 플랫폼에서 32비트임을 보장합니다.

quint64

unsigned long long int 에 대한 typedef입니다. 이 유형은 Qt가 지원하는 모든 플랫폼에서 64비트임을 보장합니다.

이 유형의 리터럴은 Q_UINT64_C() 매크로를 사용하여 생성할 수 있습니다:

quint64 value = Q_UINT64_C(932838457459459);

Q_UINT64_C(), qint64 및 qulonglong도 참조하십시오 .

`[since 6.6]` quint128

이를 지원하는 플랫폼에서 ` unsigned __int128 `에 대한 `typedef` (이 경우 Qt는 ` QT_SUPPORTS_INT128 ` 매크로를 정의합니다).

Q_UINT128_C() 매크로를 사용하여 이 유형의 리터럴을 생성할 수 있습니다.

이 typedef는 Qt 6.6에서 도입되었습니다.

Q_UINT128_C(), Q_UINT128_MAX, qint128 및 QT_SUPPORTS_INT128도 참조하십시오 .

quintptr

포인터를 부호 없는 정수로 표현하기 위한 통합형(해싱 등에 유용함).

quint32 또는 quint64에 대한 typedef입니다. 이 유형은 Qt가 지원하는 모든 플랫폼에서 포인터와 동일한 크기를 가짐이 보장됩니다. 32비트 포인터를 사용하는 시스템에서는 quintptr이 quint32에 대한 typedef이며, 64비트 포인터를 사용하는 시스템에서는 quintptr이 quint64에 대한 typedef입니다.

quintptr은 부호 없는(unsigned) 유형이라는 점에 유의하십시오. 부호 있는(signed) 값의 경우 qptrdiff를 사용하십시오.

printf(), qDebug(), QString::asprintf() 등과 같은 서식 지정 출력 기능을 사용하여 이 유형의 값을 출력하려면 다음 매크로를 서식 지정자로 사용할 수 있습니다:

PRIuQUINTPTR: 값을 10진수로 출력합니다.
PRIoQUINTPTR: 값을 8진수로 출력합니다.
PRIxQUINTPTR: 값을 16진수로 출력하며, 소문자 a-f 문자를 사용합니다.
PRIXQUINTPTR: 값을 16진수로 출력하며, 대문자 A-F 를 사용합니다.

quintptr p = 123u;
printf("The pointer value is 0x%" PRIXQUINTPTR "\n", p);

qptrdiff, quint32 및 quint64도 참조하십시오 .

qulonglong

unsigned long long int (Windows에서는unsigned __int64 )에 대한 typedef입니다. 이는 quint64 과 동일합니다.

quint64 및 qlonglong도 참조하십시오 .

uchar

unsigned char 에 대한 편의를 위한 typedef입니다.

uint

unsigned int 에 대한 편의를 위한 typedef입니다.

ulong

unsigned long 에 대한 편의를 위한 typedef입니다.

ushort

unsigned short 에 대한 편의를 위한 typedef입니다.

매크로 설명서

`[since 6.2]` PRIdQINTPTR

`[since 6.2]` PRIiQINTPTR

qintptr 를 참조하십시오.

이 매크로들은 Qt 6.2에서 도입되었습니다.

`[since 6.2]` PRIdQPTRDIFF

`[since 6.2]` PRIiQPTRDIFF

qptrdiff를 참조하십시오.

이 매크로들은 Qt 6.2에서 도입되었습니다.

`[since 6.2]` PRIdQSIZETYPE

`[since 6.2]` PRIiQSIZETYPE

qsizetype을 참조하십시오.

이 매크로들은 Qt 6.2에서 도입되었습니다.

`[since 6.2]` PRIoQUINTPTR

`[since 6.2]` PRIuQUINTPTR

`[since 6.2]` PRIxQUINTPTR

`[since 6.2]` PRIXQUINTPTR

quintptr를 참조하십시오.

이 매크로들은 Qt 6.2에서 도입되었습니다.

`[since 6.6]` QT_SUPPORTS_INT128

플랫폼이 128비트 정수형을 지원하는 경우, Qt는 이 매크로와 함께 ` qint128 ` 및 ` quint128 ` 유형을 정의합니다.

이 매크로는 Qt 6.6에서 도입되었습니다.

qint128, quint128, Q_INT128_C(), Q_UINT128_C(), Q_INT128_MIN, Q_INT128_MAX 및 Q_UINT128_MAX항목도 참조하십시오 .

`[since 6.6]` qint128 Q_INT128_C(literal)

부호 있는 128비트 정수 literal 를 플랫폼에 구애받지 않는 방식으로 감쌉니다.

참고: Q_INT64_C()와 달리 , 이 매크로는 C++에서만 사용할 수 있으며 C에서는 사용할 수 없습니다. 이는 컴파일러가 이러한 리터럴을 내장 함수로 제공하지 않으며, C는 사용자 정의 리터럴을 지원하지 않기 때문입니다.

이 매크로는 Qt 6.6에서 도입되었습니다.

참조: qint128, Q_UINT128_C(), Q_INT128_MIN, Q_INT128_MAX, Q_INT64_C(), QT_SUPPORTS_INT128.

`[since 6.6]` Q_INT128_MAX

이 매크로는 ` qint128`에서 표현 가능한 최대 값을 나타내는 컴파일 시간 상수로 확장됩니다.

이 매크로는 C++ 및 C 모드 모두에서 사용할 수 있습니다.

이 매크로는 Qt 6.6에서 도입되었습니다.

Q_INT128_MIN, Q_UINT128_MAX, qint128, Q_INT128_C 및 QT_SUPPORTS_INT128도 참조하십시오 .

`[since 6.6]` Q_INT128_MIN

이 매크로는 qint128 에서 표현 가능한 최소 값을 나타내는 컴파일 시점 상수로 확장됩니다.

이 매크로는 C++ 및 C 모드 모두에서 사용할 수 있습니다.

이 매크로는 Qt 6.6에서 도입되었습니다.

Q_INT128_MAX, qint128, Q_INT128_C 및 QT_SUPPORTS_INT128도 참조하십시오 .

qint64 Q_INT64_C(literal)

부호 있는 64비트 정수 literal 를 플랫폼에 구애받지 않는 방식으로 감쌉니다.

예시:

qint64 value = Q_INT64_C(932838457459459);

qint64, Q_UINT64_C(), Q_INT128_C()도 참조하십시오 .

`[since 6.6]` quint128 Q_UINT128_C(literal)

플랫폼에 구애받지 않는 방식으로 부호 없는 128비트 정수 ` literal `를 감쌉니다.

참고: Q_UINT64_C()와 달리 , 이 매크로는 C++에서만 사용할 수 있으며 C에서는 사용할 수 없습니다. 이는 컴파일러가 이러한 리터럴을 내장 함수로 제공하지 않으며, C는 사용자 정의 리터럴을 지원하지 않기 때문입니다.

이 매크로는 Qt 6.6에서 도입되었습니다.

quint128, Q_INT128_C(), Q_UINT128_MAX, Q_UINT64_C(), QT_SUPPORTS_INT128도 참조하십시오 .

`[since 6.6]` Q_UINT128_MAX

이 매크로는 ` quint128`에서 표현 가능한 최대 값을 나타내는 컴파일 시점 상수로 확장됩니다.

이 매크로는 C++ 및 C 모드 모두에서 사용할 수 있습니다.

quint128 의 최소값은 0(영)이므로, Q_UINT128_MIN 는 필요하지 않으며 제공되지도 않습니다.

이 매크로는 Qt 6.6에서 도입되었습니다.

Q_INT128_MAX, quint128, Q_UINT128_C 및 QT_SUPPORTS_INT128도 참조하십시오 .

quint64 Q_UINT64_C(literal)

literal 의 부호 없는 64비트 정수를 플랫폼에 구애받지 않는 방식으로 감쌉니다.

예시:

quint64 value = Q_UINT64_C(932838457459459);

quint64, Q_INT64_C() 및 Q_UINT128_C()도 참조하십시오 .

© 2026 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.

<QtTypes> - Qt Type Declarations

형

매크로

상세 설명

유형 문서

qint8

qint16

qint32

qint64

[since 6.6] qint128

qintptr

qlonglong

qptrdiff

qreal

[alias] qsizetype

quint8

quint16

quint32

quint64

[since 6.6] quint128

quintptr

qulonglong

uchar

uint

ulong

ushort

매크로 설명서

[since 6.2] PRIdQINTPTR

[since 6.2] PRIiQINTPTR

[since 6.2] PRIdQPTRDIFF

[since 6.2] PRIiQPTRDIFF

[since 6.2] PRIdQSIZETYPE

[since 6.2] PRIiQSIZETYPE

[since 6.2] PRIoQUINTPTR

[since 6.2] PRIuQUINTPTR

[since 6.2] PRIxQUINTPTR

[since 6.2] PRIXQUINTPTR

[since 6.6] QT_SUPPORTS_INT128

[since 6.6] qint128 Q_INT128_C(literal)

[since 6.6] Q_INT128_MAX

[since 6.6] Q_INT128_MIN

qint64 Q_INT64_C(literal)

[since 6.6] quint128 Q_UINT128_C(literal)

[since 6.6] Q_UINT128_MAX

quint64 Q_UINT64_C(literal)

`[since 6.6]` qint128

`[alias]` qsizetype

`[since 6.6]` quint128

`[since 6.2]` PRIdQINTPTR

`[since 6.2]` PRIiQINTPTR

`[since 6.2]` PRIdQPTRDIFF

`[since 6.2]` PRIiQPTRDIFF

`[since 6.2]` PRIdQSIZETYPE

`[since 6.2]` PRIiQSIZETYPE

`[since 6.2]` PRIoQUINTPTR

`[since 6.2]` PRIuQUINTPTR

`[since 6.2]` PRIxQUINTPTR

`[since 6.2]` PRIXQUINTPTR

`[since 6.6]` QT_SUPPORTS_INT128

`[since 6.6]` qint128 Q_INT128_C(literal)

`[since 6.6]` Q_INT128_MAX

`[since 6.6]` Q_INT128_MIN

`[since 6.6]` quint128 Q_UINT128_C(literal)

`[since 6.6]` Q_UINT128_MAX