/**************************************************************************************** Copyright (C) 2015 Autodesk, Inc. All rights reserved. Use of this software is subject to the terms of the Autodesk license agreement provided at the time of installation or download, or which otherwise accompanies this software in either electronic or hard copy form. ****************************************************************************************/ //! \file fbxset.h #ifndef _FBXSDK_CORE_BASE_SET_H_ #define _FBXSDK_CORE_BASE_SET_H_ #include #include #include #include /** This class implements an efficient set based on value comparison, which stores values. * It executes insertion, deletion and query operations in O(log(n)) time. */ template , typename Allocator=FbxBaseAllocator> class FbxSet { protected: //! This class defines the value type used by the set. class Value { /***************************************************************************************************************************** ** WARNING! Anything beyond these lines is for internal use, may not be documented and is subject to change without notice! ** *****************************************************************************************************************************/ #ifndef DOXYGEN_SHOULD_SKIP_THIS public: typedef const Type KeyType; typedef const Type ConstKeyType; typedef const Type ValueType; typedef const Type ConstValueType; inline Value(const Type& pValue) : mValue(pValue){} inline KeyType& GetKey() const { return mValue; } inline ConstKeyType& GetKey(){ return mValue; } inline ValueType& GetValue() const { return mValue; } inline ConstValueType& GetValue(){ return mValue; } protected: ValueType mValue; private: Value& operator=(const Value&); #endif /* !DOXYGEN_SHOULD_SKIP_THIS *****************************************************************************************/ }; //! Declaration of the storage type used by the set. typedef FbxRedBlackTree StorageType; public: typedef Type ValueType; typedef typename StorageType::RecordType RecordType; typedef typename StorageType::IteratorType Iterator; typedef typename StorageType::ConstIteratorType ConstIterator; /** Preallocate memory. * \param pRecordCount The number of elements. */ inline void Reserve(unsigned int pRecordCount) { mTree.Reserve(pRecordCount); } //! Retrieve the number of values it holds. inline int GetSize() const { return mTree.GetSize(); } /** Insert a value. * \param pValue The value. * \return If the value is already present in the map, returns the existing value and false; else returns the pointer to the new value and true. */ inline FbxPair Insert(const ValueType& pValue) { return mTree.Insert(Value(pValue)); } /** Delete a value. * \param pValue The value. * \return \c true if success, \c false if value is not found. */ inline int Remove(const ValueType& pValue) { return mTree.Remove(pValue); } //! Clear the set. inline void Clear() { mTree.Clear(); } //! Query whether the set is empty. inline bool Empty() const { return mTree.Empty(); } //! Retrieve the begin iterator of the set. Iterator Begin() { return Iterator(Minimum()); } //! Retrieve the end iterator of the set. Iterator End() { return Iterator(); } //! Retrieve the begin iterator of the set. ConstIterator Begin() const { return ConstIterator(Minimum()); } //! Retrieve the end iterator of the set. ConstIterator End() const { return ConstIterator(); } /** Find a given value in the set. * \param pValue The value to find. * \return The value in the set, or NULL if the value is not found in the set. */ inline const RecordType* Find(const ValueType& pValue) const { return mTree.Find(pValue); } /** Find a given value in the set. * \param pValue The value to find. * \return The value in the set, or NULL if the value is not found in the set. */ inline RecordType* Find(const ValueType& pValue) { return mTree.Find(pValue); } //! Retrieve the minimum value in the set. inline const RecordType* Minimum() const { return mTree.Minimum(); } //! Retrieve the minimum value in the set. inline RecordType* Minimum() { return mTree.Minimum(); } //! Retrieve the maximum value in the set. inline const RecordType* Maximum() const { return mTree.Maximum(); } //! Retrieve the maximum value in the set. inline RecordType* Maximum() { return mTree.Maximum(); } //! Equality operator. inline bool operator==(const FbxSet& pOther) const { return (this == &pOther) || (mTree == pOther.mTree); } //! Inequality operator. inline bool operator != (const FbxSet& pOther) const { return !(*this == pOther); } /** Intersect with another set. * \param pOther The other set. * \return The intersection set of the two sets. */ inline FbxSet Intersect(const FbxSet& pOther) const { FbxSet lReturn; ConstIterator lBegin = Begin(); for (; lBegin != End(); ++lBegin) { if (pOther.Find(lBegin->GetValue()) != NULL) lReturn.Insert(lBegin->GetValue()); } return lReturn; } /** Unite with another set. * \param pOther The other set. * \return The union set of the two sets (no duplicated items). */ inline FbxSet Union(const FbxSet& pOther) const { FbxSet lReturn(*this); ConstIterator lBegin = pOther.Begin(); for (; lBegin != End(); ++lBegin) { if (Find(lBegin->GetValue()) == NULL) lReturn.Insert(lBegin->GetValue()); } return lReturn; } /***************************************************************************************************************************** ** WARNING! Anything beyond these lines is for internal use, may not be documented and is subject to change without notice! ** *****************************************************************************************************************************/ #ifndef DOXYGEN_SHOULD_SKIP_THIS inline FbxSet(){} inline FbxSet(const FbxSet& pSet) : mTree(pSet.mTree){} inline ~FbxSet(){ Clear(); } private: StorageType mTree; #endif /* !DOXYGEN_SHOULD_SKIP_THIS *****************************************************************************************/ }; #include #endif /* _FBXSDK_CORE_BASE_SET_H_ */