// ==========================================================================
//                 SeqAn - The Library for Sequence Analysis
// ==========================================================================
// Copyright (c) 2006-2024, Knut Reinert, FU Berlin
// All rights reserved.
//
// Redistribution and use in source and binary forms, with or without
// modification, are permitted provided that the following conditions are met:
//
//     * Redistributions of source code must retain the above copyright
//       notice, this list of conditions and the following disclaimer.
//     * Redistributions in binary form must reproduce the above copyright
//       notice, this list of conditions and the following disclaimer in the
//       documentation and/or other materials provided with the distribution.
//     * Neither the name of Knut Reinert or the FU Berlin nor the names of
//       its contributors may be used to endorse or promote products derived
//       from this software without specific prior written permission.
//
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
// ARE DISCLAIMED. IN NO EVENT SHALL KNUT REINERT OR THE FU BERLIN BE LIABLE
// FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
// DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
// SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
// CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
// LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
// OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
// DAMAGE.
//
// ==========================================================================

// TODO(holtgrew): Move to misc?

#ifndef SEQAN_HEADER_GRAPH_IDMANAGER_H
#define SEQAN_HEADER_GRAPH_IDMANAGER_H

namespace seqan2
{
//////////////////////////////////////////////////////////////////////////////
// IdManager
//////////////////////////////////////////////////////////////////////////////

/*!
 * @class IdManager
 * @headerfile <seqan/graph_types.h>
 * @brief ID manager that provides uniq ids for vertices and edges.
 *
 * @signature template <typename TIdType, typename TSpec>
 *            class IdManager;
 *
 * @tparam TIdType The type to use for storing IDs.  Use the Value metafunctio to get the id type managed by
 *                 a given IdManager.
 * @tparam TSpec   Specializing type.
 */

template <typename TIdType, typename TSpec>
class IdManager
{
    public:
        String<TIdType> data_freeIds;
        String<bool> data_in_use;   //1 = in use, 0 = not in use

//____________________________________________________________________________
    public:
        IdManager()
        {
            clear(data_in_use);
            clear(data_freeIds);
        }

        ~IdManager()
        {
        }

        IdManager(IdManager const & _other)
        {
            data_freeIds = _other.data_freeIds;
            data_in_use = _other.data_in_use;
        }

        IdManager const&
        operator = (IdManager const& _other)
        {
            if (this == &_other) return *this;
            data_freeIds = _other.data_freeIds;
            data_in_use = _other.data_in_use;
            return *this;
        }

//____________________________________________________________________________
};


//////////////////////////////////////////////////////////////////////////////
// IdManager - Metafunctions
//////////////////////////////////////////////////////////////////////////////

//////////////////////////////////////////////////////////////////////////////

/*!
 * @mfn IdManager#Value
 * @brief Return the value type of an IdManager.
 *
 * @signature Value<TIdManager>::Type;
 */

template<typename TIdType, typename TSpec>
struct Value<IdManager<TIdType, TSpec> >
{
    typedef TIdType Type;
};

template<typename TIdType, typename TSpec>
struct Value<IdManager<TIdType, TSpec> const>
{
    typedef TIdType Type;
};

//////////////////////////////////////////////////////////////////////////////

/*!
 * @mfn IdManager#Spec
 * @brief Return the specializing type of an IdManager.
 *
 * @signature Spec<TIdManager>::Type;
 */

template<typename TIdType, typename TSpec>
struct Spec<IdManager<TIdType, TSpec> >
{
    typedef TSpec Type;
};

template<typename TIdType, typename TSpec>
struct Spec<IdManager<TIdType, TSpec> const>
{
    typedef TSpec Type;
};

//////////////////////////////////////////////////////////////////////////////
// FUNCTIONS
//////////////////////////////////////////////////////////////////////////////

//////////////////////////////////////////////////////////////////////////////

/*!
 * @fn IdManager#obatinId
 * @brief Obatains a new id from the id manager.
 *
 * @signature TId obtainId(manager);
 *
 * @param[in,out] manager IdManager to get ids from.
 *
 * @return TId A new unique id.
 */

template<typename TIdType, typename TSpec>
inline typename Value<IdManager<TIdType, TSpec> >::Type
obtainId(IdManager<TIdType, TSpec>& idm)
{

    TIdType _id;
    if (!empty(idm.data_freeIds)) {
        _id = getValue(idm.data_freeIds, length(idm.data_freeIds) - 1);
        resize(idm.data_freeIds, length(idm.data_freeIds) - 1, Generous());
        assignValue(idm.data_in_use, _id, true);
    } else {
        if (empty(idm.data_in_use)) _id = 0;
        else _id = (TIdType) length(idm.data_in_use);
        resize(idm.data_in_use, _id + 1, Generous());
        assignValue(idm.data_in_use, _id, true);
    }
    return _id;
}

//////////////////////////////////////////////////////////////////////////////

/*!
 * @fn IdManager#releaseId
 * @brief Releases a given id so it can be reused later on.
 *
 * @signature void releaseId(manager, id);
 *
 * @param[in,out] manager The IdManager to use.
 * @param[in]     id      The ID to release.
 */

template<typename TIdType, typename TSpec, typename TId>
inline void
releaseId(IdManager<TIdType, TSpec>& idm,
          TId const id)
{
    SEQAN_ASSERT(idInUse(idm,id));
    if (id == (TId) length(idm.data_in_use) - 1) {
        resize(idm.data_in_use, length(idm.data_in_use) - 1, Generous());
    } else {
        assignValue(idm.data_in_use, id, false);
        appendValue(idm.data_freeIds, id, Generous());
    }
    if (idCount(idm)==0) {
        releaseAll(idm);
    }
}


//////////////////////////////////////////////////////////////////////////////

/*!
 * @fn IdManager#releaseAll
 * @brief Releases all ids handled by this IdManager.
 *
 * @signature void releaseAll(manager);
 *
 * @param[in,out] manager The IdManager to release the ids from.
 */


template<typename TIdType, typename TSpec>
inline void
releaseAll(IdManager<TIdType, TSpec>& idm)
{
    clear(idm.data_freeIds);
    clear(idm.data_in_use);
}

//////////////////////////////////////////////////////////////////////////////

/*!
 * @fn IdManager#getIdUpperBound
 * @brief Returns the largest distributed id plus 1.
 *
 * @signature TId getIdUpperBound(manager);
 *
 * @param[in] manager The IdManager to query.
 *
 * @return TId The return value is guaranteed to be an upper bound on all distributed ids.
 */

template<typename TIdType, typename TSpec>
inline typename Value<IdManager<TIdType, TSpec> >::Type
getIdUpperBound(IdManager<TIdType, TSpec> const& idm)
{
    return (empty(idm.data_in_use)) ? 0 : (typename Value<IdManager<TIdType, TSpec> >::Type) length(idm.data_in_use);
}

//////////////////////////////////////////////////////////////////////////////

/*!
 * @fn IdManager#getIdLowerBound
 * @brief Returns the smalles distributed id.
 *
 * @signature TId getIdLowerBound(manager);
 *
 * @param[in] manager The IdManager to query.
 *
 * @return TId The smallest obtained id so far.
 */

template<typename TIdType, typename TSpec>
inline typename Value<IdManager<TIdType, TSpec> >::Type
getIdLowerBound(IdManager<TIdType, TSpec> const& idm)
{
    for(TIdType it = 0; it < length(idm.data_in_use); ++it) {
        if (getValue(idm.data_in_use, it)) return it;
    }
    return 0;
}


//////////////////////////////////////////////////////////////////////////////

/*!
 * @fn IdManager#idCount
 * @brief Return the number of obtained ids.
 *
 * @signature TId idCount(manager);
 *
 * @param[in] manager The IdManager to query.
 *
 * @return TId The number of ids obtained so far.
 */

template<typename TIdType, typename TSpec>
inline typename Value<IdManager<TIdType, TSpec> >::Type
idCount(IdManager<TIdType, TSpec> const& idm)
{
    return (length(idm.data_in_use) - length(idm.data_freeIds));
}


//////////////////////////////////////////////////////////////////////////////

/*!
 * @fn IdManager#idInUse
 * @brief Return whether an id is in use.
 *
 * @signature bool idInUse(manager, id);
 *
 * @param[in] manager The IdManager to query.
 * @param[in] id      The id to check for.
 *
 * @return bool true if the id is already in use and false otherwise.
 */

template<typename TIdType, typename TSpec, typename TId>
inline bool
idInUse(IdManager<TIdType, TSpec> const& idm,
        TId const id)
{
    return (id < static_cast<TId>(length(idm.data_in_use))) ? idm.data_in_use[id] : false;
}


//////////////////////////////////////////////////////////////////////////////
// Dummy IdManager
//////////////////////////////////////////////////////////////////////////////

/*!
 * @class CountingIdManager
 * @extends IdManager
 * @headerfile <seqan/graph_types.h>
 * @brief IdManager that just counts the number of ids in use.
 *
 * @signature template <typename TSpec>
 *            class IdManager<void, TSpec>;
 *
 * @tparam TSpec Specializing type.
 */

template<typename TSpec>
class IdManager<void, TSpec>
{
    public:
        typedef typename Id<IdManager>::Type TIdType;
        TIdType data_idCount;

//____________________________________________________________________________
    public:
        IdManager() : data_idCount(0)
        {
        }

        ~IdManager()
        {
        }

        IdManager(IdManager const & _other) : data_idCount(_other.data_idCount)
        {
        }

        IdManager const&
        operator = (IdManager const& _other)
        {
            if (this == &_other) return *this;
            data_idCount = _other.data_idCount;
            return *this;
        }

//____________________________________________________________________________
};


//////////////////////////////////////////////////////////////////////////////
// Dummy IdManager - Metafunctions
//////////////////////////////////////////////////////////////////////////////

//////////////////////////////////////////////////////////////////////////////

template<typename TSpec>
struct Value<IdManager<void, TSpec> > {
    typedef typename Size<IdManager<void, TSpec> >::Type Type;
};

template<typename TSpec>
struct Value<IdManager<void, TSpec> const> {
    typedef typename Size<IdManager<void, TSpec> const>::Type Type;
};


//////////////////////////////////////////////////////////////////////////////
// FUNCTIONS
//////////////////////////////////////////////////////////////////////////////


//////////////////////////////////////////////////////////////////////////////

template<typename TSpec>
inline typename Value<IdManager<void, TSpec> >::Type
obtainId(IdManager<void, TSpec>& idm)
{
    ++idm.data_idCount;
    return 0;
}

//////////////////////////////////////////////////////////////////////////////

template <typename TSpec, typename TId>
inline void
releaseId(IdManager<void, TSpec>& idm,
          TId const)
{
    if (idm.data_idCount > 0) --idm.data_idCount;
}

//////////////////////////////////////////////////////////////////////////////

template<typename TSpec>
inline void
releaseAll(IdManager<void, TSpec>& idm)
{
    idm.data_idCount = 0;
}

//////////////////////////////////////////////////////////////////////////////

template<typename TSpec>
inline typename Value<IdManager<void, TSpec> >::Type
getIdUpperBound(IdManager<void, TSpec> const& idm)
{
    // Must be data_idCount in order to resize property maps!!!
    // Don't change to 0
    return idm.data_idCount;
}

//////////////////////////////////////////////////////////////////////////////

template<typename TSpec>
inline typename Value<IdManager<void, TSpec> >::Type
getIdLowerBound(IdManager<void, TSpec> const&)
{
    return 0;
}

//////////////////////////////////////////////////////////////////////////////


template <typename TSpec>
inline typename Value<IdManager<void, TSpec> >::Type
idCount(IdManager<void, TSpec> const& idm)
{
    return idm.data_idCount;
}

//////////////////////////////////////////////////////////////////////////////


template <typename TSpec, typename TId>
inline bool
idInUse(IdManager<void, TSpec> const&,
        TId const)
{
    return false;
}

}// namespace seqan2

#endif //#ifndef SEQAN_HEADER_...
