QJsonValue Class

멤버 함수 문서

QJsonValue::QJsonValue(QJsonValue::Type type = Null)

type 유형의 QJsonValue를 생성합니다.

기본값은 Null 값을 생성하는 것입니다.

QJsonValue::QJsonValue(QLatin1StringView s)

s 를 통해 변환된 Latin-1 문자열을 가진 String 형식의 값을 생성합니다.

QJsonValue::QJsonValue(bool b)

b 인 Bool 형식의 값을 생성합니다.

QJsonValue::QJsonValue(const QJsonArray &a)

a 값을 갖는 Array 유형의 값을 생성합니다.

QJsonValue::QJsonValue(const QJsonObject &o)

o 값을 갖는 Object 형식의 객체를 생성합니다.

QJsonValue::QJsonValue(const QString &s)

s 라는 값을 가진 String 유형의 변수를 생성합니다.

QJsonValue::QJsonValue(const char *s)

입력이 UTF-8 인코딩을 사용한다고 가정하고, 값이 s 인 String 형식의 객체를 생성합니다.

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

QJsonValue::QJsonValue(double v)

v 값을 갖는 Double 형식의 값을 생성합니다.

[noexcept, since 6.3] QJsonValue::QJsonValue(QJsonArray &&a)

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

[noexcept, since 6.3] QJsonValue::QJsonValue(QJsonObject &&o)

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

QJsonValue::QJsonValue(int v)

v 값을 갖는 Double 형식의 값을 생성합니다.

QJsonValue::QJsonValue(qint64 v)

v 값을 갖는 Double 형식의 값을 생성합니다.

이 값은 내부적으로 64비트 정수로 저장되므로, toInteger()를 통해 가져오는 한 전체 정밀도를 유지합니다. 그러나 toDouble()를 통해 값을 가져올 경우, 해당 값이 ±2^53 범위 내에 있지 않으면 정밀도가 손실됩니다.

toInteger() 및 toDouble()도 참조하십시오 .

[noexcept] QJsonValue::QJsonValue(const QJsonValue &other)

other 의 복사본을 생성합니다.

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

other 에서 QJsonValue를 이동 생성합니다.

[noexcept] QJsonValue::~QJsonValue()

가치를 훼손한다.

[static, since 6.9] QJsonValue QJsonValue::fromJson(QByteArrayView json, QJsonParseError *error = nullptr)

json 를 UTF-8로 인코딩된 JSON 값으로 파싱하고, 이를 바탕으로 QJsonValue 객체를 생성합니다.

구문 분석에 성공하면 유효한 ` QJsonValue `를 반환합니다. 실패할 경우 반환 값은 ` undefined`가 되며, 선택적 변수 ` error `에는 오류에 대한 자세한 정보가 포함됩니다.

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

QJsonParseError, isUndefined() 및 toJson()도 참조하십시오 .

[static] QJsonValue QJsonValue::fromVariant(const QVariant &variant)

variant 를 QJsonValue 로 변환하여 반환합니다.

변환 시 QVariant 유형은 다음과 같이 변환됩니다:

정보 손실 및 기타 유형

QVariant 는 JSON으로 표현할 수 있는 것보다 더 많은 정보를 담을 수 있습니다. QVariant 가 위 유형 중 하나가 아닌 경우, 변환이 보장되지 않으며 UUID의 경우와 마찬가지로 향후 Qt 버전에서 변경될 수 있습니다. 코드에서는 위에 나열된 유형 이외의 다른 유형을 사용하지 않도록 해야 합니다.

QVariant::isNull()이 true를 반환하면, QVariant 가 전달하는 유형에 관계없이 null QJsonValue 가 반환되거나 목록 또는 객체에 삽입됩니다. QVariant::isNull()에 영향을 미치는 Qt 6.0의 동작 변경 사항이 이 함수에도 영향을 미친다는 점에 유의하십시오.

무한대 또는 NaN인 부동 소수점 값은 null JSON 값으로 변환됩니다. Qt 6.0부터 QJsonValue 는 64비트 부호 있는 정수의 전체 정밀도를 손실 없이 저장할 수 있지만, 이전 버전에서는 ±2^53 범위를 벗어난 값의 경우 정밀도가 손실될 수 있습니다. 2^63 이상인 부호 없는 64비트 값은 정밀도가 손실되거나 음수 값으로 에일리어싱될 수 있으므로, QMetaType::ULongLong 의 사용은 피해야 합니다.

위에 나열되지 않은 다른 유형의 경우, 문자열로의 변환이 시도되며, 대개(항상은 아님) QVariant::toString()를 호출하여 수행됩니다. 변환에 실패하면 해당 값은 null JSON 값으로 대체됩니다. QVariant::toString() 역시 대부분의 유형에서 정보 손실이 발생한다는 점에 유의하십시오. 예를 들어, 전달된 ` QVariant `가 원시 바이트 배열 데이터를 나타내는 경우, 이를 Base64 (또는 다른 무손실 인코딩)로 미리 인코딩하는 것이 권장됩니다. 그렇지 않으면 ` QString::fromUtf8()`를 사용한 정보 손실이 발생하는 변환이 적용됩니다.

QVariant::toString()을 통한 변환은 언제든지 변경될 수 있다는 점에 유의하십시오. QVariant 와 QJsonValue 는 향후 더 많은 유형을 지원하도록 확장될 수 있으며, 이로 인해 이 함수가 변환을 수행하는 방식이 변경될 수 있습니다.

toVariant() 및 QCborValue::fromVariant()도 참조하십시오 .

bool QJsonValue::isArray() const

값에 배열이 포함되어 있으면 true 를 반환합니다.

toArray()도 참조하십시오 .

bool QJsonValue::isBool() const

값에 부울 값이 포함되어 있으면 true 를 반환합니다.

toBool()도 참조하십시오 .

bool QJsonValue::isDouble() const

값에 double 유형이 포함되어 있으면 true 를 반환합니다.

toDouble()도 참조하십시오 .

bool QJsonValue::isNull() const

값이 null인 경우 ` true `를 반환합니다.

bool QJsonValue::isObject() const

값에 객체가 포함되어 있으면 true 를 반환합니다.

toObject()도 참조하십시오 .

bool QJsonValue::isString() const

값에 문자열이 포함되어 있으면 true 를 반환합니다.

toString()도 참조하십시오 .

bool QJsonValue::isUndefined() const

값이 정의되지 않은 경우 ` true `를 반환합니다. 이는 특정 오류 상황에서 발생할 수 있으며, 예를 들어 ` QJsonObject`에서 존재하지 않는 키에 접근할 때와 같은 경우입니다.

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

이 값을 ` other`와 서로 바꾸어 줍니다. 이 작업은 매우 빠르며 절대 실패하지 않습니다.

QJsonArray QJsonValue::toArray(const QJsonArray &defaultValue) const

값을 배열로 변환하여 반환합니다.

type()의 결과가 Array가 아닐 경우, defaultValue 가 반환됩니다.

QJsonArray QJsonValue::toArray() const

값을 배열로 변환하여 반환합니다.

type()의 결과가 Array가 아닐 경우, QJsonArray()이 반환됩니다.

bool QJsonValue::toBool(bool defaultValue = false) const

값을 bool로 변환하여 반환합니다.

type()의 반환 유형이 bool이 아닌 경우, defaultValue 가 반환됩니다.

double QJsonValue::toDouble(double defaultValue = 0) const

값을 double 형으로 변환하여 반환합니다.

type()의 반환 값이 Double이 아닌 경우, defaultValue 가 반환됩니다.

int QJsonValue::toInt(int defaultValue = 0) const

값을 int형으로 변환하여 반환합니다.

type()가 Double이 아니거나 값이 정수가 아닌 경우, defaultValue 가 반환됩니다.

[since 6.0] qint64 QJsonValue::toInteger(qint64 defaultValue = 0) const

값을 정수로 변환하여 반환합니다.

type()가 Double이 아니거나 값이 qint64로 표현할 수 있는 정수가 아닌 경우, defaultValue 가 반환됩니다.

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

[since 6.9] QByteArray QJsonValue::toJson(QJsonValue::JsonFormat format = JsonFormat::Indented) const

QJsonValue 를 제공된 format 에 있는 UTF-8 인코딩된 JSON 값으로 변환합니다.

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

fromJson() 및 JsonFormat도 참조하십시오 .

QJsonObject QJsonValue::toObject(const QJsonObject &defaultValue) const

값을 객체로 변환하여 반환합니다.

type()의 결과가 Object가 아닐 경우, defaultValue 가 반환됩니다.

QJsonObject QJsonValue::toObject() const

값을 객체로 변환하여 반환합니다.

type()의 결과가 Object가 아닐 경우, QJsonObject()가 반환됩니다.

QString QJsonValue::toString() const

값을 QString 로 변환하여 반환합니다.

type()의 결과가 String이 아닌 경우, null 값의 QString 이 반환됩니다.

QString::isNull()도 참조하십시오 .

QString QJsonValue::toString(const QString &defaultValue) const

값을 QString 로 변환하여 반환합니다.

type()의 값이 String이 아닐 경우, defaultValue 가 반환됩니다.

toStringView()도 참조하십시오 .

[since 6.10] QAnyStringView QJsonValue::toStringView(QAnyStringView defaultValue = {}) const

이 ` QJsonValue`에 저장된 문자열 값을 반환합니다. 단, 해당 값이 ` string ` 유형인 경우에 한합니다. 그렇지 않은 경우 ` defaultValue`를 반환합니다. ` QJsonValue `는 문자열을 US-ASCII, UTF-8 또는 UTF-16 중 하나로 저장하므로, 반환된 ` QAnyStringView `는 이 인코딩 중 어느 것이든 될 수 있습니다.

이 함수는 메모리를 할당하지 않습니다. 반환 값은 이 객체에 대한 비const 멤버 함수가 다음에 호출될 때까지 유효합니다. 이 객체가 범위 밖으로 나가면, 반환 값은 상위 JSON 객체나 배열에 대한 비const 멤버 함수가 다음에 호출될 때까지 유효합니다.

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

toString()도 참조하십시오 .

QVariant QJsonValue::toVariant() const

값을 ` QVariant()`로 변환합니다.

QJsonValue 유형은 다음과 같이 변환됩니다:

fromVariant()도 참조하십시오 .

QJsonValue::Type QJsonValue::type() const

값의 유형을 반환합니다.

QJsonValue::Type도 참조하십시오 .

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

other 에 이 값을 할당합니다.

[noexcept] QJsonValue &QJsonValue::operator=(const QJsonValue &other)

other 에 저장된 값을 이 객체에 할당합니다.

const QJsonValue QJsonValue::operator[](const QString &key) const

key 키의 값을 나타내는 QJsonValue 객체를 반환합니다.

toObject().value(key)를 호출하는 것과 동일합니다.

키가 존재하지 않거나 isObject()의 반환값이 false인 경우, 반환되는 QJsonValue 는 QJsonValue::Undefined 입니다.

QJsonValue, QJsonValue::isUndefined() 및 QJsonObject도 참조하십시오 .

const QJsonValue QJsonValue::operator[](qsizetype i) const

인덱스 i 의 값을 나타내는 ` QJsonValue `를 반환합니다.

toArray().at(i)를 호출하는 것과 동일합니다.

i 가 범위를 벗어났거나 isArray()가 false인 경우, 반환되는 QJsonValue 는 QJsonValue::Undefined 입니다.

QJsonValue, QJsonValue::isUndefined() 및 QJsonArray도 참조하십시오 .

const QJsonValue QJsonValue::operator[](QLatin1StringView key) const

const QJsonValue QJsonValue::operator[](QStringView key) const