Subversion Repositories scarts

// -*- C++ -*-

// Copyright (C) 2005 Free Software Foundation, Inc.

//

// This file is part of the GNU ISO C++ Library.  This library 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, or (at your option)

// any later version.

// This library 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 library; see the file COPYING.  If not, write to the Free

// Software Foundation, 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,

// USA.

// As a special exception, you may use this file as part of a free software

// library without restriction.  Specifically, if other files instantiate

// templates or use macros or inline functions from this file, or you compile

// this file and link it with other files to produce an executable, this

// file does not by itself cause the resulting executable to be covered by

// the GNU General Public License.  This exception does not however

// invalidate any other reasons why the executable file might be covered by

// the GNU General Public License.

// Copyright (C) 2004 Ami Tavory and Vladimir Dreizin, IBM-HRL.

// Permission to use, copy, modify, sell, and distribute this software

// is hereby granted without fee, provided that the above copyright

// notice appears in all copies, and that both that copyright notice and

// this permission notice appear in supporting documentation. None of

// the above authors, nor IBM Haifa Research Laboratories, make any

// representation about the suitability of this software for any

// purpose. It is provided "as is" without express or implied warranty.

/**

 * @file ranged_hash_fn.hpp

 * Contains a unified ranged hash functor, allowing the hash tables to deal with

 *      a single class for ranged hashing.

 */

#ifndef RANGED_HASH_FN_HPP

#define RANGED_HASH_FN_HPP

#include <utility>

namespace pb_assoc

{

  namespace detail

  {

#ifdef PB_ASSOC_RANGED_HASH_FN_DEBUG

#define PB_ASSOC_DBG_ASSERT(X) assert(X)

#define PB_ASSOC_DBG_VERIFY(X) assert(X)

#define PB_ASSOC_DBG_ONLY(X) X

#else // #ifdef PB_ASSOC_RANGED_HASH_FN_DEBUG

#define PB_ASSOC_DBG_ASSERT(X)

#define PB_ASSOC_DBG_VERIFY(X) {if((X)==0);}

#define PB_ASSOC_DBG_ONLY(X) ;

#endif // #ifdef PB_ASSOC_RANGED_HASH_FN_DEBUG

    template<typename Key,

             class Hash_Fn,

             class Allocator,

             class Comb_Hash_Fn,

             bool Store_Hash>

    class ranged_hash_fn;

#define PB_ASSOC_CLASS_T_DEC \

        template< \

                typename Key, \

                class Hash_Fn, \

                class Allocator, \

                class Comb_Hash_Fn>

#define PB_ASSOC_CLASS_C_DEC \

        ranged_hash_fn< \

                Key, \

                Hash_Fn, \

                Allocator, \

                Comb_Hash_Fn, \

                false>

    /**

     * Specialization 1- The client supplies a hash function and a ranged

     *  hash function, and requests that hash values not be stored.

     **/

    template<typename Key,

             class Hash_Fn,

             class Allocator,

             class Comb_Hash_Fn>

    class ranged_hash_fn<Key, Hash_Fn, Allocator, Comb_Hash_Fn, false> : public Hash_Fn,

                                                                         public Comb_Hash_Fn

    {

    protected:

      typedef typename Allocator::size_type size_type;

      typedef Hash_Fn my_hash_fn_base;

      typedef Comb_Hash_Fn my_comb_hash_fn_base;

      typedef typename Allocator::template rebind<Key>::other key_allocator;

      typedef typename key_allocator::const_reference const_key_reference;

    protected:

      ranged_hash_fn(size_type size);

      ranged_hash_fn(size_type size, const Hash_Fn& r_hash_fn);

      ranged_hash_fn(size_type size, const Hash_Fn& r_hash_fn, const Comb_Hash_Fn& r_comb_hash_fn);

      void

      swap(PB_ASSOC_CLASS_C_DEC& r_other);

      void

      notify_resized(size_type size);

      inline size_type

      operator()(const_key_reference r_key) const;

    };

    PB_ASSOC_CLASS_T_DEC

    PB_ASSOC_CLASS_C_DEC::

    ranged_hash_fn(size_type size)

    {

      Comb_Hash_Fn::notify_resized(size);

    }

    PB_ASSOC_CLASS_T_DEC

    PB_ASSOC_CLASS_C_DEC::

    ranged_hash_fn(size_type size, const Hash_Fn& r_hash_fn) :

      Hash_Fn(r_hash_fn)

    {

      Comb_Hash_Fn::notify_resized(size);

    }

    PB_ASSOC_CLASS_T_DEC

    PB_ASSOC_CLASS_C_DEC::

    ranged_hash_fn(size_type size, const Hash_Fn& r_hash_fn, const Comb_Hash_Fn& r_comb_hash_fn) :

      Hash_Fn(r_hash_fn),

      Comb_Hash_Fn(r_comb_hash_fn)

    {

      my_comb_hash_fn_base::notify_resized(size);

    }

    PB_ASSOC_CLASS_T_DEC

    void

    PB_ASSOC_CLASS_C_DEC::

    swap(PB_ASSOC_CLASS_C_DEC& r_other)

    {

      my_comb_hash_fn_base::swap(r_other);

      std::swap((Hash_Fn& )(*this), (Hash_Fn& )r_other);

    }

    PB_ASSOC_CLASS_T_DEC

    void

    PB_ASSOC_CLASS_C_DEC::

    notify_resized(size_type size)

    {

      my_comb_hash_fn_base::notify_resized(size);

    }

    PB_ASSOC_CLASS_T_DEC

    inline typename PB_ASSOC_CLASS_C_DEC::size_type

    PB_ASSOC_CLASS_C_DEC::

    operator()(const_key_reference r_key) const

    {

      return (my_comb_hash_fn_base::operator()(

                                               my_hash_fn_base::operator()(r_key)));

    }

#undef PB_ASSOC_CLASS_T_DEC

#undef PB_ASSOC_CLASS_C_DEC

#define PB_ASSOC_CLASS_T_DEC \

        template< \

                typename Key, \

                class Hash_Fn, \

                class Allocator, \

                class Comb_Hash_Fn>

#define PB_ASSOC_CLASS_C_DEC \

        ranged_hash_fn< \

                Key, \

                Hash_Fn, \

                Allocator, \

                Comb_Hash_Fn, \

                true>

    /**

     * Specialization 2- The client supplies a hash function and a ranged

     *  hash function, and requests that hash values be stored.

     **/

    template<typename Key,

             class Hash_Fn,

             class Allocator,

             class Comb_Hash_Fn>

    class ranged_hash_fn<Key, Hash_Fn, Allocator, Comb_Hash_Fn, true> :

      public Hash_Fn,

      public Comb_Hash_Fn

    {

    protected:

      typedef typename Allocator::size_type size_type;

      typedef std::pair<size_type, size_type> comp_hash;

      typedef Hash_Fn my_hash_fn_base;

      typedef Comb_Hash_Fn my_comb_hash_fn_base;

      typedef typename Allocator::template rebind<Key>::other key_allocator;

      typedef typename key_allocator::const_reference const_key_reference;

    protected:

      ranged_hash_fn(size_type size);

      ranged_hash_fn(size_type size, const Hash_Fn& r_hash_fn);

      ranged_hash_fn(size_type size, const Hash_Fn& r_hash_fn, const Comb_Hash_Fn& r_comb_hash_fn);

      void

      swap(PB_ASSOC_CLASS_C_DEC& r_other);

      void

      notify_resized(size_type size);

      inline comp_hash

      operator()(const_key_reference r_key) const;

      inline comp_hash

      operator()(const_key_reference r_key, size_type hash) const;

    };

    PB_ASSOC_CLASS_T_DEC

    PB_ASSOC_CLASS_C_DEC::

    ranged_hash_fn(size_type size)

    {

      Comb_Hash_Fn::notify_resized(size);

    }

    PB_ASSOC_CLASS_T_DEC

    PB_ASSOC_CLASS_C_DEC::

    ranged_hash_fn(size_type size, const Hash_Fn& r_hash_fn) :

      Hash_Fn(r_hash_fn)

    {

      Comb_Hash_Fn::notify_resized(size);

    }

    PB_ASSOC_CLASS_T_DEC

    PB_ASSOC_CLASS_C_DEC::

    ranged_hash_fn(size_type size, const Hash_Fn& r_hash_fn, const Comb_Hash_Fn& r_comb_hash_fn) :

      Hash_Fn(r_hash_fn),

      Comb_Hash_Fn(r_comb_hash_fn)

    {

      my_comb_hash_fn_base::notify_resized(size);

    }

    PB_ASSOC_CLASS_T_DEC

    void

    PB_ASSOC_CLASS_C_DEC::

    swap(PB_ASSOC_CLASS_C_DEC& r_other)

    {

      my_comb_hash_fn_base::swap(r_other);

      std::swap((Hash_Fn& )(*this), (Hash_Fn& )r_other);

    }

    PB_ASSOC_CLASS_T_DEC

    void

    PB_ASSOC_CLASS_C_DEC::

    notify_resized(size_type size)

    {

      my_comb_hash_fn_base::notify_resized(size);

    }

    PB_ASSOC_CLASS_T_DEC

    inline typename PB_ASSOC_CLASS_C_DEC::comp_hash

    PB_ASSOC_CLASS_C_DEC::

    operator()(const_key_reference r_key) const

    {

      const size_type hash = my_hash_fn_base::operator()(r_key);

      return (std::make_pair(my_comb_hash_fn_base::operator()(hash), hash));

    }

    PB_ASSOC_CLASS_T_DEC

    inline typename PB_ASSOC_CLASS_C_DEC::comp_hash

    PB_ASSOC_CLASS_C_DEC::

    operator()

#ifdef PB_ASSOC_RANGED_HASH_FN_DEBUG

      (const_key_reference r_key, size_type hash) const

#else // #ifdef PB_ASSOC_RANGED_HASH_FN_DEBUG

      (const_key_reference /*r_key*/, size_type hash) const

#endif // #ifdef PB_ASSOC_RANGED_HASH_FN_DEBUG

    {

      PB_ASSOC_DBG_ASSERT(hash == my_hash_fn_base::operator()(r_key));

      return (std::make_pair(my_comb_hash_fn_base::operator()(hash), hash));

    }

#undef PB_ASSOC_CLASS_T_DEC

#undef PB_ASSOC_CLASS_C_DEC

#define PB_ASSOC_CLASS_T_DEC \

        template<typename Key, class Allocator, class Comb_Hash_Fn>

#define PB_ASSOC_CLASS_C_DEC \

        ranged_hash_fn< \

                Key, \

                null_hash_fn, \

                Allocator, \

                Comb_Hash_Fn, \

                false>

    /**

     * Specialization 3- The client does not supply a hash function

     *  (by specifying null_hash_fn as the Hash_Fn parameter),

     *  and requests that hash values not be stored.

    **/

    template<typename Key, class Allocator, class Comb_Hash_Fn>

    class ranged_hash_fn<Key, null_hash_fn, Allocator,

                         Comb_Hash_Fn, false> :

      public null_hash_fn,

      public Comb_Hash_Fn

    {

    protected:

      typedef typename Allocator::size_type size_type;

      typedef Comb_Hash_Fn my_comb_hash_fn_base;

    protected:

      ranged_hash_fn(size_type size);

      ranged_hash_fn(size_type size, const Comb_Hash_Fn& r_comb_hash_fn);

      ranged_hash_fn(size_type size, const null_hash_fn&r_null_hash_fn, const Comb_Hash_Fn& r_comb_hash_fn);

      void

      swap(PB_ASSOC_CLASS_C_DEC& r_other);

    };

    PB_ASSOC_CLASS_T_DEC

    PB_ASSOC_CLASS_C_DEC::

    ranged_hash_fn(size_type size)

    {

      Comb_Hash_Fn::notify_resized(size);

    }

    PB_ASSOC_CLASS_T_DEC

    PB_ASSOC_CLASS_C_DEC::

    ranged_hash_fn(size_type size, const Comb_Hash_Fn& r_comb_hash_fn) :

      Comb_Hash_Fn(r_comb_hash_fn)

    { }

    PB_ASSOC_CLASS_T_DEC

    PB_ASSOC_CLASS_C_DEC::

    ranged_hash_fn(size_type size, const null_hash_fn& r_null_hash_fn, const Comb_Hash_Fn& r_comb_hash_fn) :

      Comb_Hash_Fn(r_comb_hash_fn)

    { }

    PB_ASSOC_CLASS_T_DEC

    void

    PB_ASSOC_CLASS_C_DEC::

    swap(PB_ASSOC_CLASS_C_DEC& r_other)

    {

      my_comb_hash_fn_base::swap(r_other);

    }

#undef PB_ASSOC_CLASS_T_DEC

#undef PB_ASSOC_CLASS_C_DEC

#define PB_ASSOC_CLASS_T_DEC \

        template<typename Key, class Allocator, class Comb_Hash_Fn>

#define PB_ASSOC_CLASS_C_DEC \

        ranged_hash_fn< \

                Key, \

                null_hash_fn, \

                Allocator, \

                Comb_Hash_Fn, \

                true>

    /**

     * Specialization 4- The client does not supply a hash function

     *  (by specifying null_hash_fn as the Hash_Fn parameter),

     *  and requests that hash values be stored.

    **/

    template<typename Key, class Allocator, class Comb_Hash_Fn>

    class ranged_hash_fn<Key, null_hash_fn, Allocator,

                         Comb_Hash_Fn, true> :

      public null_hash_fn,

      public Comb_Hash_Fn

    {

    protected:

      typedef typename Allocator::size_type size_type;

      typedef Comb_Hash_Fn my_comb_hash_fn_base;

    protected:

      ranged_hash_fn(size_type size);

      ranged_hash_fn(size_type size, const Comb_Hash_Fn& r_comb_hash_fn);

      ranged_hash_fn(size_type size, const null_hash_fn&r_null_hash_fn, const Comb_Hash_Fn& r_comb_hash_fn);

      void

      swap(PB_ASSOC_CLASS_C_DEC& r_other);

    };

    PB_ASSOC_CLASS_T_DEC

    PB_ASSOC_CLASS_C_DEC::

    ranged_hash_fn(size_type size)

    {

      Comb_Hash_Fn::notify_resized(size);

    }

    PB_ASSOC_CLASS_T_DEC

    PB_ASSOC_CLASS_C_DEC::

    ranged_hash_fn(size_type size, const Comb_Hash_Fn& r_comb_hash_fn) :

      Comb_Hash_Fn(r_comb_hash_fn)

    { }

    PB_ASSOC_CLASS_T_DEC

    PB_ASSOC_CLASS_C_DEC::

    ranged_hash_fn(size_type size, const null_hash_fn&r_null_hash_fn, const Comb_Hash_Fn& r_comb_hash_fn) :

      Comb_Hash_Fn(r_comb_hash_fn)

    { }

    PB_ASSOC_CLASS_T_DEC

    void

    PB_ASSOC_CLASS_C_DEC::

    swap(PB_ASSOC_CLASS_C_DEC& r_other)

    {

      my_comb_hash_fn_base::swap(r_other);

    }

#undef PB_ASSOC_CLASS_T_DEC

#undef PB_ASSOC_CLASS_C_DEC

#undef PB_ASSOC_DBG_ASSERT

#undef PB_ASSOC_DBG_VERIFY

#undef PB_ASSOC_DBG_ONLY

  } // namespace detail

} // namespace pb_assoc

#endif // #ifndef RANGED_HASH_FN_HPP