Boost C++ Libraries

...one of the most highly regarded and expertly designed C++ library projects in the world. Herb Sutter and Andrei Alexandrescu, C++ Coding Standards

This is the documentation for an old version of Boost. Click here to view this page for the latest version.

boost/container_hash/detail/hash_range.hpp

// Copyright 2022 Peter Dimov
// Distributed under the Boost Software License, Version 1.0.
// https://www.boost.org/LICENSE_1_0.txt

#ifndef BOOST_HASH_DETAIL_HASH_RANGE_HPP
#define BOOST_HASH_DETAIL_HASH_RANGE_HPP

#include <boost/container_hash/hash_fwd.hpp>
#include <boost/type_traits/integral_constant.hpp>
#include <boost/type_traits/enable_if.hpp>
#include <boost/type_traits/is_same.hpp>
#include <boost/cstdint.hpp>
#include <cstddef>
#include <climits>
#include <iterator>

namespace boost
{
namespace hash_detail
{

template<class T> struct is_char_type: public boost::false_type {};

#if CHAR_BIT == 8

template<> struct is_char_type<char>: public boost::true_type {};
template<> struct is_char_type<signed char>: public boost::true_type {};
template<> struct is_char_type<unsigned char>: public boost::true_type {};

#if defined(__cpp_char8_t) && __cpp_char8_t >= 201811L
template<> struct is_char_type<char8_t>: public boost::true_type {};
#endif

#if defined(__cpp_lib_byte) && __cpp_lib_byte >= 201603L
template<> struct is_char_type<std::byte>: public boost::true_type {};
#endif

#endif

template<class It>
inline typename boost::enable_if_<
    !is_char_type<typename std::iterator_traits<It>::value_type>::value,
std::size_t >::type
    hash_range( std::size_t seed, It first, It last )
{
    for( ; first != last; ++first )
    {
        hash_combine<typename std::iterator_traits<It>::value_type>( seed, *first );
    }

    return seed;
}

template<class It>
inline typename boost::enable_if_<
    is_char_type<typename std::iterator_traits<It>::value_type>::value &&
    is_same<typename std::iterator_traits<It>::iterator_category, std::random_access_iterator_tag>::value,
std::size_t>::type
    hash_range( std::size_t seed, It first, It last )
{
    std::size_t n = static_cast<std::size_t>( last - first );

    for( ; n >= 4; first += 4, n -= 4 )
    {
        // clang 5+, gcc 5+ figure out this pattern and use a single mov on x86
        // gcc on s390x and power BE even knows how to use load-reverse

        boost::uint32_t w =
            static_cast<boost::uint32_t>( static_cast<unsigned char>( first[0] ) ) |
            static_cast<boost::uint32_t>( static_cast<unsigned char>( first[1] ) ) <<  8 |
            static_cast<boost::uint32_t>( static_cast<unsigned char>( first[2] ) ) << 16 |
            static_cast<boost::uint32_t>( static_cast<unsigned char>( first[3] ) ) << 24;

        hash_combine( seed, w );
    }

    {
        // add a trailing suffix byte of 0x01 because otherwise sequences of
        // trailing zeroes are indistinguishable from end of string

        boost::uint32_t w = 0x01u;

        switch( n )
        {
        case 1:

            w =
                static_cast<boost::uint32_t>( static_cast<unsigned char>( first[0] ) ) |
                0x0100u;

            break;

        case 2:

            w =
                static_cast<boost::uint32_t>( static_cast<unsigned char>( first[0] ) ) |
                static_cast<boost::uint32_t>( static_cast<unsigned char>( first[1] ) ) <<  8 |
                0x010000u;

            break;

        case 3:

            w =
                static_cast<boost::uint32_t>( static_cast<unsigned char>( first[0] ) ) |
                static_cast<boost::uint32_t>( static_cast<unsigned char>( first[1] ) ) <<  8 |
                static_cast<boost::uint32_t>( static_cast<unsigned char>( first[2] ) ) << 16 |
                0x01000000u;

            break;
        }

        hash_combine( seed, w );
    }

    return seed;
}

template<class It>
inline typename boost::enable_if_<
    is_char_type<typename std::iterator_traits<It>::value_type>::value &&
    !is_same<typename std::iterator_traits<It>::iterator_category, std::random_access_iterator_tag>::value,
std::size_t>::type
    hash_range( std::size_t seed, It first, It last )
{
    for( ;; )
    {
        boost::uint32_t w = 0;

        if( first == last )
        {
            hash_combine( seed, w | 0x01u );
            return seed;
        }

        w |= static_cast<boost::uint32_t>( static_cast<unsigned char>( *first ) );
        ++first;

        if( first == last )
        {
            hash_combine( seed, w | 0x0100u );
            return seed;
        }

        w |= static_cast<boost::uint32_t>( static_cast<unsigned char>( *first ) ) << 8;
        ++first;

        if( first == last )
        {
            hash_combine( seed, w | 0x010000u );
            return seed;
        }

        w |= static_cast<boost::uint32_t>( static_cast<unsigned char>( *first ) ) << 16;
        ++first;

        if( first == last )
        {
            hash_combine( seed, w | 0x01000000u );
            return seed;
        }

        w |= static_cast<boost::uint32_t>( static_cast<unsigned char>( *first ) ) << 24;
        ++first;

        hash_combine( seed, w );
    }
}

} // namespace hash_detail
} // namespace boost

#endif // #ifndef BOOST_HASH_DETAIL_HASH_RANGE_HPP