Класс QPointer

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

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

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

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

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

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

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

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

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

• При использовании QPointer на QWidget (или подклассе QWidget), ранее QPointer очищался деструктором QWidget. Теперь QPointer очищается деструктором QObject (так как именно в этом случае очищаются объекты QWeakPointer). Любые QPointers, отслеживающие виджет, НЕ будут очищены до того, как деструктор 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<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.