QVariant Class

멤버 함수 문서

변형에 저장된 값의 저장 유형을 반환합니다. metaType ().id()와 동일합니다.

metaType()도 참조하세요 .

포함된 객체에 대한 포인터를 쓸 수 없는 일반 공백*으로 반환합니다.

get_if() 및 QMetaType 을참조하세요 .

[noexcept] QVariant::QVariant()

유효하지 않은 변형을 생성합니다.

[noexcept] QVariant::QVariant(QChar c)

문자 값 c 으로 새 변형을 생성합니다.

QVariant::QVariant(const char *val)

문자열 값이 val 인 새 변형을 생성합니다. 이 변형은 입력 val 에 UTF-8 인코딩을 가정하여 val 의 딥 카피를 QString 로 생성합니다.

val 은 변형에 저장하기 위해 QString 으로 변환되며 QVariant::userType()은 변형에 대해 QMetaType::QString 을 반환합니다.

애플리케이션을 컴파일할 때 QT_NO_CAST_FROM_ASCII 을 정의하여 이 연산자를 비활성화할 수 있습니다.

[noexcept] QVariant::QVariant(double val)

부동 소수점 값 val 으로 새 변형을 생성합니다.

[noexcept] QVariant::QVariant(float val)

부동 소수점 값 val 으로 새 변형을 생성합니다.

[noexcept] QVariant::QVariant(int val)

정수 값 val 으로 새 변형을 생성합니다.

[noexcept] QVariant::QVariant(qlonglong val)

긴 긴 정수 값인 val 으로 새로운 변형을 생성합니다.

[noexcept] QVariant::QVariant(qulonglong val)

부호 없는 긴 정수 값 val 으로 새 변형을 생성합니다.

[noexcept] QVariant::QVariant(uint val)

부호 없는 정수 값 val 으로 새 변형을 생성합니다.

[explicit] QVariant::QVariant(QMetaType type, const void *copy = nullptr)

type 유형의 변형을 생성하고 copy 이 nullptr 이 아닌 경우 *copy 의 복사본으로 초기화합니다(이 경우 copy 는 type 유형의 객체를 가리켜야 합니다).

저장하려는 객체의 주소를 전달해야 한다는 점에 유의하세요.

일반적으로 이 생성자를 사용할 필요는 없으며 대신 QVariant::fromValue()를 사용하여 QMetaType::VoidStar 및 QMetaType::QObjectStar 로 표시되는 포인터 유형에서 변형을 구성합니다.

type 이 복사 구성을 지원하지 않고 copy 이 nullptr 이 아닌 경우 변형은 유효하지 않습니다. 마찬가지로 copy 가 nullptr 이고 type 가 기본 구성을 지원하지 않는 경우 변형은 유효하지 않습니다.

QVariant::fromMetaType, QVariant::fromValue() 및 QMetaType::Type 를참조하세요 .

[explicit noexcept(...), since 6.6] template <typename T, typename... Args, QVariant::if_constructible<T, Args...> = true> QVariant::QVariant(std::in_place_type_t<T>, Args &&... args)

T 타입의 값을 포함하는 새 변형을 생성합니다. 포함된 값은 인자 std::forward<Args>(args)... 로 초기화됩니다.

이 생성자는 STL/std::any 호환성을 위해 제공됩니다.

이 함수는 오버로드된 함수입니다.

제약 조건

args 에서 T 를 만들 수 있는 경우에만 과부하 해결에 참여합니다.

이 함수는 Qt 6.6에 도입되었습니다.

[explicit noexcept(...), since 6.6] template <typename T, typename U, typename... Args, QVariant::if_constructible<T, std::initializer_list<U> &, Args...> = true> QVariant::QVariant(std::in_place_type_t<T>, std::initializer_list<U> il, Args &&... args)

이것은 오버로드된 함수입니다.

이 오버로드는 initializer_list 를 받는 생성자가 있는 형을 지원하기 위해 존재합니다. 그렇지 않으면 비 초기화자 목록 in_place_type_t 오버로드와 동일하게 동작합니다.

이 함수는 Qt 6.6에 도입되었습니다.

[noexcept] QVariant::QVariant(QDate val)

날짜 값 val 으로 새 변형을 생성합니다.

QVariant::QVariant(QLatin1StringView val)

val 에서 조회한 라틴-1 문자열에서 QString 값을 사용하여 새 변형을 만듭니다.

[noexcept(...)] QVariant::QVariant(QLine val)

줄 값이 val 인 새 변형을 생성합니다.

[noexcept(...)] QVariant::QVariant(QLineF val)

줄 값이 val 인 새 변형을 생성합니다.

[noexcept] QVariant::QVariant(QPoint val)

포인트 값이 val 인 새 변형을 생성합니다.

[noexcept(...)] QVariant::QVariant(QPointF val)

포인트 값이 val 인 새 변형을 생성합니다.

[noexcept(...)] QVariant::QVariant(QRect val)

rect 값이 val 인 새 변형을 생성합니다.

[noexcept(...)] QVariant::QVariant(QRectF val)

rect 값이 val 인 새 변형을 생성합니다.

[noexcept] QVariant::QVariant(QSize val)

크기 값이 val 인 새 변형을 생성합니다.

[noexcept(...)] QVariant::QVariant(QSizeF val)

크기 값이 val 인 새 변형을 생성합니다.

[noexcept] QVariant::QVariant(QTime val)

시간 값( val)을 가진 새 변형을 생성합니다.

[noexcept(...)] QVariant::QVariant(QUuid val)

uuid 값 val 으로 새 변형을 생성합니다.

[noexcept] QVariant::QVariant(bool val)

부울 값 val 으로 새 변형을 생성합니다.

[noexcept] QVariant::QVariant(const QBitArray &val)

비트 배열 값 val 으로 새 변형을 생성합니다.

[noexcept] QVariant::QVariant(const QByteArray &val)

바이트 배열 값( val)으로 새 변형을 생성합니다.

[noexcept] QVariant::QVariant(const QDateTime &val)

날짜/시간 값 val 으로 새 변형을 생성합니다.

QVariant::QVariant(const QEasingCurve &val)

완화 커브 값( val)을 사용하여 새 변형을 생성합니다.

[noexcept] QVariant::QVariant(const QHash<QString, QVariant> &val)

해시가 QVariants, val 인 새 변형을 생성합니다.

[noexcept] QVariant::QVariant(const QJsonArray &val)

json 배열 값 val 으로 새 변형을 생성합니다.

QVariant::QVariant(const QJsonDocument &val)

json 문서 값 val 으로 새 변형을 생성합니다.

[noexcept] QVariant::QVariant(const QJsonObject &val)

json 객체 값 val 으로 새 변형을 생성합니다.

[noexcept(...)] QVariant::QVariant(const QJsonValue &val)

json 값 val 으로 새 변형을 생성합니다.

[noexcept] QVariant::QVariant(const QList<QVariant> &val)

목록 값 val 으로 새 변형을 생성합니다.

[noexcept] QVariant::QVariant(const QLocale &l)

로캘 값 l 을 사용하여 새 변형을 생성합니다.

[noexcept] QVariant::QVariant(const QMap<QString, QVariant> &val)

QVariants, val 의 맵으로 새 변형을 구축합니다.

[noexcept(...)] QVariant::QVariant(const QModelIndex &val)

QModelIndex 값인 val 으로 새 변형을 생성합니다.

QVariant::QVariant(const QPersistentModelIndex &val)

QPersistentModelIndex 값으로 새 변형을 생성합니다( val).

[noexcept] QVariant::QVariant(const QRegularExpression &re)

정규식 값 re 을 사용하여 새 변형을 생성합니다.

[noexcept] QVariant::QVariant(const QString &val)

문자열 값 val 으로 새 변형을 생성합니다.

[noexcept] QVariant::QVariant(const QStringList &val)

문자열 목록 값 val 으로 새 변형을 생성합니다.

[noexcept] QVariant::QVariant(const QUrl &val)

URL 값이 val 인 새 변형을 생성합니다.

QVariant::QVariant(const QVariant &p)

이 생성자에 인자로 전달된 p 변형의 복사본을 생성합니다.

[noexcept] QVariant::QVariant(QVariant &&other)

Move - QVariant 인스턴스를 생성하여 other 가 가리키던 것과 동일한 객체를 가리키도록 합니다.

[noexcept] QVariant::~QVariant()

QVariant 및 포함된 객체를 삭제합니다.

template <typename T> bool QVariant::canConvert() const

이형 상품을 템플릿 유형 T 으로 변환할 수 있는 경우 true 을 반환하고, 그렇지 않으면 false 를 반환합니다.

예시:

QVariant v = 42;

v.canConvert<int>();              // returns true
v.canConvert<QString>();          // returns true

MyCustomStruct s;
v.setValue(s);

v.canConvert<int>();              // returns false
v.canConvert<MyCustomStruct>();   // returns true

QObject 에서 파생된 유형에 대한 포인터를 포함하는 QVariant 도 qobject_cast 에서 템플릿 유형 T 으로 변환이 성공할 경우 이 함수에 대해 참을 반환합니다. Q_OBJECT 매크로를 사용하는 QObject 서브클래스에 대해서만 작동한다는 점에 유의하세요.

convert()도 참조하세요 .

[since 6.0] bool QVariant::canConvert(QMetaType type) const

이형 상품의 유형을 요청된 유형으로 형 변환할 수 있는 경우 true 을 반환합니다( type). 이러한 형변환은 toInt(), toBool(), ... 메서드를 호출할 때 자동으로 수행됩니다.

이 함수는 콘텐츠가 아닌 이형 상품의 유형에 대해서만 작동합니다. 이 변형에서 type 로의 변환 경로가 있는지 여부를 나타내며, 변환이 시도될 때 변환이 성공할 것인지를 나타내는 것은 아닙니다.

이 함수는 Qt 6.0에 도입되었습니다.

QMetaType::canConvert()도 참조하세요 .

template <typename T> bool QVariant::canView() const

이 변형에서 템플릿 유형 T 의 변경 가능한 보기를 만들 수 있으면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

value()도 참조하세요 .

void QVariant::clear()

이 변형을 QMetaType::UnknownType 유형으로 변환하고 사용된 리소스를 모두 확보하세요.

[static, since 6.0] QPartialOrdering QVariant::compare(const QVariant &lhs, const QVariant &rhs)

lhs 및 rhs 의 객체를 비교하여 순서를 지정합니다.

비교가 지원되지 않거나 값이 정렬되지 않은 경우 QPartialOrdering::Unordered 를 반환합니다. 그렇지 않으면 lhs 이 rhs 보다 작거나 같거나 크면 각각 QPartialOrdering::Less, QPartialOrdering::Equivalent 또는 QPartialOrdering::Greater 을 반환합니다.

변형에 다른 메타타입을 가진 데이터가 포함된 경우, 값이 모두 숫자 또는 포인터 타입이 아닌 한 순서가 지정되지 않은 것으로 간주되며 일반 숫자 또는 포인터 비교 규칙이 사용됩니다.

두 변형에 모두 동일한 메타타입의 데이터가 포함되어 있으면 QMetaType::compare 메서드를 사용하여 두 변형의 순서를 결정하며, 이는 두 값 사이의 순서를 설정할 수 없음을 나타낼 수도 있습니다.

이 함수는 Qt 6.0에 도입되었습니다.

QMetaType::compare() 및 QMetaType::isOrdered()도 참조하세요 .

[since 6.0] bool QVariant::convert(QMetaType targetType)

이형 변형을 요청된 유형 targetType 으로 형변환합니다. 형변환을 수행할 수 없는 경우, 변형은 여전히 요청된 유형으로 변경되지만 QVariant(Type)에서 생성된 것과 유사한 지워진 널 상태로 남습니다.

변형의 현재 타입이 성공적으로 형 변환된 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

QObject 에서 파생된 타입에 대한 포인터를 포함하는 QVariant 도 targetType 에서 설명하는 타입에 대한 qobject_cast 이 성공하면 이 함수에 대해 참을 변환하여 반환합니다. 이는 Q_OBJECT 매크로를 사용하는 QObject 서브클래스에 대해서만 작동합니다.

이 함수는 Qt 6.0에 도입되었습니다.

canConvert() 및 clear()도 참조하십시오 .

void *QVariant::data()

포함된 객체에 대한 포인터를 쓸 수 있는 일반 공백*으로 반환합니다.

이 함수는 QVariant 을 분리합니다. null-QVariant 에서 호출하면 QVariant 은 호출 후 널이 되지 않습니다.

get_if() 및 QMetaType도 참조하세요 .

[since 6.6] template <typename T, typename... Args, QVariant::if_constructible<T, Args...> = true> T &QVariant::emplace(Args &&... args)

현재 *this 에 보유 중인 객체를 args... 에서 생성된 T 유형의 객체로 바꿉니다. *this 가 null이 아닌 경우, 이전에 보유하던 객체가 먼저 소멸됩니다. 가능하면, 이 메서드는 QVariant 에서 할당된 메모리를 재사용합니다. 새로 생성된 객체에 대한 참조를 반환합니다.

이 함수는 Qt 6.6에 도입되었습니다.

[since 6.6] template <typename T, typename U, typename... Args, QVariant::if_constructible<T, std::initializer_list<U> &, Args...> = true> T &QVariant::emplace(std::initializer_list<U> list, Args &&... args)

이것은 오버로드된 함수입니다.

이 오버로드는 initializer_list 를 받는 생성자가 있는 형을 지원하기 위해 존재합니다. 그렇지 않으면 비 초기화자 리스트 오버로드와 동일하게 동작합니다.

이 함수는 Qt 6.6에 도입되었습니다.

[static, since 6.7] QVariant QVariant::fromMetaType(QMetaType type, const void *copy = nullptr)

type 유형의 변형을 만들고 copy 가 nullptr 이 아닌 경우 *copy 의 복사본으로 초기화합니다(이 경우 copy 는 type 유형의 객체를 가리켜야 합니다).

저장하려는 객체의 주소를 전달해야 한다는 점에 유의하세요.

일반적으로 이 생성자를 사용할 필요는 없으며 대신 QVariant::fromValue()를 사용하여 QMetaType::VoidStar 및 QMetaType::QObjectStar 로 표시되는 포인터 유형에서 변형을 구성합니다.

type 이 복사 구성을 지원하지 않고 copy 이 nullptr 이 아닌 경우 변형은 유효하지 않습니다. 마찬가지로 copy 가 nullptr 이고 type 가 기본 구성을 지원하지 않는 경우 변형은 유효하지 않습니다.

위에서 설명한 대로 생성된 QVariant 을 반환합니다.

이 함수는 Qt 6.7에 도입되었습니다.

QVariant::fromValue() 및 QMetaType::Type도 참조하십시오 .

[static] template <typename... Types> QVariant QVariant::fromStdVariant(const std::variant<Types...> &value)

value 의 활성 변형의 유형과 값이 포함된 QVariant 을 반환합니다. 활성 유형이 std::monostate인 경우 기본값 QVariant 이 반환됩니다.

fromValue()도 참조하십시오 .

[static, since 6.6] template <typename... Types> QVariant QVariant::fromStdVariant(std::variant<Types...> &&value)

이 함수는 오버로드된 함수입니다.

이 함수는 Qt 6.6에 도입되었습니다.

[static] template <typename T> QVariant QVariant::fromValue(const T &value)

value 의 복사본이 포함된 QVariant 을 반환합니다. 그렇지 않으면 setValue()와 똑같이 작동합니다.

예제:

MyCustomStruct s;
return QVariant::fromValue(s);

setValue() 및 value()도 참조하세요 .

[static, since 6.6] template <typename T, QVariant::if_rvalue<T> = true> QVariant QVariant::fromValue(T &&value)

이 함수는 오버로드된 함수입니다.

이 함수는 Qt 6.6에 도입되었습니다.

bool QVariant::isNull() const

null 변형인 경우 true, 그렇지 않으면 false를 반환합니다.

초기화된 값이나 널 포인터를 포함하지 않으면 변형은 널로 간주됩니다.

convert()도 참조하세요 .

bool QVariant::isValid() const

이 변형의 저장소 유형이 QMetaType::UnknownType 이 아닌 경우 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

[since 6.0] QMetaType QVariant::metaType() const

변형에 저장된 값의 QMetaType 을 반환합니다.

이 함수는 Qt 6.0에 도입되었습니다.

void QVariant::setValue(QVariant &&value)

value 을 이 QVariant 으로 이동합니다. 이는 value 을 이 QVariant 으로 이동하는 것과 같습니다.

value()도 참조하세요 .

template <typename T, typename = std::enable_if_t<!std::is_same_v<std::decay_t<T>, QVariant>>> void QVariant::setValue(T &&value)

value 의 복사본을 저장합니다. T 이 QVariant 에서 지원하지 않는 유형인 경우 QMetaType 을 사용하여 값을 저장합니다. QMetaType 에서 해당 유형을 처리하지 않으면 컴파일 오류가 발생합니다.

예시:

QVariant v;

v.setValue(5);
int i = v.toInt();         // i is now 5
QString s = v.toString();  // s is now "5"

MyCustomStruct c;
v.setValue(c);

...

MyCustomStruct c2 = v.value<MyCustomStruct>();

value(), fromValue() 및 canConvert()도 참조하세요 .

void QVariant::setValue(const QVariant &value)

이 QVariant 에 value 을 복사합니다. 이는 단순히 value 을 QVariant 에 할당하는 것과 같습니다.

[noexcept] void QVariant::swap(QVariant &other)

이 변형을 other 로 바꿉니다. 이 작업은 매우 빠르며 실패하지 않습니다.

QBitArray QVariant::toBitArray() const

이형 상품에 userType() QMetaType::QBitArray 이 있는 경우 이형 상품을 QBitArray 으로 반환하고, 그렇지 않으면 빈 비트 배열을 반환합니다.

canConvert() 및 convert()도 참조하세요 .

bool QVariant::toBool() const

이형 상품에 userType() Bool이 있는 경우 이형 상품을 부울로 반환합니다.

이형 상품에 userType() QMetaType::Bool, QMetaType::QChar, QMetaType::Double, QMetaType::Int, QMetaType::LongLong, QMetaType::UInt, QMetaType::ULongLong 이 있고 값이 0이 아닌 경우 또는 이형 상품에 QMetaType::QString 또는 QMetaType::QByteArray 유형이 있고 소문자 내용이 비어 있거나 "0" 또는 "false" 중 하나가 아닌 경우 true 를 반환하고, 그렇지 않으면 false 를 반환합니다.

canConvert() 및 convert()도 참조하세요 .

QByteArray QVariant::toByteArray() const

이형 상품에 userType() QMetaType::QByteArray 또는 QMetaType::QString ( QString::fromUtf8()을 사용하여 변환됨)이 있는 경우 이형 상품을 QByteArray 로 반환하고, 그렇지 않으면 빈 바이트 배열을 반환합니다.

canConvert() 및 convert()도 참조하세요 .

QChar QVariant::toChar() const

이형 상품에 userType() QMetaType::QChar, QMetaType::Int 또는 QMetaType::UInt 이 있는 경우 이형 상품을 QChar 으로 반환하고, 그렇지 않은 경우 잘못된 QChar 을 반환합니다.

canConvert() 및 convert()도 참조하세요 .

QDate QVariant::toDate() const

이형 상품에 userType() QMetaType::QDate, QMetaType::QDateTime, 또는 QMetaType::QString 이 있으면 QDate 으로 반환하고, 그렇지 않으면 잘못된 날짜를 반환합니다.

type()이 QMetaType::QString 인 경우 문자열을 Qt::ISODate 형식의 날짜로 구문 분석할 수 없는 경우 잘못된 날짜가 반환됩니다.

canConvert() 및 convert()도 참조하세요 .

QDateTime QVariant::toDateTime() const

이형 상품에 userType() QMetaType::QDateTime, QMetaType::QDate, 또는 QMetaType::QString 이 있으면 QDateTime 으로 반환하고, 그렇지 않으면 잘못된 날짜/시간을 반환합니다.

type()이 QMetaType::QString 인 경우 문자열을 Qt::ISODate 형식의 날짜/시간으로 구문 분석할 수 없는 경우 잘못된 날짜/시간이 반환됩니다.

canConvert() 및 convert()도 참조하세요 .

double QVariant::toDouble(bool *ok = nullptr) const

이형 상품에 userType() QMetaType::Double, QMetaType::Float, QMetaType::Bool, QMetaType::QByteArray, QMetaType::Int, QMetaType::LongLong, QMetaType::QString, QMetaType::UInt, QMetaType::ULongLong 가 있는 경우 이형 상품을 더블로 반환하고, 그렇지 않으면 0.0을 반환합니다.

ok 가 null이 아닌 경우: *ok 값이 더블로 변환될 수 있는 경우 참으로 설정되고, 그렇지 않으면 *ok 거짓으로 설정됩니다.

canConvert() 및 convert()도 참조하세요 .

QEasingCurve QVariant::toEasingCurve() const

이형 상품에 userType() QMetaType::QEasingCurve 이 있는 경우 이형 상품을 QEasingCurve 으로 반환하고, 그렇지 않으면 기본 완화 곡선을 반환합니다.

canConvert() 및 convert()도 참조하세요 .

float QVariant::toFloat(bool *ok = nullptr) const

이형 상품에 userType() QMetaType::Double, QMetaType::Float, QMetaType::Bool, QMetaType::QByteArray, QMetaType::Int, QMetaType::LongLong, QMetaType::QString, QMetaType::UInt, QMetaType::ULongLong 가 있는 경우 이형 상품을 플로트로 반환하고, 그렇지 않으면 0.0을 반환합니다.

ok 가 null이 아닌 경우: *ok 값이 더블로 변환될 수 있는 경우 참으로 설정되고, 그렇지 않으면 *ok 거짓으로 설정됩니다.

canConvert() 및 convert()도 참조하세요 .

QHash<QString, QVariant> QVariant::toHash() const

이형 상품에 type() QMetaType::QVariantHash 이 있는 경우 이형 상품을 QHash<QString, QVariant>로 반환하고, 그렇지 않으면 빈 맵을 반환합니다.

canConvert() 및 convert()도 참조하세요 .

int QVariant::toInt(bool *ok = nullptr) const

이형 상품에 userType() QMetaType::Int, QMetaType::Bool, QMetaType::QByteArray, QMetaType::QChar, QMetaType::Double, QMetaType::LongLong, QMetaType::QString, QMetaType::UInt, QMetaType::ULongLong 가 있는 경우 이형 상품을 int로 반환하고, 그렇지 않으면 0을 반환합니다.

ok 가 null이 아닌 경우: *ok 값이 정수로 변환될 수 있으면 true로 설정되고, 그렇지 않으면 *ok false로 설정됩니다.

경고: 값이 QMetaType::LongLong 로 변환할 수 있지만 너무 커서 int로 표현할 수 없는 경우 결과 산술 오버플로는 ok 에 반영되지 않습니다. 간단한 해결 방법은 QString::toInt()를 사용하는 것입니다.

canConvert() 및 convert()도 참조하세요 .

QJsonArray QVariant::toJsonArray() const

이형 상품에 userType() QJsonArray 이 있는 경우 이형 상품을 QJsonArray 으로 반환하고, 그렇지 않으면 기본 구성 QJsonArray 을 반환합니다.

canConvert() 및 convert()도 참조하세요 .

QJsonDocument QVariant::toJsonDocument() const

이형 상품에 userType() QJsonDocument 이 있는 경우 이형 상품을 QJsonDocument 으로 반환하고, 그렇지 않으면 기본 구성 QJsonDocument 을 반환합니다.

canConvert() 및 convert()도 참조하세요 .

QJsonObject QVariant::toJsonObject() const

이형 상품에 userType() QJsonObject 이 있는 경우 이형 상품을 QJsonObject 으로 반환하고, 그렇지 않으면 기본 구성 QJsonObject 을 반환합니다.

canConvert() 및 convert()도 참조하세요 .

QJsonValue QVariant::toJsonValue() const

이형 상품에 userType() QJsonValue 이 있는 경우 이형 상품을 QJsonValue 으로 반환하고, 그렇지 않으면 기본 구성 QJsonValue 을 반환합니다.

canConvert() 및 convert()도 참조하세요 .

QLine QVariant::toLine() const

이형 상품에 userType() QMetaType::QLine 이 있는 경우 이형 상품을 QLine 으로 반환하고, 그렇지 않은 경우 잘못된 QLine 을 반환합니다.

canConvert() 및 convert()도 참조하세요 .

QLineF QVariant::toLineF() const

이형 상품에 userType() QMetaType::QLineF 이 있는 경우 이형 상품을 QLineF 으로 반환하고, 그렇지 않은 경우 잘못된 QLineF 을 반환합니다.

canConvert() 및 convert()도 참조하세요 .

QList<QVariant> QVariant::toList() const

이형 상품에 userType() QMetaType::QVariantList 이 있는 경우 이형 상품을 QVariantList 으로 반환합니다. 그렇지 않은 경우 QVariant 는 유형을 목록으로 변환한 다음 반환합니다. 이는 QVariantList 에 변환기를 등록했거나 Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE 을 사용하여 순차 컨테이너로 선언된 모든 유형에 대해 성공합니다. 이러한 조건 중 어느 것도 해당되지 않으면 이 함수는 빈 목록을 반환합니다.

canConvert() 및 convert()도 참조하세요 .

QLocale QVariant::toLocale() const

이형 상품에 userType() QMetaType::QLocale 이 있는 경우 이형 상품을 QLocale 으로 반환하고, 그렇지 않은 경우 잘못된 QLocale 을 반환합니다.

canConvert() 및 convert()도 참조하세요 .

qlonglong QVariant::toLongLong(bool *ok = nullptr) const

이형 상품에 userType() QMetaType::LongLong, QMetaType::Bool, QMetaType::QByteArray, QMetaType::QChar, QMetaType::Double, QMetaType::Int, QMetaType::QString, QMetaType::UInt, QMetaType::ULongLong 가 있는 경우 긴 긴 int로 반환하고, 그렇지 않으면 0을 반환합니다.

ok 가 null이 아닌 경우: *ok 값이 정수로 변환될 수 있으면 true로 설정되고, 그렇지 않으면 *ok false로 설정됩니다.

canConvert() 및 convert()도 참조하세요 .

QMap<QString, QVariant> QVariant::toMap() const

이형 상품에 type() QMetaType::QVariantMap 이 있는 경우 이형 상품을 QVariantMap 으로 반환합니다. 그렇지 않은 경우 QVariant 는 유형을 맵으로 변환한 다음 반환합니다. 이는 QVariantMap 에 변환기를 등록했거나 Q_DECLARE_ASSOCIATIVE_CONTAINER_METATYPE 을 사용하여 연관 컨테이너로 선언된 모든 유형에 대해 성공합니다. 이러한 조건 중 어느 것도 해당되지 않으면 이 함수는 빈 맵을 반환합니다.

canConvert() 및 convert()도 참조하세요 .

QModelIndex QVariant::toModelIndex() const

이형 상품에 userType() QModelIndex 이 있는 경우 이형 상품을 QModelIndex 으로 반환하고, 그렇지 않으면 기본 구성 QModelIndex 을 반환합니다.

canConvert(), convert() 및 toPersistentModelIndex()도 참조하세요 .

QPersistentModelIndex QVariant::toPersistentModelIndex() const

이형 상품에 userType() QPersistentModelIndex 이 있는 경우 이형 상품을 QPersistentModelIndex 으로 반환하고, 그렇지 않으면 기본 구성 QPersistentModelIndex 을 반환합니다.

canConvert(), convert() 및 toModelIndex()도 참조하세요 .

QPoint QVariant::toPoint() const

이형 상품에 userType() QMetaType::QPoint 또는 QMetaType::QPointF 이 있는 경우 이형 상품을 QPoint 으로 반환하고, 그렇지 않으면 null을 반환합니다 QPoint.

canConvert() 및 convert()도 참조하세요 .

QPointF QVariant::toPointF() const

이형 상품에 userType() QMetaType::QPoint 또는 QMetaType::QPointF 이 있는 경우 이형 상품을 QPointF 으로 반환하고, 그렇지 않으면 null을 반환합니다 QPointF.

canConvert() 및 convert()도 참조하세요 .

qreal QVariant::toReal(bool *ok = nullptr) const

이형 상품에 userType() QMetaType::Double, QMetaType::Float, QMetaType::Bool, QMetaType::QByteArray, QMetaType::Int, QMetaType::LongLong, QMetaType::QString, QMetaType::UInt, QMetaType::ULongLong 가 있는 경우 이형 상품을 qreal로 반환하고, 그렇지 않으면 0.0을 반환합니다.

ok 가 널이 아닌 경우: *ok 값이 더블로 변환될 수 있으면 참으로 설정되고, 그렇지 않으면 *ok 이 거짓으로 설정됩니다.

canConvert() 및 convert()도 참조하세요 .

QRect QVariant::toRect() const

이형 상품에 userType() QMetaType::QRect 이 있는 경우 이형 상품을 QRect 으로 반환하고, 그렇지 않은 경우 잘못된 QRect 을 반환합니다.

canConvert() 및 convert()도 참조하세요 .

QRectF QVariant::toRectF() const

이형 상품에 userType() QMetaType::QRect 또는 QMetaType::QRectF 이 있는 경우 이형 상품을 QRectF 으로 반환하고, 그렇지 않은 경우 잘못된 QRectF 을 반환합니다.

canConvert() 및 convert()도 참조하세요 .

QRegularExpression QVariant::toRegularExpression() const

이형 상품에 userType() QRegularExpression 이 있는 경우 이형 상품을 QRegularExpression 으로 반환하고, 그렇지 않으면 빈 QRegularExpression 을 반환합니다.

canConvert() 및 convert()도 참조하세요 .

QSize QVariant::toSize() const

이형 상품에 userType() QMetaType::QSize 이 있는 경우 이형 상품을 QSize 으로 반환하고, 그렇지 않은 경우 잘못된 QSize 을 반환합니다.

canConvert() 및 convert()도 참조하세요 .

QSizeF QVariant::toSizeF() const

이형 상품에 userType() QMetaType::QSizeF 이 있는 경우 이형 상품을 QSizeF 으로 반환하고, 그렇지 않은 경우 잘못된 QSizeF 을 반환합니다.

canConvert() 및 convert()도 참조하세요 .

QString QVariant::toString() const

이형 상품에 userType()를 포함하되 이에 국한되지 않는 경우 이형 상품을 QString 로 반환합니다:

QMetaType::QString, QMetaType::Bool, QMetaType::QByteArray, QMetaType::QChar, QMetaType::QDate, QMetaType::QDateTime, QMetaType::Double, QMetaType::Int, QMetaType::LongLong, QMetaType::QStringList, QMetaType::QTime, QMetaType::UInt, 또는 QMetaType::ULongLong.

지원되지 않는 배리언트에서 QVariant::toString()을 호출하면 빈 문자열이 반환됩니다.

canConvert() 및 convert()도 참조하십시오 .

QStringList QVariant::toStringList() const

QString이형 상품에 userType() QMetaType::QStringList, QMetaType::QString, 또는 QMetaType::QVariantList 로 변환할 수 있는 유형이 있는 경우 이형 상품을 QStringList 로 반환하고, 그렇지 않으면 빈 목록을 반환합니다.

canConvert() 및 convert()도 참조하세요 .

QTime QVariant::toTime() const

이형 상품에 userType() QMetaType::QTime, QMetaType::QDateTime, 또는 QMetaType::QString 이 있으면 QTime 으로 반환하고, 그렇지 않으면 잘못된 시간을 반환합니다.

type()이 QMetaType::QString 인 경우 문자열을 Qt::ISODate 형식의 시간으로 구문 분석할 수 없는 경우 잘못된 시간이 반환됩니다.

canConvert() 및 convert()도 참조하세요 .

uint QVariant::toUInt(bool *ok = nullptr) const

이형 상품에 userType() QMetaType::UInt, QMetaType::Bool, QMetaType::QByteArray, QMetaType::QChar, QMetaType::Double, QMetaType::Int, QMetaType::LongLong, QMetaType::QString, QMetaType::ULongLong 가 있는 경우 이형 상품을 부호 없는 int로 반환하고, 그렇지 않으면 0을 반환합니다.

ok 가 null이 아닌 경우: *ok 값이 부호 없는 정수로 변환될 수 있으면 true로 설정되고, 그렇지 않으면 *ok false로 설정됩니다.

경고: 값이 QMetaType::ULongLong 로 변환할 수 있지만 너무 커서 부호 없는 int로 표현할 수 없는 경우 결과 산술 오버플로는 ok 에 반영되지 않습니다. 간단한 해결 방법은 QString::toUInt()를 사용하는 것입니다.

canConvert() 및 convert()도 참조하세요 .

qulonglong QVariant::toULongLong(bool *ok = nullptr) const

이형 상품에 type() QMetaType::ULongLong, QMetaType::Bool, QMetaType::QByteArray, QMetaType::QChar, QMetaType::Double, QMetaType::Int, QMetaType::LongLong, QMetaType::QString, QMetaType::UInt 이 있는 경우 이형 상품을 부호 없는 긴 정수로 반환하고, 그렇지 않으면 0을 반환합니다.

ok 이 null이 아닌 경우: *ok 값이 정수로 변환될 수 있으면 true로 설정되고, 그렇지 않으면 *ok 이 false로 설정됩니다.

canConvert() 및 convert()도 참조하세요 .

QUrl QVariant::toUrl() const

이형 상품에 userType() QMetaType::QUrl 이 있는 경우 이형 상품을 QUrl 으로 반환하고, 그렇지 않은 경우 잘못된 QUrl 을 반환합니다.

canConvert() 및 convert()도 참조하세요 .

QUuid QVariant::toUuid() const

이형 상품에 type() QMetaType::QUuid, QMetaType::QByteArray 또는 QMetaType::QString 이 있는 경우 이형 상품을 QUuid 으로 반환하고, 그렇지 않으면 기본으로 구성된 QUuid 을 반환합니다.

canConvert() 및 convert()도 참조하세요 .

const char *QVariant::typeName() const

변형에 저장된 타입의 이름을 반환합니다. 반환되는 문자열은 데이터를 저장하는 데 사용된 C++ 데이터 유형을 설명합니다(예: "QFont", "QString" 또는 "QVariantList"). 유효하지 않은 변형은 0을 반환합니다.

template <typename T> T QVariant::value() const &

템플릿 유형으로 변환된 저장값을 반환합니다 T. canConvert ()를 호출하여 유형을 변환할 수 있는지 확인합니다. 값을 변환할 수 없는 경우 기본값으로 구성된 값이 반환됩니다.

T 유형이 QVariant 에서 지원되는 경우 이 함수는 toString(), toInt() 등과 동일하게 작동합니다.

예시:

QVariant v;

MyCustomStruct c;
if (v.canConvert<MyCustomStruct>())
    c = v.value<MyCustomStruct>();

v = 7;
int i = v.value<int>();                        // same as v.toInt()
QString s = v.value<QString>();                // same as v.toString(), s is now "7"
MyCustomStruct c2 = v.value<MyCustomStruct>(); // conversion failed, c2 is empty

QVariant 에 QObject 에서 파생된 유형에 대한 포인터가 포함된 경우 T 는 모든 QObject 유형일 수 있습니다. QVariant 에 저장된 포인터가 qobject_cast 에서 T 로 연결될 수 있으면 해당 결과가 반환됩니다. 그렇지 않으면 nullptr 이 반환됩니다. 이는 Q_OBJECT 매크로를 사용하는 QObject 서브클래스에 대해서만 작동합니다.

QVariant 에 순차 컨테이너가 포함되어 있고 T 이 QVariantList 인 경우 컨테이너의 요소는 QVariant로 변환되어 QVariantList 로 반환됩니다.

QList<int> intList = {7, 11, 42};QVariant variant = QVariant::fromValue(intList);if (variant.canConvert<QVariantList>()) { QSequentialIterable iterable = variant.value<QSequentialIterable>() ; // foreach 사용 가능:foreach(const QVariant &v, 이터러블) {        qDebug() << v;
    } // C++11 사용 가능 범위-for: for(const QVariant &v: 이터러블) {        qDebug() << v;
    } // 이터레이터를 사용할 수 있습니다:    QSequentialIterable::const_iterator it = iterable.begin(); const QSequentialIterable::const_iterator end = iterable.end(); for ( ; it != end; ++it) {        qDebug() << *it;
    } }

setValue(), fromValue(), canConvert(), Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE()도 참조하세요 .

template <typename T> T QVariant::view()

저장된 값에 대해 템플릿 유형 T 의 변경 가능한 보기를 반환합니다. 해당 보기가 지원되는지 확인하려면 canView()를 호출합니다. 이러한 보기를 만들 수 없는 경우 템플릿 유형 T 으로 변환된 저장된 값을 반환합니다. canConvert ()를 호출하여 유형을 변환할 수 있는지 확인합니다. 값을 보거나 변환할 수 없는 경우 기본적으로 구성된 값이 반환됩니다.

canView() 및 Q_DECLARE_SEQUENTIAL_CONTAINER_METATYPE()도 참조하세요 .

[noexcept] QVariant &QVariant::operator=(QVariant &&other)

이동-이 other 인스턴스를 QVariant 인스턴스에 할당합니다.

QVariant &QVariant::operator=(const QVariant &variant)

이형 상품 variant 의 값을 이형 상품에 할당합니다.