ns3::Callback< R, T1, T2, T3, T4, T5, T6, T7, T8, T9 > Class Template Reference

Callback template class. More...

#include <callback.h>

Inheritance diagram for ns3::Callback< R, T1, T2, T3, T4, T5, T6, T7, T8, T9 >:

Public Member Functions
template<typename FUNCTOR >
	Callback (FUNCTOR const &functor, bool, bool)
template<typename OBJ_PTR , typename MEM_PTR >
	Callback (OBJ_PTR const &objPtr, MEM_PTR mem_ptr)
	Callback (Ptr< CallbackImpl< R, T1, T2, T3, T4, T5, T6, T7, T8, T9 > > const &impl)
void	Assign (const CallbackBase &other)
template<typename T >
Callback< R, T2, T3, T4, T5, T6, T7, T8, T9 >	Bind (T a)
bool	CheckType (const CallbackBase &other) const
bool	IsEqual (const CallbackBase &other) const
bool	IsNull (void) const
void	Nullify (void)
R	operator() (void) const
R	operator() (T1 a1) const
R	operator() (T1 a1, T2 a2) const
R	operator() (T1 a1, T2 a2, T3 a3) const
R	operator() (T1 a1, T2 a2, T3 a3, T4 a4) const
R	operator() (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5) const
R	operator() (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6) const
R	operator() (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7) const
R	operator() (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7, T8 a8) const
R	operator() (T1 a1, T2 a2, T3 a3, T4 a4, T5 a5, T6 a6, T7 a7, T8 a8, T9 a9) const
Public Member Functions inherited from ns3::CallbackBase
Ptr< CallbackImplBase >	GetImpl (void) const

Private Member Functions
void	DoAssign (Ptr< const CallbackImplBase > other)
bool	DoCheckType (Ptr< const CallbackImplBase > other) const
CallbackImpl< R, T1, T2, T3, T4, T5, T6, T7, T8, T9 > *	DoPeekImpl (void) const

Additional Inherited Members
Protected Member Functions inherited from ns3::CallbackBase
	CallbackBase (Ptr< CallbackImplBase > impl)
Static Protected Member Functions inherited from ns3::CallbackBase
static std::string	Demangle (const std::string &mangled)
Protected Attributes inherited from ns3::CallbackBase
Ptr< CallbackImplBase >	m_impl

Detailed Description

template<typename R, typename T1 = empty, typename T2 = empty, typename T3 = empty, typename T4 = empty, typename T5 = empty, typename T6 = empty, typename T7 = empty, typename T8 = empty, typename T9 = empty>
class ns3::Callback< R, T1, T2, T3, T4, T5, T6, T7, T8, T9 >

Callback template class.

This class template implements the Functor Design Pattern. It is used to declare the type of a Callback:

• the first non-optional template argument represents the return type of the callback.
• the second optional template argument represents the type of the first argument to the callback.
• the third optional template argument represents the type of the second argument to the callback.
• the fourth optional template argument represents the type of the third argument to the callback.
• the fifth optional template argument represents the type of the fourth argument to the callback.
• the sixth optional template argument represents the type of the fifth argument to the callback.

Callback instances are built with the MakeCallback template functions. Callback instances have POD semantics: the memory they allocate is managed automatically, without user intervention which allows you to pass around Callback instances by value.

Sample code which shows how to use this class template as well as the function templates MakeCallback :

/* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
#include "ns3/callback.h"
#include "ns3/assert.h"
#include <iostream>

using namespace ns3;

static double 
CbOne (double a, double b)
{
  std::cout << "invoke cbOne a=" << a << ", b=" << b << std::endl;
  return a;
}

class MyCb {
public:
  int CbTwo (double a) {
    std::cout << "invoke cbTwo a=" << a << std::endl;
    return -5;
  }
};


int main (int argc, char *argv[])
{
  // return type: double
  // first arg type: double
  // second arg type: double
  Callback<double, double, double> one;
  // build callback instance which points to cbOne function
  one = MakeCallback (&CbOne);
  // this is not a null callback
  NS_ASSERT (!one.IsNull ());
  // invoke cbOne function through callback instance
  double retOne;
  retOne = one (10.0, 20.0);
  // callback returned expected value
  NS_ASSERT (retOne == 10.0);

  // return type: int
  // first arg type: double
  Callback<int, double> two;
  MyCb cb;
  // build callback instance which points to MyCb::cbTwo
  two = MakeCallback (&MyCb::CbTwo, &cb);
  // this is not a null callback
  NS_ASSERT (!two.IsNull ());
  // invoke MyCb::cbTwo through callback instance
  int retTwo;
  retTwo = two (10.0);
  // callback returned expected value
  NS_ASSERT (retTwo == -5);

  two = MakeNullCallback<int, double> ();
  // invoking a null callback is just like
  // invoking a null function pointer:
  // it will crash.
  //int retTwoNull = two (20.0);
  NS_ASSERT (two.IsNull ());

#if 0
  // The below type mismatch between CbOne() and callback two will fail to 
  // compile if enabled in this program.
  two = MakeCallback (&CbOne);
#endif

#if 0
  // This is a slightly different example, in which the code will compile
  // but because callbacks are type-safe, will cause a fatal error at runtime 
  // (the difference here is that Assign() is called instead of operator=)
  Callback<void, float> three;
  three.Assign (MakeCallback (&CbOne));
#endif

  return 0;
}

Definition at line 369 of file callback.h.

---

The documentation for this class was generated from the following file:

• src/core/model/callback.h