/****************************************************************************** * Icinga 2 * * Copyright (C) 2012 Icinga Development Team (http://www.icinga.org/) * * * * This program is free software; you can redistribute it and/or * * modify it under the terms of the GNU General Public License * * as published by the Free Software Foundation; either version 2 * * of the License, or (at your option) any later version. * * * * 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., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA. * ******************************************************************************/ #ifndef DICTIONARY_H #define DICTIONARY_H #include "base/i2-base.h" #include "base/object.h" #include "base/value.h" #include namespace icinga { /** * A container that holds key-value pairs. * * @ingroup base */ class I2_BASE_API Dictionary : public Object { public: typedef shared_ptr Ptr; typedef weak_ptr WeakPtr; /** * An iterator that can be used to iterate over dictionary elements. */ typedef std::map::iterator Iterator; Dictionary(void); Value Get(const char *key) const; Value Get(const String& key) const; void Set(const String& key, const Value& value); bool Contains(const String& key) const; void Seal(void); bool IsSealed(void) const; Iterator Begin(void); Iterator End(void); size_t GetLength(void) const; void Remove(const String& key); void Remove(Iterator it); Dictionary::Ptr ShallowClone(void) const; static Dictionary::Ptr FromJson(cJSON *json); cJSON *ToJson(void) const; private: std::map m_Data; /**< The data for the dictionary. */ bool m_Sealed; /**< Whether the dictionary is read-only. */ }; inline Dictionary::Iterator range_begin(Dictionary::Ptr x) { return x->Begin(); } inline Dictionary::Iterator range_end(Dictionary::Ptr x) { return x->End(); } } namespace boost { template<> struct range_mutable_iterator { typedef icinga::Dictionary::Iterator type; }; template<> struct range_const_iterator { typedef icinga::Dictionary::Iterator type; }; } #endif /* DICTIONARY_H */