object-vector.h

Go to the documentation of this file.

/*
 * Copyright (c) 2007 INRIA, Mathieu Lacage
 *
 * SPDX-License-Identifier: GPL-2.0-only
 *
 * Authors: Mathieu Lacage <mathieu.lacage@gmail.com>
 */
#ifndef OBJECT_VECTOR_H
#define OBJECT_VECTOR_H
 
#include "attribute.h"
#include "object-ptr-container.h"
#include "object.h"
#include "ptr.h"
 
/**
 * @file
 * @ingroup attribute_ObjectVector
 * ns3::ObjectVectorValue attribute value declarations and template implementations.
 */
 
namespace ns3
{
 
/**
 * @ingroup attribute_ObjectVector
 * ObjectVectorValue is an alias for ObjectPtrContainerValue
 */
typedef ObjectPtrContainerValue ObjectVectorValue;
 
/**
 * @ingroup attribute_ObjectVector
 * MakeAccessorHelper implementation for ObjectVector.
 * @copydetails ns3::DoMakeAccessorHelperOne(U T::*)
 */
// clang-format off
// Clang-format guard needed for versions <= 18
template <typename T, typename U>
Ptr<const AttributeAccessor> MakeObjectVectorAccessor(U T::* memberVariable);
// clang-format on
 
// Documentation generated by print-introspected-doxygen.cc
template <typename T>
Ptr<const AttributeChecker> MakeObjectVectorChecker();
 
/**
 * @ingroup attribute_ObjectVector
 * @copydoc ns3::MakeObjectPtrContainerAccessor()
 */
template <typename T, typename U, typename INDEX>
Ptr<const AttributeAccessor> MakeObjectVectorAccessor(Ptr<U> (T::*get)(INDEX) const,
                                                      INDEX (T::*getN)() const);
 
/**
 * @ingroup attribute_ObjectVector
 * @copydoc ns3::MakeObjectPtrContainerAccessor()
 */
template <typename T, typename U, typename INDEX>
Ptr<const AttributeAccessor> MakeObjectVectorAccessor(INDEX (T::*getN)() const,
                                                      Ptr<U> (T::*get)(INDEX) const);
 
/***************************************************************
 *  Implementation of the templates declared above.
 ***************************************************************/
 
// clang-format off
// Clang-format guard needed for versions <= 18
template <typename T, typename U>
Ptr<const AttributeAccessor>
MakeObjectVectorAccessor(U T::* memberVector)
// clang-format on
{
    struct MemberStdContainer : public ObjectPtrContainerAccessor
    {
        bool DoGetN(const ObjectBase* object, std::size_t* n) const override
        {
            const T* obj = dynamic_cast<const T*>(object);
            if (obj == nullptr)
            {
                return false;
            }
            *n = (obj->*m_memberVector).size();
            return true;
        }
 
        Ptr<Object> DoGet(const ObjectBase* object,
                          std::size_t i,
                          std::size_t* index) const override
        {
            const T* obj = static_cast<const T*>(object);
            auto begin = (obj->*m_memberVector).begin();
            auto end = (obj->*m_memberVector).end();
            std::size_t k = 0;
            for (auto j = begin; j != end; j++, k++)
            {
                if (k == i)
                {
                    *index = k;
                    return *j;
                }
            }
            NS_ASSERT(false);
            // quiet compiler.
            return nullptr;
        }
 
        // clang-format off
        // Clang-format guard needed for versions <= 18
        U T::* m_memberVector;
        // clang-format on
    }* spec = new MemberStdContainer();
 
    spec->m_memberVector = memberVector;
    return Ptr<const AttributeAccessor>(spec, false);
}
 
template <typename T>
Ptr<const AttributeChecker>
MakeObjectVectorChecker()
{
    return MakeObjectPtrContainerChecker<T>();
}
 
template <typename T, typename U, typename INDEX>
Ptr<const AttributeAccessor>
MakeObjectVectorAccessor(Ptr<U> (T::*get)(INDEX) const, INDEX (T::*getN)() const)
{
    return MakeObjectPtrContainerAccessor<T, U, INDEX>(get, getN);
}
 
template <typename T, typename U, typename INDEX>
Ptr<const AttributeAccessor>
MakeObjectVectorAccessor(INDEX (T::*getN)() const, Ptr<U> (T::*get)(INDEX) const)
{
    return MakeObjectPtrContainerAccessor<T, U, INDEX>(get, getN);
}
 
} // namespace ns3
 
#endif /* OBJECT_VECTOR_H */