qobjectcleanuphandler.cpp

Absolute File Name:

/home/qt/qt5_coco/qt5/qtbase/src/corelib/kernel/qobjectcleanuphandler.cpp

Source code

Switch to Preprocessed file

Line Source Count

1 /**************************************************************************** -

2 ** -

4 ** Contact: http://www.qt.io/licensing/ -

5 ** -

6 ** This file is part of the QtCore module of the Qt Toolkit. -

7 ** -

8 ** $QT_BEGIN_LICENSE:LGPL21$ -

9 ** Commercial License Usage -

10 ** Licensees holding valid commercial Qt licenses may use this file in -

11 ** accordance with the commercial license agreement provided with the -

12 ** Software or, alternatively, in accordance with the terms contained in -

13 ** a written agreement between you and The Qt Company. For licensing terms -

14 ** and conditions see http://www.qt.io/terms-conditions. For further -

15 ** information use the contact form at http://www.qt.io/contact-us. -

16 ** -

17 ** GNU Lesser General Public License Usage -

18 ** Alternatively, this file may be used under the terms of the GNU Lesser -

19 ** General Public License version 2.1 or version 3 as published by the Free -

20 ** Software Foundation and appearing in the file LICENSE.LGPLv21 and -

21 ** LICENSE.LGPLv3 included in the packaging of this file. Please review the -

22 ** following information to ensure the GNU Lesser General Public License -

23 ** requirements will be met: https://www.gnu.org/licenses/lgpl.html and -

24 ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html. -

25 ** -

26 ** As a special exception, The Qt Company gives you certain additional -

27 ** rights. These rights are described in The Qt Company LGPL Exception -

28 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package. -

29 ** -

30 ** $QT_END_LICENSE$ -

31 ** -

32 ****************************************************************************/ -

33 -

34 #include "qobjectcleanuphandler.h" -

35 -

36 QT_BEGIN_NAMESPACE -

37 -

38 /*! -

39 \class QObjectCleanupHandler -

40 \inmodule QtCore -

41 \brief The QObjectCleanupHandler class watches the lifetime of multiple QObjects. -

42 -

43 \ingroup objectmodel -

44 -

45 A QObjectCleanupHandler is useful whenever you need to know when a -

46 number of \l{QObject}s that are owned by someone else have been -

47 deleted. This is important, for example, when referencing memory -

48 in an application that has been allocated in a shared library. -

49 -

50 To keep track of some \l{QObject}s, create a -

51 QObjectCleanupHandler, and add() the objects you are interested -

52 in. If you are no longer interested in tracking a particular -

53 object, use remove() to remove it from the cleanup handler. If an -

54 object being tracked by the cleanup handler gets deleted by -

55 someone else it will automatically be removed from the cleanup -

56 handler. You can delete all the objects in the cleanup handler -

57 with clear(), or by destroying the cleanup handler. isEmpty() -

58 returns \c true if the QObjectCleanupHandler has no objects to keep -

59 track of. -

60 -

61 \sa QPointer -

62 */ -

63 -

64 /*! -

65 Constructs an empty QObjectCleanupHandler. -

66 */ -

67 QObjectCleanupHandler::QObjectCleanupHandler() -

68 { -

69 } -

70 -

71 /*! -

72 Destroys the cleanup handler. All objects in this cleanup handler -

73 will be deleted. -

74 -

75 \sa clear() -

76 */ -

77 QObjectCleanupHandler::~QObjectCleanupHandler() -

78 { -

79 clear(); -

}

never executed: end of block

81 -

82 /*! -

83 Adds \a object to this cleanup handler and returns the pointer to -

84 the object. -

85 -

86 \sa remove() -

87 */ -

88 QObject *QObjectCleanupHandler::add(QObject* object) -

89 { -

if (!object)

!object	Description
TRUE	never evaluated
FALSE	never evaluated

return 0;

never executed: return 0;

92 -

93 connect(object, SIGNAL(destroyed(QObject*)), this, SLOT(objectDestroyed(QObject*))); -

94 cleanupObjects.insert(0, object); -

return object;

never executed: return object;

96 } -

97 -

98 /*! -

99 Removes the \a object from this cleanup handler. The object will -

100 not be destroyed. -

101 -

102 \sa add() -

103 */ -

104 void QObjectCleanupHandler::remove(QObject *object) -

105 { -

106 int index; -

107

if ((index = cleanupObjects.indexOf(object)) != -1) {

(index = clean...object)) != -1	Description
TRUE	never evaluated
FALSE	never evaluated

108 cleanupObjects.removeAt(index); -

109 disconnect(object, SIGNAL(destroyed(QObject*)), this, SLOT(objectDestroyed(QObject*))); -

110

}

never executed: end of block

111

}

never executed: end of block

112 -

113 /*! -

114 Returns \c true if this cleanup handler is empty or if all objects in -

115 this cleanup handler have been destroyed; otherwise return false. -

116 -

117 \sa add(), remove(), clear() -

118 */ -

119 bool QObjectCleanupHandler::isEmpty() const -

120 { -

121

return cleanupObjects.isEmpty();

never executed: return cleanupObjects.isEmpty();

122 } -

123 -

124 /*! -

125 Deletes all objects in this cleanup handler. The cleanup handler -

126 becomes empty. -

127 -

128 \sa isEmpty() -

129 */ -

130 void QObjectCleanupHandler::clear() -

131 { -

132

while (!cleanupObjects.isEmpty())

!cleanupObjects.isEmpty()	Description
TRUE	never evaluated
FALSE	never evaluated

133

delete cleanupObjects.takeFirst();

never executed: delete cleanupObjects.takeFirst();

134

}

never executed: end of block

135 -

136 void QObjectCleanupHandler::objectDestroyed(QObject *object) -

137 { -

138 remove(object); -

139

}

never executed: end of block

140 -

141 QT_END_NAMESPACE -

Source code

Switch to Preprocessed file

Generated by Squish Coco Non-Commercial 4.3.0-BETA-master-30-08-2018-4cb69e9