Класс QPointer

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

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

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

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

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

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

Защищённый указатель QPointer<T> ведет себя как обычный C++ указатель T *, за исключением того, что он автоматически устанавливается в 0, когда ссылаемый объект уничтожается (в отличие от обычных 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 будет содержать 0 вместо недействительного адреса, и последняя строка никогда не будет выполнена.

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

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

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

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

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

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

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

QPointer::QPointer()

Конструирует защищённый указатель 0.

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

QPointer::QPointer(T *p)

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

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 &other)

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

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

QPointer::operator T *() const

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

T &QPointer::operator*() const

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

T *QPointer::operator->() const

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

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

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