Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is the documentation for an old version of boost. Click here for the latest Boost documentation.
PrevUpHomeNext

Class template bs_set_member_hook

boost::intrusive::bs_set_member_hook

Synopsis

// In header: <boost/intrusive/bs_set_hook.hpp>

template<class... Options> 
class bs_set_member_hook {
public:
  // construct/copy/destruct
  bs_set_member_hook();
  bs_set_member_hook(const bs_set_member_hook &);
  bs_set_member_hook& operator=(const bs_set_member_hook &);
  ~bs_set_member_hook();

  // private member functions
  void swap_nodes(bs_set_member_hook &) ;
  bool is_linked() const;
  void unlink() ;
};

Description

Put a public data member bs_set_member_hook in order to store objects of this class in a bs_set/bs_multiset. bs_set_member_hook holds the data necessary for maintaining the bs_set/bs_multiset and provides an appropriate value_traits class for bs_set/bs_multiset.

The hook admits the following options: void_pointer<>, link_mode<>.

void_pointer<> is the pointer type that will be used internally in the hook and the the container configured to use this hook.

link_mode<> will specify the linking mode of the hook (normal_link, auto_unlink or safe_link).

bs_set_member_hook public construct/copy/destruct

  1. bs_set_member_hook();

    Effects: If link_mode is auto_unlink or safe_link initializes the node to an unlinked state.

    Throws: Nothing.

  2. bs_set_member_hook(const bs_set_member_hook &);

    Effects: If link_mode is auto_unlink or safe_link initializes the node to an unlinked state. The argument is ignored.

    Throws: Nothing.

    Rationale: Providing a copy-constructor makes classes using the hook STL-compliant without forcing the user to do some additional work. swap can be used to emulate move-semantics.

  3. bs_set_member_hook& operator=(const bs_set_member_hook &);

    Effects: Empty function. The argument is ignored.

    Throws: Nothing.

    Rationale: Providing an assignment operator makes classes using the hook STL-compliant without forcing the user to do some additional work. swap can be used to emulate move-semantics.

  4. ~bs_set_member_hook();

    Effects: If link_mode is normal_link, the destructor does nothing (ie. no code is generated). If link_mode is safe_link and the object is stored in a set an assertion is raised. If link_mode is auto_unlink and is_linked() is true, the node is unlinked.

    Throws: Nothing.

bs_set_member_hook private member functions

  1. void swap_nodes(bs_set_member_hook & other) ;

    Effects: Swapping two nodes swaps the position of the elements related to those nodes in one or two containers. That is, if the node this is part of the element e1, the node x is part of the element e2 and both elements are included in the containers s1 and s2, then after the swap-operation e1 is in s2 at the position of e2 and e2 is in s1 at the position of e1. If one element is not in a container, then after the swap-operation the other element is not in a container. Iterators to e1 and e2 related to those nodes are invalidated.

    Complexity: Constant

    Throws: Nothing.

  2. bool is_linked() const;

    Precondition: link_mode must be safe_link or auto_unlink.

    Returns: true, if the node belongs to a container, false otherwise. This function can be used to test whether set::iterator_to will return a valid iterator.

    Complexity: Constant

  3. void unlink() ;

    Effects: Removes the node if it's inserted in a container. This function is only allowed if link_mode is auto_unlink.

    Throws: Nothing.


PrevUpHomeNext