Planet
navi homePPSaboutscreenshotsdownloaddevelopmentforum

source: code/trunk/src/orxonox/pickup/PickupIdentifier.cc @ 6692

Last change on this file since 6692 was 6540, checked in by dafrick, 15 years ago

Removed some TODO's. Finished up documenting pickup module.

File size: 4.6 KB
Line 
1/*
2 *   ORXONOX - the hottest 3D action shooter ever to exist
3 *                    > www.orxonox.net <
4 *
5 *
6 *   License notice:
7 *
8 *   This program is free software; you can redistribute it and/or
9 *   modify it under the terms of the GNU General Public License
10 *   as published by the Free Software Foundation; either version 2
11 *   of the License, or (at your option) any later version.
12 *
13 *   This program is distributed in the hope that it will be useful,
14 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
15 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16 *   GNU General Public License for more details.
17 *
18 *   You should have received a copy of the GNU General Public License
19 *   along with this program; if not, write to the Free Software
20 *   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
21 *
22 *   Author:
23 *      Damian 'Mozork' Frick
24 *   Co-authors:
25 *      ...
26 *
27 */
28
29/**
30    @file PickupIdentifier.cc
31    @brief Implementation of the PickupIdentifier class.
32*/
33
34#include "PickupIdentifier.h"
35
36#include "core/CoreIncludes.h"
37#include "interfaces/Pickupable.h"
38
39namespace orxonox
40{
41   
42    /**
43    @brief
44        Constructor. Registers the object and initializes member variables.
45    */
46    PickupIdentifier::PickupIdentifier(Pickupable* pickup)
47    {
48        RegisterRootObject(PickupIdentifier);
49       
50        this->pickup_ = pickup;
51    }
52   
53    PickupIdentifier::~PickupIdentifier()
54    {
55       
56    }
57   
58    /**
59    @brief
60        Compares two PickupIdentifiers and returns 0 if a == b, <0 if a < b and >0 if a > b for a.compare(b).
61    @param identifier
62        Pointer to the second PickupIdentifier, b.
63    @return
64        Returns an integer. 0 if the two compared PickupIdentifiers are the same, <0 if a < b and >0 if a > b.
65    */
66    int PickupIdentifier::compare(const PickupIdentifier* identifier) const
67    {
68        //! If the classIdentifiers are not the same (meaning the PickupIdentifiers identify different classes), the obviously the two Pickupables identified by the PickupIdentifiers cannot be the same. An ordering is established through the alphabetical ordering of the respective classnames.
69        if(!identifier->pickup_->getIdentifier()->isExactlyA(this->pickup_->getIdentifier()))
70            return this->pickup_->getIdentifier()->getName().compare(identifier->pickup_->getIdentifier()->getName());
71       
72        //! If the class is the same for both PickupIdentifiers we go on to check the parameters of the class.
73        //! If the two have a different number of parameters then obviusly something is very wrong.
74        if(!(this->parameters_.size() == identifier->parameters_.size()))
75        {
76            COUT(1) << "Something went wrong in PickupIdentifier!" << std::endl;
77            return this->parameters_.size()-identifier->parameters_.size();
78        }
79       
80        //! We iterate through all parameters and compar their values (which are strings). The first parameter is the most significant. The ordering is once again established by the alphabetical comparison of the two value strings.
81        for(std::map<std::string, std::string>::const_iterator it = this->parameters_.begin(); it != this->parameters_.end(); it++)
82        {
83            //!< If a parameter present in one of the identifiers is not found in the other, once again, something is very wrong.
84            if(identifier->parameters_.find(it->first) == identifier->parameters_.end())
85            {
86                COUT(1) << "Something went wrong in PickupIdentifier!" << std::endl;
87                return -1;
88            }
89            if(identifier->parameters_.find(it->first)->second != it->second)
90                return it->second.compare(identifier->parameters_.find(it->first)->second);
91        }
92           
93        return false;
94    }
95   
96    /**
97    @brief
98        Add a parameter to the PickupIdentifier.
99    @param name
100        The name of the parameter.
101    @param value
102        The value of the parameter.
103    @return
104        Returns false if the parameter already existed, true if not.
105    */
106    bool PickupIdentifier::addParameter(std::string & name, std::string & value)
107    {
108        COUT(4) << "PickupIdentifier " << name << ", " << value << std::endl;
109       
110        if(!(this->parameters_.find(name) == this->parameters_.end()))
111        {
112            COUT(4) << "Request for adding a parameter that already exists for the PickupIdentififer was denied. name: '" << name << "', value: '" << value << "'."<<  std::endl;
113            return false;
114        }
115       
116        this->parameters_[name] = value;
117       
118        return true;
119    }
120   
121}
Note: See TracBrowser for help on using the repository browser.