subscriptor.h

// ---------------------------------------------------------------------
//
// Copyright (C) 1998 - 2018 by the deal.II authors
//
// This file is part of the deal.II library.
//
// The deal.II library is free software; you can use it, redistribute
// it, and/or modify it under the terms of the GNU Lesser General
// Public License as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) any later version.
// The full text of the license can be found in the file LICENSE at
// the top level of the deal.II distribution.
//
// ---------------------------------------------------------------------

#ifndef dealii_subscriptor_h
#define dealii_subscriptor_h


#include <deal.II/base/config.h>
#include <deal.II/base/exceptions.h>

#include <atomic>
#include <map>
#include <string>
#include <typeinfo>

DEAL_II_NAMESPACE_OPEN

class Subscriptor
{
public:
  Subscriptor();

  Subscriptor(const Subscriptor &);

  Subscriptor(Subscriptor &&) noexcept;

  virtual ~Subscriptor();

  Subscriptor &operator = (const Subscriptor &);

  Subscriptor &operator = (Subscriptor &&) noexcept;

  void subscribe (const char *identifier = nullptr) const;

  void unsubscribe (const char *identifier = nullptr) const;

  unsigned int n_subscriptions () const;

  void list_subscribers () const;

  DeclException3(ExcInUse,
                 int, std::string, std::string,
                 << "Object of class " << arg2
                 << " is still used by " << arg1 << " other objects."
                 << "\n\n"
                 << "(Additional information: " << arg3 << ")\n\n"
                 << "See the entry in the Frequently Asked Questions of "
                 << "deal.II (linked to from http://www.dealii.org/) for "
                 << "a lot more information on what this error means and "
                 << "how to fix programs in which it happens.");

  DeclException2(ExcNoSubscriber, std::string, std::string,
                 << "No subscriber with identifier <" << arg2
                 << "> subscribes to this object of class " << arg1
                 << ". Consequently, it cannot be unsubscribed.");

  template <class Archive>
  void serialize(Archive &ar, const unsigned int version);

private:
  typedef std::map<const char *, unsigned int>::value_type
  map_value_type;

  typedef std::map<const char *, unsigned int>::iterator
  map_iterator;

  mutable std::atomic<unsigned int> counter;

  mutable std::map<const char *, unsigned int> counter_map;

  mutable const std::type_info *object_info;

  void check_no_subscribers () const noexcept;
};

//---------------------------------------------------------------------------

template <class Archive>
inline
void
Subscriptor::serialize(Archive &,
                       const unsigned int)
{
  // do nothing, as explained in the
  // documentation of this function
}

DEAL_II_NAMESPACE_CLOSE

#endif