Boost C++ Libraries Home Libraries People FAQ More

PrevUpHomeNext

Class scoped_connection

boost::signals::scoped_connection — Limits a signal-slot connection lifetime to a particular scope.

Synopsis

// In header: <boost/signals/connection.hpp>


class scoped_connection : private noncopyable   // Exposition only
{
public:
  // construct/copy/destruct
  scoped_connection(const connection&);
  ~scoped_connection();

  // connection management
  void disconnect() const;
  bool connected() const;
};

Description

scoped_connection public construct/copy/destruct

  1. scoped_connection(const connection& other);

    Effects:

    this references the connection referenced by other.

    Throws:

    Will not throw.

  2. ~scoped_connection();

    Effects:

    If this->connected(), disconnects the signal-slot connection.

scoped_connection connection management

  1. void disconnect() const;

    Effects:

    If this->connected(), disconnects the signal and slot referenced by this; otherwise, this operation is a no-op.

    Postconditions:

    !this->connected().

  2. bool connected() const;

    Returns:

    true if this references a non-NULL connection that is still active (connected), and false otherwise.

    Throws:

    Will not throw.


PrevUpHomeNext