Класс QStringDecoder

Класс QStringDecoder предоставляет декодер на основе состояний для текста. Подробнее...

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

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

Открытые функции

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

Декодер текста преобразует текст в закодированном формате, использующем определённое кодирование, в внутреннее представление Qt.

Преобразование закодированных данных в QString может быть выполнено с помощью следующего кода:

QByteArray encodedString = "...";
auto toUtf16 = QStringDecoder(QStringDecoder::Utf8);
QString string = toUtf16(encodedString);

Декодер запоминает любое состояние, необходимое между вызовами, поэтому преобразование данных, полученных частями, например, при получении их по сети, также легко выполняется путём вызова декодера всякий раз, когда доступны новые данные:

auto toUtf16 = QStringDecoder(QStringDecoder::Utf8);

QString string;
while (new_data_available()) {
    QByteArray chunk = get_new_data();
    string += toUtf16(chunk);
}

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

Объекты QStringDecoder не могут быть скопированы из-за их внутреннего состояния, но могут быть перемещены.

См. также QStringConverter и QStringEncoder.

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

Преобразует ba и возвращает данные как QString.

QStringDecoder::QStringDecoder(const char *name, QStringConverter::Flags flags = Flag::Default)

Создаёт объект декодера, используя name и flags. Если name не является именем известного кодирования, создаётся недействительный декодер.

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

QStringDecoder::QStringDecoder()

Создаёт декодер по умолчанию. Декодер по умолчанию недействителен и не может быть использован для преобразования текста.

QStringDecoder::QStringDecoder(QStringConverter::Encoding encoding, QStringConverter::Flags flags = Flag::Default)

Создаёт объект декодера, используя encoding и flags.

QChar *QStringDecoder::appendToBuffer(QChar *out, QByteArrayView in)

Декодирует последовательность байтов, представленных in, и записывает результат декодирования в буфер, начиная с out. Возвращает указатель на конец записанных данных.

out должен быть достаточно большим, чтобы вместить все декодированные данные. Используйте requiredSpace, чтобы определить максимальные требования к размеру для декодирования буфера закодированных данных объёмом in.size() байт.

См. также requiredSpace.

qsizetype QStringDecoder::requiredSpace(qsizetype inputLength) const

Возвращает максимальное количество единиц кода UTF-16, необходимых для обработки inputLength закодированных данных.

См. также appendToBuffer.