Spec-Zone.ru › Qt 5.14

Класс QJsonValue

Класс QJsonValue инкапсулирует значение в формате JSON. Подробнее...

Заголовок: #include <QJsonValue>
qmake: QT += core
С тех пор как: Qt 5.0

Этот класс был представлен в Qt 5.0.

  • Список всех членов, включая унаследованные

Примечание: Все функции в этом классе являются реентерабельными.

Типы публичного доступа

Перечисление Тип { Null, Bool, Double, String, Array, …, Undefined }

Функции публичного доступа

QJsonValue(QJsonValue &&other)
QJsonValue(const QJsonValue &other)
QJsonValue(const QJsonObject &o)
QJsonValue(const QJsonArray &a)
QJsonValue(const char *s)
QJsonValue(QLatin1String s)
QJsonValue(const QString &s)
QJsonValue(qint64 n)
QJsonValue(int n)
QJsonValue(double n)
QJsonValue(bool b)
QJsonValue(QJsonValue::Type type = Null)
QJsonValue & operator=(QJsonValue &&other)
QJsonValue & operator=(const QJsonValue &other)
~QJsonValue()
bool isArray() const
bool isBool() const
bool isDouble() const
bool isNull() const
bool isObject() const
bool isString() const
bool isUndefined() const
void swap(QJsonValue &other)

Статические публичные члены

QJsonValue fromVariant(const QVariant &variant)

Подробное описание

Значение в формате JSON может быть одного из 6 основных типов:

JSON — это формат для хранения структурированных данных. Он имеет 6 основных типов данных:

  • bool QJsonValue::Bool
  • double QJsonValue::Double
  • строка QJsonValue::String
  • массив QJsonValue::Array
  • объект QJsonValue::Object
  • null QJsonValue::Null

Значение может представлять любой из вышеперечисленных типов данных. Кроме того, QJsonValue имеет один специальный флаг для представления неопределенных значений. Это можно запросить с помощью isUndefined().

Тип значения можно запросить с помощью type() или с помощью аксессоров, таких как isBool(), isString() и т. д. Аналогично, значение можно преобразовать в тип, хранящийся в нем, используя toBool(), toString() и т. д.

Значения строго типизированы внутри и в отличие от QVariant, не будут пытаться выполнять неявные преобразования типов. Это означает, что преобразование в тип, который не хранится в значении, вернёт значение по умолчанию.

QJsonValueRef

QJsonValueRef — это вспомогательный класс для QJsonArray и QJsonObject. Когда вы получаете объект типа QJsonValueRef, вы можете использовать его так, как если бы это была ссылка на QJsonValue. Если вы присваиваете ему значение, присваивание будет применено к элементу в QJsonArray или QJsonObject, из которого вы получили ссылку.

Следующие методы возвращают QJsonValueRef:

  • QJsonArray::operator[](int i)
  • QJsonObject::operator[](const QString & key) const

См. также Поддержка JSON в Qt и Пример сохранения игры в формате JSON.

Документация по типам членов

Перечисление QJsonValue::Тип

Это перечисление описывает тип значения JSON.

Константа Значение Описание
QJsonValue::Null 0x0 Значение Null
QJsonValue::Bool 0x1 Булево значение. Используйте toBool() для преобразования в bool.
QJsonValue::Double 0x2 Тип double. Используйте toDouble() для преобразования в double.
QJsonValue::String 0x3 Строка. Используйте toString() для преобразования в QString.
QJsonValue::Array 0x4 Массив. Используйте toArray() для преобразования в QJsonArray.
QJsonValue::Object 0x5 Объект. Используйте toObject() для преобразования в QJsonObject.
QJsonValue::Undefined 0x80 Значение неопределено. Обычно возвращается как условие ошибки, когда вы пытаетесь прочитать значение за пределами границ массива или несуществующий ключ в объекте.

Документация по членам-функциям

QJsonValue::QJsonValue(QJsonValue &&other)

Создаёт QJsonValue, перемещая данные из other.

Функция добавлена в Qt 5.10.

QJsonValue::QJsonValue(const QJsonValue &other)

Создаёт копию other.

QJsonValue::QJsonValue(const QJsonObject &o)

Создаёт значение типа Object со значением o.

QJsonValue::QJsonValue(const QJsonArray &a)

Создаёт значение типа Array со значением a.

QJsonValue::QJsonValue(const char *s)

Создаёт значение типа String со значением s, предполагая кодировку UTF-8 для входных данных.

Вы можете отключить этот конструктор, определив QT_NO_CAST_FROM_ASCII при компиляции приложения.

Функция добавлена в Qt 5.3.

QJsonValue::QJsonValue(QLatin1String s)

Создаёт значение типа String со значением s.

QJsonValue::QJsonValue(const QString &s)

Создаёт значение типа String со значением s.

QJsonValue::QJsonValue(qint64 n)

Это перегруженная функция.

Создаёт значение типа Double со значением n. ПРИМЕЧАНИЕ: пределы целых чисел для данных с двойной точностью IEEE 754 составляют 2^53 (-9007199254740992 до +9007199254740992). Если вы передаёте значения за пределами этого диапазона, ожидайте потерю точности.

QJsonValue::QJsonValue(int n)

Это перегруженная функция.

Создаёт значение типа Double со значением n.

QJsonValue::QJsonValue(double n)

Создаёт значение типа Double со значением n.

QJsonValue::QJsonValue(bool b)

Создаёт значение типа Bool со значением b.

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

Создаёт QJsonValue типа type.

По умолчанию создаётся значение Null.

QJsonValue &QJsonValue::operator=(QJsonValue &&other)

Присваивает other этому значению, перемещая данные.

Функция добавлена в Qt 5.10.

QJsonValue &QJsonValue::operator=(const QJsonValue &other)

Присваивает значение из other этому объекту.

QJsonValue::~QJsonValue()

Удаляет значение.

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

Преобразует variant в QJsonValue и возвращает его.

Преобразование выполняется следующим образом:

Исходный тип Целевой тип
  • QMetaType::Nullptr
 QJsonValue::Null
  • QMetaType::Bool
 QJsonValue::Bool
  • QMetaType::Int
  • QMetaType::UInt
  • QMetaType::LongLong
  • QMetaType::ULongLong
  • QMetaType::Float
  • QMetaType::Double
 QJsonValue::Double
  • QMetaType::QString
 QJsonValue::String
  • QMetaType::QStringList
  • QMetaType::QVariantList
 QJsonValue::Array
  • QMetaType::QVariantMap
  • QMetaType::QVariantHash
 QJsonValue::Object
  • QMetaType::QUrl
 QJsonValue::String. Преобразование использует QUrl::toString() со флагом QUrl::FullyEncoded для максимальной совместимости при разборе URL.
  • QMetaType::QUuid
 QJsonValue::String. С Qt 5.11 результат будет без фигурных скобок.
  • QMetaType::QCborValue
 Любой тип, который возвращает QCborValue::toJsonValue().
  • QMetaType::QCborArray
 QJsonValue::Array. См. QCborValue::toJsonValue() для ограничений преобразования.
  • QMetaType::QCborMap
 QJsonValue::Map. См. QCborValue::toJsonValue() для ограничений преобразования и "строкового" представления ключей словаря.

Для всех остальных типов QVariant будет выполнена попытка преобразования в QString. Если возвращённая строка пуста, будет храниться Null QJsonValue, в противном случае — значение String с возвращённым QString.

См. также toVariant().

bool QJsonValue::isArray() const

Возвращает true если значение содержит массив.

См. также toArray().

bool QJsonValue::isBool() const

Возвращает true если значение содержит булево значение.

См. также toBool().

bool QJsonValue::isDouble() const

Возвращает true если значение содержит тип double.

См. также toDouble().

bool QJsonValue::isNull() const

Возвращает true если значение равно null.

bool QJsonValue::isObject() const

Возвращает true если значение содержит объект.

См. также toObject().

bool QJsonValue::isString() const

Возвращает true если значение содержит строку.

См. также toString().

bool QJsonValue::isUndefined() const

Возвращает true если значение неопределено. Это может произойти в определённых случаях ошибок, например, при обращении к несуществующему ключу в QJsonObject.

void QJsonValue::swap(QJsonValue &other)

Меняет местами значения other и этого объекта. Операция очень быстрая и никогда не завершается ошибкой.

Функция добавлена в Qt 5.10.

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

Преобразует значение в массив и возвращает его.

Если тип() не является массивом, возвращается defaultValue.

QJsonArray QJsonValue::toArray() const

Это перегруженная функция.

Преобразует значение в массив и возвращает его.

Если тип() не является массивом, возвращается QJsonArray().

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

Преобразует значение в bool и возвращает его.

Если тип() не является bool, возвращается defaultValue.

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

Преобразует значение в double и возвращает его.

Если тип() не является Double, возвращается defaultValue.

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

Преобразует значение в int и возвращает его.

Если тип() не является Double или значение не является целым числом, возвращается defaultValue.

Эта функция была добавлена в Qt 5.2.

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

Преобразует значение в объект и возвращает его.

Если тип() не является объектом, возвращается defaultValue.

QJsonObject QJsonValue::toObject() const

Это перегруженная функция.

Преобразует значение в объект и возвращает его.

Если тип() не является объектом, возвращается QJsonObject().

QString QJsonValue::toString() const

Преобразует значение в QString и возвращает его.

Если тип() не является строкой, возвращается пустая QString.

См. также QString::isNull().

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

Преобразует значение в QString и возвращает его.

Если тип() не является строкой, возвращается defaultValue.

QVariant QJsonValue::toVariant() const

Преобразует значение в QVariant().

Типы QJsonValue будут преобразованы следующим образом:

Постоянная Описание
Null QMetaType::Nullptr
Bool QMetaType::Bool
Double QMetaType::Double
String QString
Array QVariantList
Object QVariantMap
Undefined QVariant()

См. также fromVariant().

QJsonValue::Type QJsonValue::type() const

Возвращает тип значения.

См. также QJsonValue::Type.

bool QJsonValue::operator!=(const QJsonValue &other) const

Возвращает true, если значение не равно other.

bool QJsonValue::operator==(const QJsonValue &other) const

Возвращает true, если значение равно other.

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

Возвращает QJsonValue, представляющую значение для ключа key.

Эквивалентно вызову toObject().value(key).

Возвращаемое QJsonValue имеет тип QJsonValue::Undefined, если ключ не существует или isObject() ложно.

Эта функция была добавлена в Qt 5.10.

См. также QJsonValue, QJsonValue::isUndefined() и QJsonObject.

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

Это перегруженная функция.

Эта функция была добавлена в Qt 5.14.

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

Это перегруженная функция.

Эта функция была добавлена в Qt 5.10.

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

Возвращает QJsonValue, представляющую значение для индекса i.

Эквивалентно вызову toArray().at(i).

Возвращаемое QJsonValue имеет тип QJsonValue::Undefined, если i выходит за пределы массива или isArray() ложно.

Эта функция была добавлена в Qt 5.10.

См. также QJsonValue, QJsonValue::isUndefined() и QJsonArray.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.14/qjsonvalue.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API