/usr/include/kido/common/Observer.hpp is in libkido-dev 0.1.0+dfsg-2build9.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 | /*
* Copyright (c) 2015, Georgia Tech Research Corporation
* All rights reserved.
*
* Author(s): Michael X. Grey <mxgrey@gatech.edu>
*
* Georgia Tech Graphics Lab and Humanoid Robotics Lab
*
* Directed by Prof. C. Karen Liu and Prof. Mike Stilman
* <karenliu@cc.gatech.edu> <mstilman@cc.gatech.edu>
*
* This file is provided under the following "BSD-style" License:
* Redistribution and use in source and binary forms, with or
* without modification, are permitted provided that the following
* conditions are met:
* * Redistributions of source code must retain the above copyright
* notice, this list of conditions and the following disclaimer.
* * Redistributions in binary form must reproduce the above
* copyright notice, this list of conditions and the following
* disclaimer in the documentation and/or other materials provided
* with the distribution.
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND
* CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES,
* INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
* MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
* CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
* USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
* AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
* ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
* POSSIBILITY OF SUCH DAMAGE.
*/
#ifndef KIDO_COMMON_OBSERVER_HPP_
#define KIDO_COMMON_OBSERVER_HPP_
#include <set>
namespace kido {
namespace common {
class Subject;
/// The Observer class should be inherited by any class that wants to respond
/// in a customized way to the destruction of a Subject. Simply override the
/// Observer::handleDestructionNotification() function to customize how your
/// class responds to the destruction of a Subject.
///
/// kido::sub_ptr is a templated smart pointer that will change itself into a
/// nullptr when its Subject is destroyed. It offers one of the easiest ways to
/// take advantage of the Subject/Observer pattern.
class Observer
{
public:
friend class Subject;
/// Destructor will notify all Subjects that it is destructing
virtual ~Observer();
protected:
/// Called whenever a Subject is destroyed (or sends out a destruction
/// notification). Override handleDestructionNotification() in order to
/// customize your class's response to destruction notifications.
void receiveDestructionNotification(const Subject* _subject);
/// Called by receiveDestructionNotification(). Override this function to
/// customize your class's response to destruction notifications.
virtual void handleDestructionNotification(const Subject* _subject);
/// Add a Subject for this Observer
void addSubject(const Subject* _subject);
/// Remove a Subject from this Observer
void removeSubject(const Subject* _subject);
/// Remove all Subjects from this Observer
void removeAllSubjects();
/// List of current Subjects for this Observer
std::set<const Subject*> mSubjects;
};
} // namespace kido
} // namespace common
#endif // KIDO_COMMON_OBSERVER_HPP_
|