Spec-Zone.ru › Qt 6.0

Неявное совместное использование

Многие классы C++ в Qt используют неявное совместное использование данных для максимизации использования ресурсов и минимизации копирования. Неявно-совместные классы безопасны и эффективны при передаче в качестве аргументов, поскольку передаётся только указатель на данные, а копирование данных происходит только в том случае, если функция записывает в него, т.е. копирование при записи.

Обзор

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

При создании объекта, использующего совместное использование, счётчик ссылок устанавливается в 1. Счётчик ссылок увеличивается всякий раз, когда новый объект ссылается на общие данные, и уменьшается, когда объект прекращает ссылаться на общие данные. Общие данные удаляются, когда счётчик ссылок становится равным нулю.

При работе с объектами, использующими совместное использование, есть два способа копирования объекта. Обычно говорят о глубоком и поверхностном копировании. Глубокое копирование подразумевает дублирование объекта. Поверхностное копирование — это ссылка на копию, т.е. просто указатель на общий блок данных. Глубокое копирование может быть дорогостоящим с точки зрения памяти и ЦП. Поверхностное копирование очень быстрое, поскольку оно включает только установку указателя и увеличение счётчика ссылок.

Присваивание объекта (с оператором =()) для объектов, использующих неявное совместное использование, реализуется с помощью поверхностного копирования.

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

Неявное совместное использование в основном происходит за кулисами; программисту редко нужно беспокоиться об этом. Однако итераторы контейнеров Qt ведут себя иначе, чем итераторы STL. Прочитайте Проблему итераторов при неявном совместном использовании.

В многопоточных приложениях неявное совместное использование происходит, как описано в Потоки и неявно-совместные классы.

При реализации собственных неявно-совместных классов используйте классы QSharedData и QSharedDataPointer.

Подробное описание неявного совместного использования

Неявное совместное использование автоматически отсоединяет объект от общего блока, если объект собирается измениться, а счётчик ссылок больше единицы. (Это часто называется копированием при записи или семантикой значений.)

Неявно-совместный класс контролирует свои внутренние данные. В любых методах-членах, которые изменяют его данные, он автоматически отсоединяется перед изменением данных. Однако обратите внимание на особый случай с итераторами контейнеров; см. Проблему итераторов при неявном совместном использовании.

Класс QPen, который использует неявное совместное использование, отсоединяется от общих данных во всех методах-членах, которые изменяют внутренние данные.

Фрагмент кода:

void QPen::setStyle(Qt::PenStyle style)
{
    detach();           // detach from common data
    d->style = style;   // set the style member
}

void QPen::detach()
{
    if (d->ref != 1) {
        ...             // perform a deep copy
    }
}

Список классов

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

Пример:

QPixmap p1, p2;
p1.load("image.bmp");
p2 = p1;                        // p1 and p2 share data

QPainter paint;
paint.begin(&p2);               // cuts p2 loose from p1
paint.drawText(0,50, "Hi");
paint.end();

В этом примере p1 и p2 совместно используют данные до вызова QPainter::begin() для p2, так как рисование пиксельной карты изменит её.

Предупреждение: Будьте осторожны при копировании неявно-совместного контейнера (QMap, QList и т.д.) при использовании итераторов в стиле STL. См. Проблему итераторов при неявном совместном использовании.

QBitArray

Массив битов

QBitmap

Монохромные (глубина 1 бит) растровые изображения

QBrush

Определяет узор заливки фигур, нарисованных с помощью QPainter

QByteArray

Массив байтов

QByteArrayList

Список массивов байтов

QByteArrayView

Вид на массив байтов с только для чтения подмножеством API QByteArray

QCache

Шаблонный класс, предоставляющий кэш

QCollator

Сравнивает строки в соответствии с алгоритмом сортировки, локализованным для определённого языка

QCollatorSortKey

Может быть использован для ускорения сортировки строк

QCommandLineOption

Определяет возможный параметр командной строки

QContiguousCache

Шаблонный класс, предоставляющий непрерывный кэш

QCursor

Курсор мыши с произвольной формой

QDBusPendingCall

Ссылается на один ожидающий асинхронный вызов

QDBusUnixFileDescriptor

Содержит один дескриптор Unix-файла

QDateTime

Функции даты и времени

QDebug

Поток вывода для отладочной информации

QDir

Доступ к структурам каталогов и их содержимому

QDnsDomainNameRecord

Хранит информацию о записи доменного имени

QDnsHostAddressRecord

Хранит информацию о записи адреса хоста

QDnsMailExchangeRecord

Хранит информацию о записи DNS MX

QDnsServiceRecord

Хранит информацию о записи DNS SRV

QDnsTextRecord

Хранит информацию о записи DNS TXT

QFileInfo

Независимая от платформы информация о файлах

QFont

Определяет запрос на шрифт, используемый для отображения текста

QFontInfo

Общая информация о шрифтах

QFontMetrics

Информация о метриках шрифта

QFontMetricsF

Информация о метриках шрифта

QGlyphRun

Прямой доступ к внутренним глифам в шрифте

QGradient

Используется в сочетании с QBrush для указания градиентной заливки

QHash

Шаблонный класс, предоставляющий словарь на основе хеш-таблицы

QHostAddress

IP-адрес

QHttp2Configuration

Управляет параметрами и настройками HTTP/2

QHttpPart

Содержит часть тела, которая будет использована внутри сообщения HTTP multipart MIME

QIcon

Масштабируемые значки в различных режимах и состояниях

QImage

Независимое от оборудования представление изображения, позволяющее напрямую получить доступ к данным пикселей и может быть использовано в качестве устройства рисования

QJsonArray

Инкапсулирует JSON-массив

QJsonDocument

Способ чтения и записи JSON-документов

QJsonObject

Инкапсулирует JSON-объект

QJsonParseError

Используется для отчётности об ошибках во время разбора JSON

QJsonValue

Инкапсулирует значение в JSON

QKeySequence

Инкапсулирует последовательность нажатий клавиш, используемую для сочетаний клавиш

QLinkedList

Шаблонный класс, предоставляющий списки

QList

Шаблонный класс, предоставляющий динамический массив

QLocale

Преобразует числа в их строковые представления на разных языках

QMap

Шаблонный класс, предоставляющий ассоциативный массив

QMimeType

Описывает типы файлов или данных, представленные строкой MIME-типа

QMultiHash

Удобный подкласс QHash, предоставляющий многозначные хеши

QMultiMap

Шаблонный класс, предоставляющий ассоциативный массив с несколькими эквивалентными ключами

QNetworkAddressEntry

Хранит один IP-адрес, поддерживаемый сетевым интерфейсом, а также его маску сети и адрес широковещательной передачи

QNetworkCacheMetaData

Информация о кэше

QNetworkCookie

Содержит один сетевой cookie

QNetworkInterface

Список IP-адресов и сетевых интерфейсов хоста

QNetworkProxy

Прокси-сервер сетевого уровня

QNetworkProxyQuery

Используется для запроса настроек прокси-сервера для сокета

QNetworkRequest

Содержит запрос, который должен быть отправлен с помощью QNetworkAccessManager

QOpenGLDebugMessage

Оборачивает сообщение отладки OpenGL

QPageRanges

Представляет собой набор диапазонов страниц

QPainterPath

Контейнер для операций рисования, позволяющий строить и повторно использовать графические фигуры

QPalette

Содержит группы цветов для каждого состояния виджета

QPen

Определяет, как QPainter должен рисовать линии и контуры фигур

QPersistentModelIndex

Используется для поиска данных в модели данных

QPicture

Устройство рисования, которое записывает и воспроизводит команды QPainter

QPixmap

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

QPolygon

Список точек с целочисленной точностью

QPolygonF

Список точек с плавающей точкой

QProcessEnvironment

Хранит переменные среды, которые могут быть переданы программе

QQueue

Обобщённый контейнер, который обеспечивает очередь

QRawFont

Доступ к одному физическому экземпляру шрифта

QRegExp

Сопоставление с образцом с использованием регулярных выражений

QRegion

Определяет область обрезки для художника

QRegularExpression

Сопоставление с образцом с использованием регулярных выражений

QRegularExpressionMatch

Результаты сопоставления QRegularExpression со строкой

QRegularExpressionMatchIterator

Итератор по результатам глобального сопоставления объекта QRegularExpression со строкой

QSet

Шаблонный класс, который предоставляет множество на основе хеш-таблицы

QSqlField

Работает с полями в таблицах и представлениях баз данных SQL

QSqlQuery

Средства выполнения и обработки SQL-запросов

QSqlRecord

Инкапсулирует запись базы данных

QSslCertificate

Удобный API для сертификата X509

QSslCertificateExtension

API для доступа к расширениям сертификата X509

QSslCipher

Представляет криптографический шифр SSL

QSslConfiguration

Содержит конфигурацию и состояние соединения SSL

QSslDiffieHellmanParameters

Интерфейс для параметров Diffie-Hellman для серверов

QSslError

Ошибка SSL

QSslKey

Интерфейс для закрытых и открытых ключей

QSslPreSharedKeyAuthenticator

Данные аутентификации для шифров с предварительно согласованными ключами (PSK)

QStack

Шаблонный класс, который предоставляет стек

QStaticText

Обеспечивает оптимизированное отображение текста, когда текст и его макет обновляются редко

QStorageInfo

Предоставляет информацию о подключенных хранилищах и дисках

QString

Строка с символами Юникода

QStringList

Список строк

QTextBlockFormat

Информация о форматировании блоков текста в QTextDocument

QTextBoundaryFinder

Способ нахождения границ текста Юникода в строке

QTextCharFormat

Информация о форматировании символов в QTextDocument

QTextCursor

Предлагает API для доступа к QTextDocuments и их модификации

QTextDocumentFragment

Представляет часть форматированного текста из QTextDocument

QTextFormat

Информация о форматировании QTextDocument

QTextFrameFormat

Информация о форматировании фреймов в QTextDocument

QTextImageFormat

Информация о форматировании изображений в QTextDocument

QTextListFormat

Информация о форматировании списков в QTextDocument

QTextTableCellFormat

Информация о форматировании ячеек таблицы в QTextDocument

QTextTableFormat

Информация о форматировании таблиц в QTextDocument

QUrl

Удобный интерфейс для работы с URL

QUrlQuery

Способ работы с парами ключ-значение в запросе URL

QVariant

Выступает как объединение для наиболее распространённых типов данных Qt

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

Spec-Zone.ru

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