Класс QPointer

Класс QPointer — это шаблонный класс, который предоставляет защищённые указатели на QObject. Подробнее...

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

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

Связанные нечлены

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

Защищённый указатель QPointer<T> ведет себя как обычный C++ указатель T *, за исключением того, что он автоматически очищается, когда связанный объект уничтожается (в отличие от обычных C++ указателей, которые в таких случаях становятся «висячими указателями»). T должен быть подклассом QObject.

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

Обратите внимание, что в Qt 5 произошли небольшие изменения в поведении при использовании QPointer.

• При использовании QPointer на QWidget (или подклассе QWidget), ранее QPointer очищался деструктором QWidget. Сейчас QPointer очищается деструктором QObject (так как именно в этот момент очищаются объекты QWeakPointer). Любые QPointer, отслеживающие виджет, НЕ БУДУТ очищены до того, как деструктор QWidget уничтожит дочерние элементы отслеживаемого виджета.

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

Пример:

    QPointer<QLabel> label = new QLabel;
    label->setText("&Status:");
    ...
    if (label)
        label->show();

Если QLabel будет удалён в это время, переменная label будет содержать nullptr вместо некорректного адреса, и последняя строка никогда не будет выполнена.

Доступные функции и операторы с QPointer аналогичны доступным для обычного незащищённого указателя, за исключением операторов арифметики указателей (+, -, ++, и --), которые обычно используются только с массивами объектов.

Используйте QPointer как обычные указатели, и вам не нужно будет читать документацию по этому классу.

Для создания защищённых указателей можно создавать или присваивать их из T* или другого защищённого указателя того же типа. Вы можете сравнивать их друг с другом, используя operator==() и operator!=(), или проверять на nullptr с помощью isNull(). Вы можете обращаться к ним с помощью *x или x->member обозначений.

Защищённый указатель будет автоматически приведён к типу T *, поэтому вы можете свободно смешивать защищённые и незащищённые указатели. Это означает, что если у вас есть QPointer<QWidget>, вы можете передать его в функцию, которая требует QWidget *. По этой причине объявление функций, принимающих QPointer в качестве параметра, имеет мало смысла; просто используйте обычные указатели. Используйте QPointer, когда вам нужно хранить указатель со временем.

Обратите внимание, что класс T должен наследоваться от QObject, в противном случае произойдёт ошибка компиляции или компоновки.

См. также QSharedPointer, QObject и QObjectCleanupHandler.

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

QPointer::QPointer(T *p)

Создаёт защищённый указатель, который указывает на тот же объект, что и p.

QPointer::QPointer()

Создаёт защищённый указатель со значением nullptr.

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

QPointer::~QPointer()

Уничтожает защищённый указатель. Как и обычный указатель, уничтожение защищённого указателя не уничтожает объект, на который он указывает.

void QPointer::clear()

Очищает этот объект QPointer.

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

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

T *QPointer::data() const

Возвращает указатель на защищаемый объект.

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

bool QPointer::isNull() const

Возвращает true, если связанный объект был уничтожен или если нет связанного объекта; в противном случае возвращает false.

void QPointer::swap(QPointer<T> &other)

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

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

T *QPointer::operator T *() const

Оператор приведения типов; реализует семантику указателей. Благодаря этой функции вы можете передать QPointer<T> в функцию, где требуется T*.

T &QPointer::operator*() const

Оператор разыменования; реализует семантику указателей. Используйте этот оператор так же, как и с обычным C++ указателем.

T *QPointer::operator->() const

Перегруженный оператор стрелки; реализует семантику указателей. Используйте этот оператор так же, как и с обычным C++ указателем.

QPointer<T> &QPointer::operator=(T *p)

Оператор присваивания. Этот защищённый указатель теперь будет указывать на тот же объект, что и p.