Класс QXmlInputSource

Класс QXmlInputSource предоставляет входные данные для подклассов QXmlReader. Подробнее...

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

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

Публичные функции

Защищенные функции

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

Класс QXmlInputSource предоставляет входные данные для подклассов QXmlReader.

Все подклассы QXmlReader считывают входной XML-документ из этого класса.

Этот класс распознает кодировку данных, считывая объявление кодировки в XML-файле, если найдёт его, и считывает данные с использованием соответствующей кодировки. Если объявление кодировки не найдено, предполагается, что данные находятся в UTF-8 или UTF-16, в зависимости от того, найдена ли метка порядка байтов.

Существует два способа заполнения источника ввода данными: можно создать его с QIODevice*, чтобы источник ввода считывал данные из этого устройства. Или можно явно задать данные с помощью одной из функций setData().

Обычно вы создаёте QXmlInputSource, работающий с QIODevice*, или создаёте пустой QXmlInputSource и задаёте данные с помощью setData(). Редко возникают ситуации, когда вам нужно использовать оба метода.

Подклассы QXmlReader используют функцию next() для чтения входного символа за символом. Если нужно начать с начала, используйте reset().

Функции data() и fetchData() полезны, если требуется выполнить с данными действия помимо парсинга, например, вывести исходный XML-файл. Преимущество использования QXmlInputClass в таких случаях состоит в том, что он пытается использовать правильную кодировку.

См. также QXmlReader и QXmlSimpleReader.

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

QXmlInputSource::QXmlInputSource()

Создаёт источник ввода, не содержащий данных.

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

QXmlInputSource::QXmlInputSource(QIODevice *dev)

Создаёт источник ввода и получает данные из устройства dev. Если dev не открыт, он открывается в режиме только для чтения. Если dev равен 0 или чтение с устройства невозможно, источник ввода не будет содержать данных.

См. также setData(), fetchData() и QIODevice.

[virtual] QXmlInputSource::~QXmlInputSource()

Деструктор.

[virtual] QString QXmlInputSource::data() const

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

См. также setData(), QXmlInputSource() и fetchData().

[virtual] void QXmlInputSource::fetchData()

Эта функция считывает дополнительные данные из устройства, заданного во время создания. Если источник ввода уже содержал данные, эта функция удаляет эти данные.

Этот объект не содержит данных после вызова этой функции, если объект был создан без устройства для чтения данных или если эта функция не смогла получить больше данных с устройства.

Есть два случая, когда извлечение выполняется неявно другим вызовом функции: во время создания (чтобы объект начинался с некоторых начальных данных, если они доступны) и во время вызова next() (если данные закончились).

Обычно вам не нужно использовать эту функцию, если вы используете next().

См. также data(), next() и QXmlInputSource().

[virtual protected] QString QXmlInputSource::fromRawData(const QByteArray &data, bool beginning = false)

Эта функция считывает XML-файл из data и пытается распознать кодировку. Она преобразует сырые данные data в QString и возвращает его. Она делает всё возможное, чтобы получить правильную кодировку для XML-файла.

Если beginning равно true, эта функция предполагает, что данные начинаются с начала нового XML-документа и ищет объявление кодировки. Если beginning равно false, она преобразует сырые данные, используя кодировку, определённую предыдущими вызовами.

[virtual] QChar QXmlInputSource::next()

Возвращает следующий символ из источника ввода. Если эта функция достигает конца доступных данных, она возвращает QXmlInputSource::EndOfData. Если вы вызываете next() после этого, она пытается загрузить больше данных, вызвав fetchData(). Если вызов fetchData() приводит к новым данным, эта функция возвращает первый символ этих данных; в противном случае она возвращает QXmlInputSource::EndOfDocument.

Читатели, такие как QXmlSimpleReader, будут предполагать, что конец XML-документа достигнут, если эта функция возвращает QXmlInputSource::EndOfDocument, и проверят, что предоставленный ввод правильно сформирован. Поэтому при переопределении этой функции важно обеспечить дублирование этого поведения.

См. также reset(), fetchData(), QXmlSimpleReader::parse() и QXmlSimpleReader::parseContinue().

[virtual] void QXmlInputSource::reset()

Эта функция устанавливает позицию, используемую next(), в начало данных, возвращённых data(). Это полезно, если вы хотите использовать источник ввода для более чем одного парсинга.

Примечание: В случае, если базовым источником данных является QIODevice, текущая позиция в устройстве не устанавливается автоматически в начало ввода. Вызовите QIODevice::seek(0) для устройства.

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

[virtual] void QXmlInputSource::setData(const QString &dat)

Устанавливает данные источника ввода в dat.

Если источник ввода уже содержит данные, эта функция сначала удаляет эти данные.

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

[virtual] void QXmlInputSource::setData(const QByteArray &dat)

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

Данные dat передаются через правильный кодек текста перед установкой.