/* ============================================================ * * This file is a part of digiKam project * https://www.digikam.org * * Date : 2004-06-15 * Description : Albums manager interface. * * SPDX-FileCopyrightText: 2006-2026 by Gilles Caulier * SPDX-FileCopyrightText: 2006-2011 by Marcel Wiesweg * * SPDX-License-Identifier: GPL-2.0-or-later * * ============================================================ */ #pragma once // Qt includes #include // Local includes #include "album.h" #include "albummanager.h" namespace Digikam { /** * You can use AlbumPointer to store a guarded pointer to Album * or one of the subclasses (use template parameter). * The pointer will be set to 0 when the album object is deleted. */ template class AlbumPointer { public: AlbumPointer() = default; // cppcheck-suppress noExplicitConstructor AlbumPointer(T* const a) // krazy:exclude=explicit : album(a) { AlbumManager::instance()->addGuardedPointer(album, &album); } // cppcheck-suppress noExplicitConstructor AlbumPointer(const AlbumPointer& p) // krazy:exclude=explicit : album(p.album) { AlbumManager::instance()->addGuardedPointer(album, &album); } ~AlbumPointer() { AlbumManager::instance()->removeGuardedPointer(album, &album); } AlbumPointer& operator=(T* const a) { Album* const oldAlbum = album; album = a; AlbumManager::instance()->changeGuardedPointer(oldAlbum, album, &album); return *this; } AlbumPointer& operator=(const AlbumPointer& p) { Album* const oldAlbum = album; album = p.album; AlbumManager::instance()->changeGuardedPointer(oldAlbum, album, &album); return *this; } T* operator->() const { return static_cast(const_cast(album)); } T& operator*() const { return *static_cast(const_cast(album)); } operator T* () const { return static_cast(const_cast(album)); } bool operator!() const { return !album; } private: Album* album = nullptr; friend class AlbumManager; }; // ------------------------------------------------------------------------------------ template class AlbumPointerList : public QList > { public: AlbumPointerList() = default; ~AlbumPointerList() = default; explicit AlbumPointerList(const AlbumPointerList& list) : QList >(list) { } explicit AlbumPointerList(const QList& list) { operator=(list); } // cppcheck-suppress operatorEqRetRefThis AlbumPointerList& operator=(const AlbumPointerList& list) { return QList >::operator=(list); } AlbumPointerList& operator=(const QList& list) { for (T* const t : std::as_const(list)) { this->append(AlbumPointer(t)); } return *this; } }; } // namespace Digikam Q_DECLARE_METATYPE(Digikam::AlbumPointer<>) Q_DECLARE_METATYPE(Digikam::AlbumPointer) Q_DECLARE_METATYPE(Digikam::AlbumPointer) Q_DECLARE_METATYPE(Digikam::AlbumPointer) Q_DECLARE_METATYPE(Digikam::AlbumPointer)