--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/src/common/array-trace-resolver.h Sun Mar 18 14:06:51 2007 -0700
@@ -0,0 +1,138 @@
+/* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
+/*
+ * Copyright (c) 2007 INRIA
+ * All rights reserved.
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License version 2 as
+ * published by the Free Software Foundation;
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+ *
+ * Author: Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
+ */
+#ifndef ARRAY_TRACE_RESOLVER_H
+#define ARRAY_TRACE_RESOLVER_H
+
+#include <stdint.h>
+#include <string>
+#include "ns3/callback.h"
+#include "trace-resolver.h"
+
+namespace ns3 {
+
+/**
+ * \brief a helper class to offer trace resolution for an array of objects.
+ * \ingroup tracing
+ */
+template <typename T>
+class ArrayTraceResolver : public TraceResolver
+{
+public:
+ /**
+ * \brief array index trace context
+ *
+ * During namespace parsing, ns3::ArrayTraceResolver will
+ * embed an instance of this class in the TraceContext
+ * associated to every child object of the object stored
+ * at the index.
+ *
+ * The reason why this class exists is to ensure that we
+ * need to ensure that we can store a unique type as context
+ * into the TraceContext associated to this trace resolver.
+ */
+ class Index
+ {
+ public:
+ Index ();
+ Index (uint32_t index);
+ /**
+ * The Index is automatically convertible to the
+ * uin32_t type such that it really behaves like a uint32_t
+ * array index for the user.
+ *
+ * \returns the index itself
+ */
+ operator uint32_t ();
+ private:
+ uint32_t m_index;
+ };
+ /**
+ * \param context trace context associated to this trace resolver
+ * \param getSize callback which returns dynamically the size of underlying array
+ * \param get callback which returns any element in the underlying array
+ *
+ * Construct a trace resolver which can match any input integer
+ * against an element in an array. The array is accessed using a
+ * pair of callbacks. It is the responsability of the user to
+ * provide two such callbacks whose job is to adapt the array
+ * API to the resolver needs. Each element of the array is expected
+ * to provide a method named CreateTraceResolver which takes as
+ * only argument a reference to a const TraceContext and returns
+ * a pointer to a TraceResolver. i.e. the signature is:
+ * TraceResolver * (*) (TraceContext const &)
+ */
+ ArrayTraceResolver (TraceContext const &context,
+ Callback<uint32_t> getSize,
+ Callback<T *, uint32_t> get);
+private:
+ virtual TraceResolverList DoLookup (std::string id) const;
+ Callback<uint32_t> m_getSize;
+ Callback<T *, uint32_t> m_get;
+};
+
+}//namespace ns3
+
+namespace ns3 {
+
+template <typename T>
+ArrayTraceResolver<T>::Index::Index ()
+ : m_index ()
+{}
+template <typename T>
+ArrayTraceResolver<T>::Index::Index (uint32_t index)
+ : m_index (index)
+{}
+template <typename T>
+ArrayTraceResolver<T>::Index::operator uint32_t ()
+{
+ return m_index;
+}
+
+template <typename T>
+ArrayTraceResolver<T>::ArrayTraceResolver (TraceContext const &context,
+ Callback<uint32_t> getSize,
+ Callback<T *, uint32_t> get)
+ : TraceResolver (context),
+ m_getSize (getSize),
+ m_get (get)
+{}
+template <typename T>
+TraceResolver::TraceResolverList
+ArrayTraceResolver<T>::DoLookup (std::string id) const
+{
+ TraceResolverList list;
+ if (id == "*")
+ {
+ for (uint32_t i = 0; i < m_getSize (); i++)
+ {
+ TraceContext context = GetContext ();
+ typename ArrayTraceResolver<T>::Index index = typename ArrayTraceResolver<T>::Index (i);
+ context.Add (index);
+ list.push_back (m_get (i)->CreateTraceResolver (context));
+ }
+ }
+ return list;
+}
+
+
+}//namespace ns3
+
+#endif /* ARRAY_TRACE_RESOLVER_H */