A Discrete-Event Network Simulator
API
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
ns3::AttributeChecker Class Referenceabstract

Represent the type of an attribute. More...

#include <attribute.h>

+ Inheritance diagram for ns3::AttributeChecker:
+ Collaboration diagram for ns3::AttributeChecker:

Public Member Functions

 AttributeChecker ()
 
virtual ~AttributeChecker ()
 
virtual bool Check (const AttributeValue &value) const =0
 
virtual bool Copy (const AttributeValue &source, AttributeValue &destination) const =0
 Copy the source to the destination. More...
 
virtual Ptr< AttributeValueCreate (void) const =0
 
Ptr< AttributeValueCreateValidValue (const AttributeValue &value) const
 Create a valid value from the argument value, or reinterpret the argument as a string. More...
 
virtual std::string GetUnderlyingTypeInformation (void) const =0
 
virtual std::string GetValueTypeName (void) const =0
 
virtual bool HasUnderlyingTypeInformation (void) const =0
 
- Public Member Functions inherited from ns3::SimpleRefCount< AttributeChecker >
 SimpleRefCount ()
 Constructor. More...
 
 SimpleRefCount (const SimpleRefCount &o)
 Copy constructor. More...
 
uint32_t GetReferenceCount (void) const
 Get the reference count of the object. More...
 
SimpleRefCountoperator= (const SimpleRefCount &o)
 Assignment. More...
 
void Ref (void) const
 Increment the reference count. More...
 
void Unref (void) const
 Decrement the reference count. More...
 

Additional Inherited Members

- Static Public Member Functions inherited from ns3::SimpleRefCount< AttributeChecker >
static void Cleanup (void)
 Noop. More...
 

Detailed Description

Represent the type of an attribute.

Each type of attribute has an associated unique AttributeChecker subclass. The type of the subclass can be safely used by users to infer the type of the associated attribute. i.e., we expect binding authors to use the checker associated to an attribute to detect the type of the associated attribute.

Most subclasses of this base class are implemented by the ATTRIBUTE_HELPER_HEADER and ATTRIBUTE_HELPER_CPP macros.

Definition at line 154 of file attribute.h.

Constructor & Destructor Documentation

ns3::AttributeChecker::AttributeChecker ( )

Definition at line 45 of file attribute.cc.

ns3::AttributeChecker::~AttributeChecker ( )
virtual

Definition at line 48 of file attribute.cc.

Member Function Documentation

virtual bool ns3::AttributeChecker::Check ( const AttributeValue value) const
pure virtual
Parameters
valuea pointer to the value to check
Returns
true if the input value is both of the right type and if its value is within the requested range. Returns false otherwise.

Implemented in ns3::internal::AnObjectPtrContainerChecker< T >, ns3::internal::APointerChecker< T >, and ns3::EnumChecker.

Referenced by CreateValidValue().

+ Here is the caller graph for this function:

virtual bool ns3::AttributeChecker::Copy ( const AttributeValue source,
AttributeValue destination 
) const
pure virtual

Copy the source to the destination.

Parameters
sourcesource AttributeValue
destinationdestination AttributeValue
Returns
true if copy was successful

Implemented in ns3::internal::AnObjectPtrContainerChecker< T >, ns3::internal::APointerChecker< T >, and ns3::EnumChecker.

virtual Ptr<AttributeValue> ns3::AttributeChecker::Create ( void  ) const
pure virtual
Returns
a new instance of an AttributeValue (wrapper in an Attribute instance) which matches the type of the underlying attribute.

This method is typically used to create a temporary variable prior to calling Attribute::DeserializeFromString.

Implemented in ns3::internal::AnObjectPtrContainerChecker< T >, ns3::internal::APointerChecker< T >, and ns3::EnumChecker.

Referenced by CreateValidValue().

+ Here is the caller graph for this function:

Ptr< AttributeValue > ns3::AttributeChecker::CreateValidValue ( const AttributeValue value) const

Create a valid value from the argument value, or reinterpret the argument as a string.

Parameters
valuethe AttributeValue to check
Returns
Ptr to a valid value

Definition at line 53 of file attribute.cc.

References Check(), ns3::AttributeValue::Copy(), Create(), ns3::StringValue::Get(), and NS_LOG_FUNCTION.

+ Here is the call graph for this function:

virtual std::string ns3::AttributeChecker::GetUnderlyingTypeInformation ( void  ) const
pure virtual
Returns
a human-readable representation of information about the underlying C++ type.

Implemented in ns3::internal::AnObjectPtrContainerChecker< T >, ns3::internal::APointerChecker< T >, and ns3::EnumChecker.

Referenced by ns3::cell_tooltip_callback(), and ns3::cell_tooltip_callback_config_default().

+ Here is the caller graph for this function:

virtual std::string ns3::AttributeChecker::GetValueTypeName ( void  ) const
pure virtual
Returns
the c++ fully-qualified typename of the subclass of the ns3::AttributeValue base class which is associated to this checker.

A typical return value here is FooValue where Foo is the name of the type being wrapped.

Implemented in ns3::internal::AnObjectPtrContainerChecker< T >, ns3::internal::APointerChecker< T >, and ns3::EnumChecker.

Referenced by ns3::cell_tooltip_callback(), and ns3::cell_tooltip_callback_config_default().

+ Here is the caller graph for this function:

virtual bool ns3::AttributeChecker::HasUnderlyingTypeInformation ( void  ) const
pure virtual
Returns
true if this checker has information about the underlying C++ type, false otherwise.

If this method returns false, the return value of the GetUnderlyingTypeInformation method cannot be relied upon.

Implemented in ns3::internal::AnObjectPtrContainerChecker< T >, ns3::internal::APointerChecker< T >, and ns3::EnumChecker.

Referenced by ns3::cell_tooltip_callback(), and ns3::cell_tooltip_callback_config_default().

+ Here is the caller graph for this function:


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