Changeset 9724 in orxonox.OLD for branches/new_class_id/src/lib/lang/object_list.h

Timestamp:

Sep 8, 2006, 12:20:55 PM (18 years ago)

Author:

bensch

Message:

many many documentations and one new functiopm

File:

• branches/new_class_id/src/lib/lang/object_list.h (modified) (8 diffs)

branches/new_class_id/src/lib/lang/object_list.h

@@ -28 +28 @@
    static ObjectList<ClassName> _objectList
 
+/**
+ * @brief Use this macro to easily define a Class to store its own ObjectListDefinition
+ * @param ClassName: the Name of the Class.
+ * @param ID: optional set a Fixed ID.
+ */
 #define ObjectListDefinitionID(ClassName, ID) \
    ObjectList<ClassName> ClassName::_objectList(#ClassName, ID)
 
-
+/**
+ * @brief Use this macro to easily define a Class to store its own ObjectListDefinition
+ * @param ClassName: the Name of the Class.
+ */
 #define ObjectListDefinition(ClassName) \
     ObjectListDefinitionID(ClassName, -1)
@@ -43 +51 @@
 {
 public:
-  //! A fast iterator Base-Class, for iterator-casting and storing.
-  /**
-   * @note This Iterator is explicitely used only for storage purposes in the BaseObject
-   */
-  class IteratorBase { };
-
   /** @brief A Typedefinition for the Base-List that can be retrieved with getBaseObjectList(base_list*) */
   typedef std::list<BaseObject*>        base_list;
   /** @brief An iterator for the base_list */
   typedef base_list::iterator           base_iterator;
+  //! A fast iterator Base-Class, for iterator-casting and storing.
+  /** @note This Iterator is explicitely used only for storage purposes in the BaseObject */
+  class IteratorBase { };
 
 public:
   /** @returns The Identity of the Class stored within. */
-  inline const ClassID&              identity() const { return _identity; }
+  inline const ClassID&                 identity() const { return _identity; }
   /** @returns the ID of the Identity of the ObjectList */
   inline int                            id() const { return _id; };
@@ -67 +72 @@
   /** @param name The name to compare @returns true on match, false otherwise */
   inline bool                           operator==(const std::string& name) const { return _name == name; };
-  /** @param id The id to check @returns true on match, false otherwise */
+  /** @param id The id to acquire @param name the Name to acquire @brief stores a Name and an ID in a pointer. */
   inline void                           acquireID(const int*& id, const std::string*& name) const { id = &_id; name = &_name; };
   /** @brief fills a list of Objects into a BaseObject*-List. @param list the list to fill */
@@ -104 +109 @@
 
 private:
-  ObjectListBase(const ObjectListBase&);
+  /** @brief hidden copy constructor. */
+  ObjectListBase(const ObjectListBase&) {};
 
   static bool                         classIDExists(int id);
@@ -153 +159 @@
  *   and not loaded before the ObjectList.
  *
- * @example Iterating: Iteration is made easy, and fast as follows:
+ * example: Iterating: Iteration is made easy, and fast as follows:
  *   for (ObjectList<PlayerStats>::const_iterator it = PlayerStats::objectList().begin();
  *      it != PlayerStats::objectList().end();
@@ -161 +167 @@
  *   }
  *
- * @example Find an Object:
+ * example: Find an Object:
  * Playable* playable = Playable::objectList("orxonox-super-rocket-fighter"); // searches an Object By its name.
  *
@@ -192 +198 @@
   virtual BaseObject*                getBaseObject(const std::string& name) const;
   T*                                 getObject(const std::string& name) const;
+  /** @returns A constant list of Objects of this Class. */
   inline const list&                 objects() const { return _objects; };
   bool                               exists(const T* const object) const;
@@ -314 +321 @@
 /**
  * @brief registers an Object to the ObjectList.
- * @param T object the Object to register.
+ * @param object The Object to register.
  * @returns a pointer to the iterator inside of the list.
  */