Класс QJsonDocument

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

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

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

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

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

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

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

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

QJsonDocument — это класс, который оборачивает весь JSON-документ и может читать и записывать этот документ как из текстового представления, закодированного в UTF-8, так и в собственном двоичном формате Qt.

JSON-документ можно преобразовать из его текстового представления в QJsonDocument с помощью QJsonDocument::fromJson(). toJson() преобразует его обратно в текст. Парсер очень быстрый и эффективный, и преобразует JSON в двоичное представление, используемое Qt.

Проверить корректность проанализированного документа можно с помощью !isNull()

Можно проверить, содержит ли документ массив или объект, используя isArray() и isObject(). Массив или объект, содержащийся в документе, можно получить с помощью array() или object(), а затем прочитать или изменить.

Документ также может быть создан из сохранённого двоичного представления, используя fromBinaryData() или fromRawData().

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

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

enum QJsonDocument::DataValidation

Это значение используется для указания QJsonDocument, нужно ли проверять двоичные данные при преобразовании в QJsonDocument, используя fromBinaryData() или fromRawData().

enum QJsonDocument::JsonFormat

Это значение определяет формат массива байтов JSON, создаваемого при преобразовании в QJsonDocument с помощью toJson().

    {
        "Array": [
            true,
            999,
            "string"
        ],
        "Key": "Value",
        "null": null
    }

    {"Array":[true,999,"string"],"Key":"Value","null":null}

Этот перечисление был добавлен или изменён в Qt 5.1.

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

QJsonDocument::QJsonDocument(QJsonDocument &&other)

Перемещающее создание QJsonDocument из other.

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

QJsonDocument::QJsonDocument(const QJsonDocument &other)

Создаёт копию документа other.

QJsonDocument::QJsonDocument(const QJsonArray &array)

Создаёт QJsonDocument из array.

QJsonDocument::QJsonDocument(const QJsonObject &object)

Создаёт QJsonDocument из object.

QJsonDocument::QJsonDocument()

Создаёт пустой и недействительный документ.

QJsonDocument &QJsonDocument::operator=(QJsonDocument &&other)

Перемещающее присваивание other этому документу.

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

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

Присваивает документ other этому QJsonDocument. Возвращает ссылку на этот объект.

QJsonDocument::~QJsonDocument()

Удаляет документ.

Бинарные данные, установленные с помощью fromRawData, не освобождаются.

QJsonArray QJsonDocument::array() const

Возвращает QJsonArray, содержащуюся в документе.

Возвращает пустой массив, если документ содержит объект.

См. также isArray(), object() и setArray().

[static] QJsonDocument QJsonDocument::fromBinaryData(const QByteArray &data, QJsonDocument::DataValidation validation = Validate)

Создаёт QJsonDocument из data.

validation определяет, проверяется ли данные на корректность перед использованием. По умолчанию данные проверяются. Если data некорректны, метод возвращает пустой документ.

См. также toBinaryData(), fromRawData(), isNull() и DataValidation.

[static] QJsonDocument QJsonDocument::fromJson(const QByteArray &json, QJsonParseError *error = nullptr)

Парсит json как JSON-документ в кодировке UTF-8 и создаёт из него QJsonDocument.

Возвращает корректный (не пустой) QJsonDocument, если парсинг удался. Если парсинг не удался, возвращённый документ будет пустым, а необязательная переменная error будет содержать дополнительные сведения об ошибке.

См. также toJson(), QJsonParseError и isNull().

[static] QJsonDocument QJsonDocument::fromRawData(const char *data, int size, QJsonDocument::DataValidation validation = Validate)

Создаёт QJsonDocument, использующий первые size байт из data. Предполагается, что data содержит бинарный JSON-документ. Созданный документ не берёт владения над data, и вызывающий должен гарантировать, что data не будет удалён или изменён, пока QJsonDocument, QJsonObject или QJsonArray всё ещё ссылаются на данные.

data должен быть выровнен на границе 4 байта.

validation определяет, проверяются ли данные на корректность перед использованием. По умолчанию данные проверяются. Если data некорректны, метод возвращает пустой документ.

Возвращает QJsonDocument, представляющий данные.

См. также rawData(), fromBinaryData(), isNull() и DataValidation.

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

Создаёт QJsonDocument из QVariant variant.

Если variant содержит тип, отличный от QVariantMap, QVariantHash, QVariantList или QStringList, возвращаемый документ недействителен.

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

bool QJsonDocument::isArray() const

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

См. также array() и isObject().

bool QJsonDocument::isEmpty() const

Возвращает true, если документ не содержит данных.

bool QJsonDocument::isNull() const

Возвращает true, если этот документ пустой.

Пустые документы создаются с помощью конструктора по умолчанию.

Документы, созданные из текста UTF-8 или бинарного формата, проверяются на корректность во время парсинга. Если проверка не пройдена, возвращаемый документ также будет пустым.

bool QJsonDocument::isObject() const

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

См. также object() и isArray().

QJsonObject QJsonDocument::object() const

Возвращает QJsonObject, содержащуюся в документе.

Возвращает пустой объект, если документ содержит массив.

См. также isObject(), array() и setObject().

const char *QJsonDocument::rawData(int *size) const

Возвращает сырое бинарное представление данных. size будет содержать размер возвращаемых данных.

Этот метод полезен, например, для вывода JSON-документа в бинарной форме в файл.

void QJsonDocument::setArray(const QJsonArray &array)

Устанавливает array в качестве основного объекта этого документа.

См. также setObject() и array().

void QJsonDocument::setObject(const QJsonObject &object)

Устанавливает object в качестве основного объекта этого документа.

См. также setArray() и object().

void QJsonDocument::swap(QJsonDocument &other)

Меняет местами документ other с этим. Эта операция очень быстрая и никогда не терпит неудачу.

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

QByteArray QJsonDocument::toBinaryData() const

Возвращает бинарное представление документа.

Бинарное представление также является родным форматом, используемым внутри Qt, и очень эффективным и быстрым для преобразования в и из.

Бинарный формат может быть сохранён на диске и обменён с другими приложениями или компьютерами. fromBinaryData() может быть использован для его преобразования обратно в JSON-документ.

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

QByteArray QJsonDocument::toJson() const

Преобразует QJsonDocument в JSON-документ в кодировке UTF-8.

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

QByteArray QJsonDocument::toJson(QJsonDocument::JsonFormat format) const

Преобразует QJsonDocument в JSON-документ в кодировке UTF-8 в указанном формате format.

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

См. также fromJson() и JsonFormat.

QVariant QJsonDocument::toVariant() const

Возвращает QVariant, представляющую JSON-документ.

Возвращаемый вариант будет QVariantList, если документ является QJsonArray, и QVariantMap, если документ является QJsonObject.

См. также fromVariant() и QJsonValue::toVariant().

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

Возвращает true, если other не равен этому документу

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

Возвращает true если документ other равен этому документу.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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