A Discrete-Event Network Simulator
API
Loading...
Searching...
No Matches
ns3::PointerValue Class Reference

Hold objects of type Ptr<T>. More...

#include "pointer.h"

+ Inheritance diagram for ns3::PointerValue:
+ Collaboration diagram for ns3::PointerValue:

Public Member Functions

 PointerValue ()
 
template<typename T >
 PointerValue (const Ptr< T > &object)
 Construct this PointerValue by referencing an explicit Object.
 
 PointerValue (Ptr< Object > object)
 Construct this PointerValue by referencing an explicit Object.
 
Ptr< AttributeValueCopy () const override
 
bool DeserializeFromString (std::string value, Ptr< const AttributeChecker > checker) override
 
template<typename T >
Ptr< T > Get () const
 
template<typename T >
bool GetAccessor (Ptr< T > &value) const
 Access the Pointer value as type T.
 
Ptr< ObjectGetObject () const
 Get the Object referenced by the PointerValue.
 
template<typename T >
 operator Ptr< T > () const
 Cast to an Object of type T.
 
std::string SerializeToString (Ptr< const AttributeChecker > checker) const override
 
template<typename T >
void Set (const Ptr< T > &value)
 Set the value.
 
void SetObject (Ptr< Object > object)
 Set the value from by reference an Object.
 
- Public Member Functions inherited from ns3::AttributeValue
 AttributeValue ()
 
virtual ~AttributeValue ()
 
virtual Ptr< AttributeValueCopy () const =0
 
virtual bool DeserializeFromString (std::string value, Ptr< const AttributeChecker > checker)=0
 
virtual std::string SerializeToString (Ptr< const AttributeChecker > checker) const =0
 
- Public Member Functions inherited from ns3::SimpleRefCount< AttributeValue >
 SimpleRefCount ()
 Default constructor.
 
 SimpleRefCount (const SimpleRefCount &o)
 Copy constructor.
 
uint32_t GetReferenceCount () const
 Get the reference count of the object.
 
SimpleRefCountoperator= (const SimpleRefCount &o)
 Assignment operator.
 
void Ref () const
 Increment the reference count.
 
void Unref () const
 Decrement the reference count.
 

Private Attributes

Ptr< Objectm_value
 The stored Pointer instance.
 

Detailed Description

Hold objects of type Ptr<T>.

AttributeValue implementation for Pointer.

See also
AttributeValue

Definition at line 36 of file pointer.h.

Constructor & Destructor Documentation

◆ PointerValue() [1/3]

ns3::PointerValue::PointerValue ( )

Definition at line 37 of file pointer.cc.

References NS_LOG_FUNCTION.

◆ PointerValue() [2/3]

ns3::PointerValue::PointerValue ( Ptr< Object object)

Construct this PointerValue by referencing an explicit Object.

Parameters
[in]objectThe object to begin with.

Definition at line 43 of file pointer.cc.

References NS_LOG_FUNCTION.

◆ PointerValue() [3/3]

template<typename T >
ns3::PointerValue::PointerValue ( const Ptr< T > &  object)

Construct this PointerValue by referencing an explicit Object.

Template Parameters
T[deduced] The type of the object.
Parameters
[in]objectThe object to begin with.

Definition at line 188 of file pointer.h.

References m_value.

Member Function Documentation

◆ Copy()

Ptr< AttributeValue > ns3::PointerValue::Copy ( ) const
overridevirtual
Returns
a deep copy of this class, wrapped into an Attribute object.

Implements ns3::AttributeValue.

Definition at line 64 of file pointer.cc.

References NS_LOG_FUNCTION.

◆ DeserializeFromString()

bool ns3::PointerValue::DeserializeFromString ( std::string  value,
Ptr< const AttributeChecker checker 
)
overridevirtual
Parameters
[in]valueA string representation of the value
[in]checkerA pointer to the checker associated to the attribute.
Returns
true if the input string was correctly-formatted and could be successfully deserialized, false otherwise.

Upon return of this function, this AttributeValue instance contains the deserialized value. In most cases, this method will not make any use of the checker argument. However, in a very limited set of cases, the checker argument is needed to perform proper serialization. A nice example of code which needs it is the EnumValue::SerializeToString code.

Implements ns3::AttributeValue.

Definition at line 80 of file pointer.cc.

References ns3::ObjectFactory::Create(), m_value, and NS_LOG_FUNCTION.

+ Here is the call graph for this function:

◆ Get()

◆ GetAccessor()

template<typename T >
bool ns3::PointerValue::GetAccessor ( Ptr< T > &  value) const

Access the Pointer value as type T.

Template Parameters
T[explicit] The type to cast to.
Parameters
[out]valueThe Pointer value, as type T.
Returns
true.

Definition at line 216 of file pointer.h.

References m_value, and ns3::PeekPointer().

+ Here is the call graph for this function:

◆ GetObject()

◆ operator Ptr< T >()

template<typename T >
ns3::PointerValue::operator Ptr< T >

Cast to an Object of type T.

Template Parameters
T[explicit] The type to cast to.

Definition at line 209 of file pointer.h.

◆ SerializeToString()

std::string ns3::PointerValue::SerializeToString ( Ptr< const AttributeChecker checker) const
overridevirtual
Parameters
[in]checkerThe checker associated to the attribute
Returns
A string representation of this value.

In most cases, this method will not make any use of the checker argument. However, in a very limited set of cases, the checker argument is needed to perform proper serialization. A nice example of code which needs it is the EnumValue::SerializeToString code.

Implements ns3::AttributeValue.

Definition at line 71 of file pointer.cc.

References m_value, and NS_LOG_FUNCTION.

◆ Set()

template<typename T >
void ns3::PointerValue::Set ( const Ptr< T > &  value)

Set the value.

Parameters
[in]valueThe value to adopt.

Definition at line 195 of file pointer.h.

References m_value.

◆ SetObject()

void ns3::PointerValue::SetObject ( Ptr< Object object)

Set the value from by reference an Object.

Parameters
[in]objectThe object to reference.

Definition at line 50 of file pointer.cc.

References m_value, and NS_LOG_FUNCTION.

Member Data Documentation

◆ m_value

Pointer ns3::PointerValue::m_value
private

The stored Pointer instance.

Definition at line 93 of file pointer.h.

Referenced by PointerValue(), DeserializeFromString(), Get(), GetAccessor(), GetObject(), SerializeToString(), Set(), and SetObject().


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