htable.f90

Go to the documentation of this file.

! Copyright (c) 2019-2026, The Neko Authors
! 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 the authors 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 THE
! COPYRIGHT OWNER OR CONTRIBUTORS 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.
!
module htable
  use num_types, only: dp, i4, i8
  use utils, only: neko_error
  use point, only : point_t
  use tuple, only : tuple_i4_t, tuple4_i4_t, tuple_t
  use math, only : neko_m_ln2
  use, intrinsic :: iso_c_binding, only : c_ptr, c_associated
  implicit none
  private
 
  type :: h_tuple_t
     logical :: valid = .false.
     logical :: skip = .false.
     class(*), allocatable :: key
     class(*), allocatable :: data
     type(h_tuple_t), pointer :: next => null()
     type(h_tuple_t), pointer :: prev => null()
  end type h_tuple_t
 
  type, public, abstract :: htable_t
     integer, private :: size = 0
     integer, private :: entries = 0
     type(h_tuple_t), private, allocatable :: t(:)
     type(h_tuple_t), pointer :: head => null()
     type(h_tuple_t), pointer :: tail => null()
   contains
     procedure(htable_hash), pass(this), deferred :: hash
     procedure, public, pass(this) :: clear => htable_clear
     procedure, public, pass(this) :: free => htable_free
     procedure, public, pass(this) :: num_entries => htable_num_entries
     procedure, public, pass(this) :: get_size => htable_size
  end type htable_t
 
  abstract interface
     pure function htable_hash(this, k, c) result(hash)
       import htable_t
       class(htable_t), intent(in) :: this
       class(*), intent(in) :: k
       integer, value :: c
       integer :: hash
     end function htable_hash
  end interface
 
  !
  ! Implementations
  !
 
  type, public, extends(htable_t) :: htable_i4_t
   contains
     procedure, pass(this) :: init => htable_i4_init
     procedure, pass(this) :: set => htable_i4_set
     procedure, pass(this) :: get => htable_i4_get
     procedure, pass(this) :: hash => htable_i4_hash
     procedure, pass(this) :: remove => htable_i4_remove
  end type htable_i4_t
 
  type, public, extends(htable_t) :: htable_i8_t
   contains
     procedure, pass(this) :: init => htable_i8_init
     procedure, pass(this) :: set => htable_i8_set
     procedure, pass(this) :: get => htable_i8_get
     procedure, pass(this) :: hash => htable_i8_hash
     procedure, pass(this) :: remove => htable_i8_remove
  end type htable_i8_t
 
  type, public, extends(htable_t) :: htable_r8_t
   contains
     procedure, pass(this) :: init => htable_r8_init
     procedure, pass(this) :: set => htable_r8_set
     procedure, pass(this) :: get => htable_r8_get
     procedure, pass(this) :: hash => htable_r8_hash
     procedure, pass(this) :: remove => htable_r8_remove
  end type htable_r8_t
 
  type, public, extends(htable_t) :: htable_pt_t
   contains
     procedure, pass(this) :: init => htable_pt_init
     procedure, pass(this) :: set => htable_pt_set
     procedure, pass(this) :: get => htable_pt_get
     procedure, pass(this) :: hash => htable_pt_hash
     procedure, pass(this) :: remove => htable_pt_remove
  end type htable_pt_t
 
  type, public, extends(htable_t) :: htable_i4t2_t
   contains
     procedure, pass(this) :: init => htable_i4t2_init
     procedure, pass(this) :: set => htable_i4t2_set
     procedure, pass(this) :: get => htable_i4t2_get
     procedure, pass(this) :: hash => htable_i4t2_hash
     procedure, pass(this) :: remove => htable_i4t2_remove
  end type htable_i4t2_t
 
  type, public, extends(htable_t) :: htable_i4t4_t
   contains
     procedure, pass(this) :: init => htable_i4t4_init
     procedure, pass(this) :: set => htable_i4t4_set
     procedure, pass(this) :: get => htable_i4t4_get
     procedure, pass(this) :: hash => htable_i4t4_hash
     procedure, pass(this) :: remove => htable_i4t4_remove
  end type htable_i4t4_t
 
  type, public, extends(htable_t) :: htable_cptr_t
   contains
     procedure, pass(this) :: init => htable_cptr_init
     procedure, pass(this) :: set => htable_cptr_set
     procedure, pass(this) :: get => htable_cptr_get
     procedure, pass(this) :: hash => htable_cptr_hash
     procedure, pass(this) :: remove => htable_cptr_remove
  end type htable_cptr_t
 
  !
  ! Iterators
  !
 
  type, public, abstract :: htable_iter_t
     class(htable_t), pointer :: t
     type(h_tuple_t), pointer :: current => null()
   contains
     procedure, public, pass(this) :: next => htable_iter_next
     procedure, public, pass(this) :: reset => htable_iter_reset
     procedure, public, pass(this) :: data => htable_iter_data
  end type htable_iter_t
 
  type, public, extends(htable_iter_t) :: htable_iter_i4_t
   contains
     procedure, pass(this) :: init => htable_iter_i4_init
     procedure, pass(this) :: value => htable_iter_i4_value
     procedure, pass(this) :: key => htable_iter_i4_key
     final :: htable_iter_i4_free
  end type htable_iter_i4_t
 
  type, public, extends(htable_iter_t) :: htable_iter_i8_t
   contains
     procedure, pass(this) :: init => htable_iter_i8_init
     procedure, pass(this) :: value => htable_iter_i8_value
     procedure, pass(this) :: key => htable_iter_i8_key
     final :: htable_iter_i8_free
  end type htable_iter_i8_t
 
  type, public, extends(htable_iter_t) :: htable_iter_r8_t
   contains
     procedure, pass(this) :: init => htable_iter_r8_init
     procedure, pass(this) :: value => htable_iter_r8_value
     procedure, pass(this) :: key => htable_iter_r8_key
     final :: htable_iter_r8_free
  end type htable_iter_r8_t
 
  type, public, extends(htable_iter_t) :: htable_iter_pt_t
   contains
     procedure, pass(this) :: init => htable_iter_pt_init
     procedure, pass(this) :: value => htable_iter_pt_value
     procedure, pass(this) :: key => htable_iter_pt_key
     final :: htable_iter_pt_free
  end type htable_iter_pt_t
 
  type, public, extends(htable_iter_t) :: htable_iter_i4t2_t
   contains
     procedure, pass(this) :: init => htable_iter_i4t2_init
     procedure, pass(this) :: value => htable_iter_i4t2_value
     procedure, pass(this) :: key => htable_iter_i4t2_key
     final :: htable_iter_i4t2_free
  end type htable_iter_i4t2_t
 
  type, public, extends(htable_iter_t) :: htable_iter_i4t4_t
   contains
     procedure, pass(this) :: init => htable_iter_i4t4_init
     procedure, pass(this) :: value => htable_iter_i4t4_value
     procedure, pass(this) :: key => htable_iter_i4t4_key
     final :: htable_iter_i4t4_free
  end type htable_iter_i4t4_t
 
  type, public, extends(htable_iter_t) :: htable_iter_cptr_t
   contains
     procedure, pass(this) :: init => htable_iter_cptr_init
     procedure, pass(this) :: value => htable_iter_cptr_value
     procedure, pass(this) :: key => htable_iter_cptr_key
     final :: htable_iter_cptr_free
  end type htable_iter_cptr_t
 
  !
  ! Type wrappers
  !
  type, public :: h_cptr_t
     type(c_ptr) :: ptr
  end type h_cptr_t
 
contains
 
  subroutine htable_init(this, size, key, data)
    class(htable_t), intent(inout) :: this
    integer, value :: size
    class(*), target, intent(in) :: key
    class(*), target, intent(in), optional :: data
    class(*), pointer :: data_ptr
    integer :: i
 
 
    call htable_free(this)
 
    if (size .lt. 4) then
       size = 4
    end if
 
    size = ishft(1, ceiling(log(dble(size)) / neko_m_ln2))
 
    allocate(this%t(0:size))
    this%t(:)%valid = .false.
    this%size = size
    this%entries = 0
 
    data_ptr => key
    if (present(data)) then
       data_ptr => data
    end if
 
    do i = 0, size
       allocate(this%t(i)%key, source=key)
       allocate(this%t(i)%data, source=data_ptr)
    end do
  end subroutine htable_init
 
  subroutine htable_free(this)
    class(htable_t), intent(inout) :: this
    integer :: i
 
    nullify(this%head)
    nullify(this%tail)
 
    if (allocated(this%t)) then
       do i = 0, this%size 
          deallocate(this%t(i)%key)
          deallocate(this%t(i)%data)
       end do
       deallocate(this%t)
    end if
 
    this%size = 0
    this%entries = 0
 
  end subroutine htable_free
 
  subroutine htable_clear(this)
    class(htable_t), intent(inout) :: this
 
    if (allocated(this%t)) then
       this%t(:)%valid = .false.
       this%entries = 0
    else
       call neko_error("Hash table not allocated")
    end if
 
  end subroutine htable_clear
 
  pure function htable_num_entries(this) result(entries)
    class(htable_t), intent(in) :: this
    integer :: entries
    entries = this%entries
  end function htable_num_entries
 
  pure function htable_size(this) result(size)
    class(htable_t), intent(in) :: this
    integer :: size
    size = this%size
  end function htable_size
 
 
  recursive subroutine htable_set(this, key, data)
    class(htable_t), target, intent(inout) :: this
    class(*), intent(inout) :: key
    class(*), intent(inout) :: data
    class(htable_t), allocatable :: tmp
    integer index, i, c
 
    c = 0
    i = log(1.0/this%size)/log(0.6)
    index = 0
 
    do while (i .ge. 0)
       index = this%hash(key, c**2)
       if (index .lt. 0) then
          call neko_error("Invalid hash generated")
       end if
       if ((.not. this%t(index)%valid) .or. &
            htable_eq_key(this, index, key)) then
          call htable_set_key(this, index, key)
          call htable_set_data(this, index, data)
          if (.not. this%t(index)%valid) then
             this%entries = this%entries + 1
             if (associated(this%tail)) then
                this%tail%next => this%t(index)
                this%t(index)%prev => this%tail
                this%tail => this%t(index)
             else
                this%head => this%t(index)
                this%tail => this%t(index)
             end if
          end if
          this%t(index)%valid = .true.
          this%t(index)%skip = .false.
          return
       end if
       i = i - 1
       c = c + 1
    end do
 
    select type(key)
    type is (integer)
       allocate(htable_i4_t::tmp)
    type is (integer(i8))
       allocate(htable_i8_t::tmp)
    type is (double precision)
       allocate(htable_r8_t::tmp)
    type is (point_t)
       allocate(htable_pt_t::tmp)
    type is (tuple_i4_t)
       allocate(htable_i4t2_t::tmp)
    type is (tuple4_i4_t)
       allocate(htable_i4t4_t::tmp)
    type is (h_cptr_t)
       allocate(htable_cptr_t::tmp)
    class default
       call neko_error('Invalid htable key')
    end select
 
    call htable_init(tmp, ishft(this%size, 1), key, data)
 
    !
    ! When rebuilding the table we used the following loop:
    !
    ! do i = 0, this%size - 1
    !   if (this%t(i)%valid) then
    !      call htable_set(tmp, this%t(i)%key, this%t(i)%data)
    !   end if
    ! end do
    !
    ! However, CCE 18.x (and probably other llvm based compilers)
    ! segfault faults unless the data variable is enclosed in a
    ! select type block
    !
 
    do i = 0, this%size - 1
       if (this%t(i)%valid) then
          select type (datap => this%t(i)%data)
          type is (integer)
             call htable_set(tmp, this%t(i)%key, datap)
          type is (integer(i8))
             call htable_set(tmp, this%t(i)%key, datap)
          type is (double precision)
             call htable_set(tmp, this%t(i)%key, datap)
          type is (point_t)
             call htable_set(tmp, this%t(i)%key, datap)
          class is (tuple_t)
             select type(tuplep => datap)
             type is (tuple_i4_t)
                call htable_set(tmp, this%t(i)%key, tuplep)
             type is (tuple4_i4_t)
                call htable_set(tmp, this%t(i)%key, tuplep)
             end select
          type is (h_cptr_t)
             call htable_set(tmp, this%t(i)%key, datap)
          class default
             call neko_error('Invalid htable data')
          end select
       end if
    end do
 
    this%head => tmp%head
    this%tail => tmp%tail
    this%size = tmp%size
    call move_alloc(tmp%t, this%t)
 
    call htable_set(this, key, data)
 
  end subroutine htable_set
 
  function htable_get(this, key, data) result(rcode)
    class(htable_t), intent(inout) :: this
    class(*), intent(inout) :: key
    class(*), intent(inout) :: data
    integer :: rcode
    integer :: index, i, c
 
    c = 0
    i = log(1.0/this%size)/log(0.6)
 
    do while (i .ge. 0)
       index = this%hash(key, c**2)
       if (index .lt. 0) then
          call neko_error("Invalid hash generated")
       end if
 
       if (.not. this%t(index)%valid .and. &
            .not. this%t(index)%skip) then
          rcode = 1
          return
       else if ((this%t(index)%valid) .and. &
            htable_eq_key(this, index, key)) then
          call htable_get_data(this, index, data)
          rcode = 0
          return
       end if
       i = i - 1
       c = c + 1
    end do
    rcode = 1
  end function htable_get
 
  subroutine htable_remove(this, key)
    class(htable_t), intent(inout) :: this
    class(*), intent(inout) :: key
    integer :: index, i, c
 
    c = 0
    i = log(1.0/this%size)/log(0.6)
 
    do while (i .ge. 0)
       index = this%hash(key, c**2)
       if (index .lt. 0) then
          call neko_error("Invalid hash generated")
       end if
 
       if ((this%t(index)%valid) .and. &
            htable_eq_key(this, index, key)) then
 
          if (associated(this%t(index)%prev)) then
             this%t(index)%prev%next => this%t(index)%next
          else
             this%head => this%t(index)%next
          end if
 
          if (associated(this%t(index)%next)) then
             this%t(index)%next%prev => this%t(index)%prev
          else
             this%tail => this%t(index)%prev
          end if
 
          this%t(index)%valid = .false.
          this%t(index)%skip = .true.
          this%entries = this%entries - 1
          return
       end if
       i = i - 1
       c = c + 1
    end do
  end subroutine htable_remove
 
  subroutine htable_set_data(this, idx, data)
    class(htable_t), target, intent(inout) :: this
    integer, intent(in) :: idx
    class(*), intent(in) :: data
    class(*), pointer :: hdp
 
    hdp => this%t(idx)%data
    select type (data)
    type is (integer)
       select type(hdp)
       type is (integer)
          hdp = data
       end select
    type is (integer(i8))
       select type(hdp)
       type is (integer(i8))
          hdp = data
       end select
    type is (double precision)
       select type(hdp)
       type is (double precision)
          hdp = data
       end select
    type is (point_t)
       select type(hdp)
       type is (point_t)
          hdp = data
       end select
    class is (tuple_t)
       select type(hdp)
       type is (tuple_i4_t)
          hdp = data
       type is (tuple4_i4_t)
          hdp = data
       end select
    type is (h_cptr_t)
       select type(hdp)
       type is (h_cptr_t)
          hdp = data
       end select
    class default
       call neko_error('Invalid htable data (set)')
    end select
  end subroutine htable_set_data
 
  subroutine htable_get_data(this, idx, data)
    class(htable_t), intent(in) :: this
    integer, intent(in) :: idx
    class(*), intent(inout) :: data
 
    select type (hdp=>this%t(idx)%data)
    type is (integer)
       select type(data)
       type is (integer)
          data = hdp
       end select
    type is (integer(i8))
       select type(data)
       type is (integer(i8))
          data = hdp
       end select
    type is (double precision)
       select type(data)
       type is (double precision)
          data = hdp
       end select
    type is (point_t)
       select type(data)
       type is (point_t)
          data = hdp
       end select
    class is (tuple_t)
       select type(data)
       type is (tuple_i4_t)
          data = hdp
       type is (tuple4_i4_t)
          data = hdp
       end select
    type is (h_cptr_t)
       select type (data)
       type is (h_cptr_t)
          data = hdp
       end select
    class default
       call neko_error('Invalid htable data (get)')
    end select
  end subroutine htable_get_data
 
  pure function htable_eq_key(this, idx, key) result(res)
    class(htable_t), intent(in) :: this
    integer, intent(in) :: idx
    class(*), intent(in) :: key
    logical :: res
 
    res = .true.
    select type (kp=>this%t(idx)%key)
    type is (integer)
       select type(key)
       type is (integer)
          res = (kp .eq. key)
       end select
    type is (integer(i8))
       select type(key)
       type is (integer(i8))
          res = (kp .eq. key)
       end select
    type is (double precision)
       select type(key)
       type is (double precision)
          res = abs(kp - key) .lt. epsilon(1.0_dp)
       end select
    type is (point_t)
       select type (key)
       type is (point_t)
          res = (kp .eq. key)
       end select
    class is (tuple_t)
       select type (key)
       type is (tuple_i4_t)
          res = (key .eq. kp)
       type is (tuple4_i4_t)
          res = (key .eq. kp)
       end select
    type is (h_cptr_t)
       select type (key)
       type is (h_cptr_t)
          res = c_associated(kp%ptr, key%ptr)
       end select
    end select
  end function htable_eq_key
 
  subroutine htable_set_key(this, idx, key)
    class(htable_t), target, intent(inout) :: this
    integer, intent(in) :: idx
    class(*), intent(in) :: key
    class(*), pointer :: kp
 
    kp => this%t(idx)%key
    select type(key)
    type is (integer)
       select type(kp)
       type is (integer)
          kp = key
       end select
    type is (integer(i8))
       select type(kp)
       type is (integer(i8))
          kp = key
       end select
    type is (double precision)
       select type(kp)
       type is (double precision)
          kp = key
       end select
    type is (point_t)
       select type (kp)
       type is (point_t)
          kp = key
       end select
    class is (tuple_t)
       select type(kp)
       type is (tuple_i4_t)
          kp = key
       type is (tuple4_i4_t)
          kp = key
       end select
    type is (h_cptr_t)
       select type(kp)
       type is (h_cptr_t)
          kp = key
       end select
    class default
       call neko_error('Invalid htable key (set)')
    end select
  end subroutine htable_set_key
 
  function htable_iter_next(this) result(valid)
    class(htable_iter_t), target, intent(inout) :: this
    logical :: valid
 
    if (.not. associated(this%current)) then
       this%current => this%t%head
       valid = associated(this%current)
    else if (associated(this%current)) then
       if (associated(this%current, this%t%tail)) then
          valid = .false.
       else
          this%current => this%current%next
          valid = associated(this%current)
       end if
    end if
 
  end function htable_iter_next
 
  subroutine htable_iter_reset(this)
    class(htable_iter_t), intent(inout) :: this
    nullify(this%current)
  end subroutine htable_iter_reset
 
  subroutine htable_iter_data(this, data)
    class(htable_iter_t), target, intent(inout) :: this
    class(*), intent(inout) :: data
    class(*), pointer :: hdp
 
    hdp => this%current%data
    select type(hdp)
    type is (integer)
       select type (data)
       type is (integer)
          data = hdp
       end select
    type is (integer(i8))
       select type (data)
       type is (integer(i8))
          data = hdp
       end select
    type is (double precision)
       select type(data)
       type is (double precision)
          data = hdp
       end select
    type is (point_t)
       select type (data)
       type is (point_t)
          data = hdp
       end select
    class is (tuple_t)
       select type (data)
       type is (tuple_i4_t)
          data = hdp
       type is (tuple4_i4_t)
          data = hdp
       end select
    type is (h_cptr_t)
       select type (data)
       type is (h_cptr_t)
          data = hdp
       end select
    class default
       call neko_error('Invalid htable data (iter)')
    end select
 
  end subroutine htable_iter_data
 
  !
  ! Integer based implementation
  !
  subroutine htable_i4_init(this, size, data)
    class(htable_i4_t), intent(inout) :: this
    integer, value :: size
    class(*), intent(inout), optional :: data
    integer :: key
 
    if (present(data)) then
       call htable_init(this, size, key, data)
    else
       call htable_init(this, size, key)
    end if
 
  end subroutine htable_i4_init
 
  subroutine htable_i4_set(this, key, data)
    class(htable_i4_t), intent(inout) :: this
    integer, intent(inout) :: key
    class(*), intent(inout) :: data
 
    call htable_set(this, key, data)
 
  end subroutine htable_i4_set
 
  function htable_i4_get(this, key, data) result(rcode)
    class(htable_i4_t), intent(inout) :: this
    integer, intent(inout) :: key
    class(*), intent(inout) :: data
    integer :: rcode
 
    rcode = htable_get(this, key, data)
 
  end function htable_i4_get
 
  pure function htable_i4_hash(this, k, c) result(hash)
    class(htable_i4_t), intent(in) :: this
    class(*), intent(in) :: k
    integer, value :: c
    integer :: hash
    integer(kind=i8) :: tmp
    integer(kind=i8), parameter :: m1 = int(z'7ed55d15', i8)
    integer(kind=i8), parameter :: m2 = int(z'c761c23c', i8)
    integer(kind=i8), parameter :: m3 = int(z'165667b1', i8)
    integer(kind=i8), parameter :: m4 = int(z'd3a2646c', i8)
    integer(kind=i8), parameter :: m5 = int(z'fd7046c5', i8)
    integer(kind=i8), parameter :: m6 = int(z'b55a4f09', i8)
 
    select type(k)
    type is (integer)
       tmp = int(k, i8)
       tmp = (k + m1) + ishft(k, 12)
       tmp = ieor(ieor(tmp, m2), ishft(tmp, -19))
       tmp = (tmp + m3) + ishft(tmp, 5)
       tmp = ieor((tmp + m4), ishft(tmp, 9))
       tmp = (tmp + m5) + ishft(tmp, 3)
       tmp = ieor(ieor(tmp, m6), ishft(tmp, -16))
       tmp = modulo(tmp + int(c, i8), int(this%size, i8))
       hash = int(tmp, i4)
    class default
       hash = -1
    end select
  end function htable_i4_hash
 
  subroutine htable_i4_remove(this, key)
    class(htable_i4_t), intent(inout) :: this
    integer, intent(inout) :: key
 
    call htable_remove(this, key)
 
  end subroutine htable_i4_remove
 
  subroutine htable_iter_i4_init(this, t)
    class(htable_iter_i4_t), intent(inout) :: this
    type(htable_i4_t), target, intent(inout) :: t
 
    this%t => t
 
  end subroutine htable_iter_i4_init
 
  subroutine htable_iter_i4_free(this)
    type(htable_iter_i4_t), intent(inout) :: this
    nullify(this%t)
    nullify(this%current)
  end subroutine htable_iter_i4_free
 
  function htable_iter_i4_value(this) result(value)
    class(htable_iter_i4_t), target, intent(inout) :: this
    integer, pointer :: value
 
    select type (hdp => this%current%data)
    type is (integer)
       value => hdp
    class default
       call neko_error('Key and data of different kind (i4)')
    end select
 
  end function htable_iter_i4_value
 
  function htable_iter_i4_key(this) result(key)
    class(htable_iter_i4_t), target, intent(inout) :: this
    integer, pointer :: key
 
    select type (kp => this%current%key)
    type is (integer)
       key => kp
    class default
       call neko_error('Invalid key (i4)')
    end select
 
  end function htable_iter_i4_key
 
  !
  ! Integer*8 based implementation
  !
  subroutine htable_i8_init(this, size, data)
    class(htable_i8_t), intent(inout) :: this
    integer, value :: size
    class(*), intent(inout), optional :: data
    integer(kind=i8) :: key
 
    if (present(data)) then
       call htable_init(this, size, key, data)
    else
       call htable_init(this, size, key)
    end if
 
  end subroutine htable_i8_init
 
  subroutine htable_i8_set(this, key, data)
    class(htable_i8_t), intent(inout) :: this
    integer(kind=i8), intent(inout) :: key
    class(*), intent(inout) :: data
 
    call htable_set(this, key, data)
 
  end subroutine htable_i8_set
 
  function htable_i8_get(this, key, data) result(rcode)
    class(htable_i8_t), intent(inout) :: this
    integer(kind=i8), intent(inout) :: key
    class(*), intent(inout) :: data
    integer :: rcode
 
    rcode = htable_get(this, key, data)
 
  end function htable_i8_get
 
  pure function htable_i8_hash(this, k, c) result(hash)
    class(htable_i8_t), intent(in) :: this
    class(*), intent(in) :: k
    integer, value :: c
    integer :: hash
    integer(kind=i8) :: tmp
    integer(kind=i8), parameter :: m1 = int(z'7ed55d15', i8)
    integer(kind=i8), parameter :: m2 = int(z'c761c23c', i8)
    integer(kind=i8), parameter :: m3 = int(z'165667b1', i8)
    integer(kind=i8), parameter :: m4 = int(z'd3a2646c', i8)
    integer(kind=i8), parameter :: m5 = int(z'fd7046c5', i8)
    integer(kind=i8), parameter :: m6 = int(z'b55a4f09', i8)
 
    select type(k)
    type is (integer(i8))
       tmp = (k + m1) + ishft(k, 12)
       tmp = ieor(ieor(tmp, m2), ishft(tmp, -19))
       tmp = (tmp + m3) + ishft(tmp, 5)
       tmp = ieor((tmp + m4), ishft(tmp, 9))
       tmp = (tmp + m5) + ishft(tmp, 3)
       tmp = ieor(ieor(tmp, m6), ishft(tmp, -16))
       hash = int(modulo(tmp, int(this%size, i8)), i4)
       hash = int(modulo((k * 2654435761_i8) + int(c, i8), &
            int(this%size, i8)), i4)
    class default
       hash = -1
    end select
  end function htable_i8_hash
 
  subroutine htable_i8_remove(this, key)
    class(htable_i8_t), intent(inout) :: this
    integer(kind=i8), intent(inout) :: key
 
    call htable_remove(this, key)
 
  end subroutine htable_i8_remove
 
  subroutine htable_iter_i8_init(this, t)
    class(htable_iter_i8_t), intent(inout) :: this
    type(htable_i8_t), target, intent(inout) :: t
 
    this%t => t
 
  end subroutine htable_iter_i8_init
 
  subroutine htable_iter_i8_free(this)
    type(htable_iter_i8_t), intent(inout) :: this
    nullify(this%t)
    nullify(this%current)
  end subroutine htable_iter_i8_free
 
  function htable_iter_i8_value(this) result(value)
    class(htable_iter_i8_t), target, intent(inout) :: this
    integer(kind=i8), pointer :: value
 
    select type (hdp => this%current%data)
    type is (integer(i8))
       value => hdp
    class default
       call neko_error('Key and data of different kind (i8)')
    end select
 
  end function htable_iter_i8_value
 
  function htable_iter_i8_key(this) result(key)
    class(htable_iter_i8_t), target, intent(inout) :: this
    integer(kind=i8), pointer :: key
 
    ! We should not need this extra select block, and it works great
    ! without it for GNU, Intel and NEC, but breaks horribly on Cray
    ! (>11.0.x) when using high opt. levels.
    select type(hti => this)
    type is(htable_iter_i8_t)
       select type (kp => hti%current%key)
       type is (integer(i8))
          key => kp
       class default
          call neko_error('Invalid key (i8)')
       end select
    class default
       call neko_error('Corrupt htable iter. (i8)')
    end select
 
  end function htable_iter_i8_key
 
 
  !
  ! Double precision based implementation
  !
  subroutine htable_r8_init(this, size, data)
    class(htable_r8_t), intent(inout) :: this
    integer, value :: size
    class(*), intent(inout), optional :: data
    real(kind=dp) :: key
 
    if (present(data)) then
       call htable_init(this, size, key, data)
    else
       call htable_init(this, size, key)
    end if
 
  end subroutine htable_r8_init
 
  subroutine htable_r8_set(this, key, data)
    class(htable_r8_t), intent(inout) :: this
    real(kind=dp), intent(inout) :: key 
    class(*), intent(inout) :: data
 
    call htable_set(this, key, data)
 
  end subroutine htable_r8_set
 
  function htable_r8_get(this, key, data) result(rcode)
    class(htable_r8_t), intent(inout) :: this
    real(kind=dp), intent(inout) :: key 
    class(*), intent(inout) :: data
    integer :: rcode
 
    rcode = htable_get(this, key, data)
 
  end function htable_r8_get
 
  pure function htable_r8_hash(this, k, c) result(hash)
    class(htable_r8_t), intent(in) :: this
    class(*), intent(in) :: k
    integer, value :: c
    integer :: hash
    select type(k)
    type is (double precision)
       hash = modulo(floor((2d0 * abs(fraction(k)) - 1d0) * 2**16) + c, &
            this%size)
    class default
       hash = -1
    end select
  end function htable_r8_hash
 
  subroutine htable_r8_remove(this, key)
    class(htable_r8_t), intent(inout) :: this
    real(kind=dp), intent(inout) :: key 
 
    call htable_remove(this, key)
 
  end subroutine htable_r8_remove
 
 
  subroutine htable_iter_r8_init(this, t)
    class(htable_iter_r8_t), intent(inout) :: this
    type(htable_r8_t), target, intent(inout) :: t
 
    this%t => t
 
  end subroutine htable_iter_r8_init
 
  subroutine htable_iter_r8_free(this)
    type(htable_iter_r8_t), intent(inout) :: this
    nullify(this%t)
    nullify(this%current)
  end subroutine htable_iter_r8_free
 
  function htable_iter_r8_value(this) result(value)
    class(htable_iter_r8_t), target, intent(inout) :: this
    real(kind=dp), pointer :: value
 
    select type (hdp => this%current%data)
    type is (double precision)
       value => hdp
    class default
       call neko_error('Key and data of different kind (r8)')
    end select
 
  end function htable_iter_r8_value
 
  function htable_iter_r8_key(this) result(key)
    class(htable_iter_r8_t), target, intent(inout) :: this
    real(kind=dp), pointer :: key
 
    select type (kp => this%current%key)
    type is (double precision)
       key => kp
    class default
       call neko_error('Invalid key (r8)')
    end select
 
  end function htable_iter_r8_key
 
  !
  ! Point based implementation
  !
  subroutine htable_pt_init(this, size, data)
    class(htable_pt_t), intent(inout) :: this
    integer, value :: size
    class(*), intent(inout), optional :: data
    type(point_t) :: key
 
    if (present(data)) then
       call htable_init(this, size, key, data)
    else
       call htable_init(this, size, key)
    end if
 
  end subroutine htable_pt_init
 
  subroutine htable_pt_set(this, key, data)
    class(htable_pt_t), intent(inout) :: this
    type(point_t), intent(inout) :: key
    class(*), intent(inout) :: data
 
    call htable_set(this, key, data)
 
  end subroutine htable_pt_set
 
  function htable_pt_get(this, key, data) result(rcode)
    class(htable_pt_t), intent(inout) :: this
    type(point_t), intent(inout) :: key
    class(*), intent(inout) :: data
    integer :: rcode
 
    rcode = htable_get(this, key, data)
 
  end function htable_pt_get
 
  pure function htable_pt_hash(this, k, c) result(hash)
    class(htable_pt_t), intent(in) :: this
    class(*), intent(in) :: k
    integer, value :: c
    integer :: hash, i
    integer(kind=i8) :: hash2, tmp, mult
    integer(kind=i8), parameter :: m1 = int(z'7ed55d15', i8)
    integer(kind=i8), parameter :: m2 = int(z'c761c23c', i8)
    integer(kind=i8), parameter :: m3 = int(z'165667b1', i8)
    integer(kind=i8), parameter :: m4 = int(z'd3a2646c', i8)
    integer(kind=i8), parameter :: m5 = int(z'fd7046c5', i8)
    integer(kind=i8), parameter :: m6 = int(z'b55a4f09', i8)
 
    select type(k)
    type is (point_t)
       mult = 1000003
       hash2 = int(z'345678')
       do i = 1, 3
          tmp = transfer(k%x(i), tmp)
          tmp = (tmp + m1) + ishft(tmp, 12)
          tmp = ieor(ieor(tmp, m2), ishft(tmp, -19))
          tmp = (tmp + m3) + ishft(tmp, 5)
          tmp = ieor((tmp + m4), ishft(tmp, 9))
          tmp = (tmp + m5) + ishft(tmp, 3)
          tmp = ieor(ieor(tmp, m6), ishft(tmp, -16))
          hash2 = ieor(hash2, tmp) * mult
          mult = mult + 82520 + 8
       end do
       hash2 = hash2 + 97531
       hash2 = modulo(hash2 + int(c, i8), int(this%size,i8))
       hash = int(hash2, i4)
    class default
       hash = -1
    end select
 
  end function htable_pt_hash
 
  subroutine htable_pt_remove(this, key)
    class(htable_pt_t), intent(inout) :: this
    type(point_t), intent(inout) :: key
 
    call htable_remove(this, key)
 
  end subroutine htable_pt_remove
 
 
  subroutine htable_iter_pt_init(this, t)
    class(htable_iter_pt_t), intent(inout) :: this
    type(htable_pt_t), target, intent(inout) :: t
 
    this%t => t
 
  end subroutine htable_iter_pt_init
 
  subroutine htable_iter_pt_free(this)
    type(htable_iter_pt_t), intent(inout) :: this
    nullify(this%t)
    nullify(this%current)
  end subroutine htable_iter_pt_free
 
  function htable_iter_pt_value(this) result(value)
    class(htable_iter_pt_t), target, intent(inout) :: this
    type(point_t), pointer :: value
 
    select type (hdp => this%current%data)
    type is (point_t)
       value => hdp
    class default
       call neko_error('Key and data of different kind (pt)')
    end select
 
  end function htable_iter_pt_value
 
  function htable_iter_pt_key(this) result(key)
    class(htable_iter_pt_t), target, intent(inout) :: this
    type(point_t), pointer :: key
 
    select type (kp => this%current%key)
    type is (point_t)
       key => kp
    class default
       call neko_error('Invalid key (pt)')
    end select
 
  end function htable_iter_pt_key
 
  !
  ! Integer 2-tuple based implementation
  !
  subroutine htable_i4t2_init(this, size, data)
    class(htable_i4t2_t), intent(inout) :: this
    integer, value :: size
    class(*), intent(inout), optional :: data
    type(tuple_i4_t) :: key
 
    if (present(data)) then
       call htable_init(this, size, key, data)
    else
       call htable_init(this, size, key)
    end if
 
  end subroutine htable_i4t2_init
 
  subroutine htable_i4t2_set(this, key, data)
    class(htable_i4t2_t), intent(inout) :: this
    type(tuple_i4_t), intent(inout) :: key
    class(*), intent(inout) :: data
 
    call htable_set(this, key, data)
 
  end subroutine htable_i4t2_set
 
  function htable_i4t2_get(this, key, data) result(rcode)
    class(htable_i4t2_t), intent(inout) :: this
    type(tuple_i4_t), intent(inout) :: key
    class(*), intent(inout) :: data
    integer :: rcode
 
    rcode = htable_get(this, key, data)
 
  end function htable_i4t2_get
 
  pure function htable_i4t2_hash(this, k, c) result(hash)
    class(htable_i4t2_t), intent(in) :: this
    class(*), intent(in) :: k
    integer, value :: c
    integer :: i, hash
    integer(kind=i8) :: tmp, hash2, mult
    integer(kind=i8), parameter :: m1 = int(z'7ed55d15', i8)
    integer(kind=i8), parameter :: m2 = int(z'c761c23c', i8)
    integer(kind=i8), parameter :: m3 = int(z'165667b1', i8)
    integer(kind=i8), parameter :: m4 = int(z'd3a2646c', i8)
    integer(kind=i8), parameter :: m5 = int(z'fd7046c5', i8)
    integer(kind=i8), parameter :: m6 = int(z'b55a4f09', i8)
 
    select type(k)
    type is (tuple_i4_t)
       mult = int(1000003, i8)
       hash2 = int(z'345678', i8)
       do i = 1, 2
          tmp = int(k%x(i), i8)
          tmp = (tmp + m1) + ishft(tmp, 12)
          tmp = ieor(ieor(tmp, m2), ishft(tmp, -19))
          tmp = (tmp + m3) + ishft(tmp, 5)
          tmp = ieor((tmp + m4), ishft(tmp, 9))
          tmp = (tmp + m5) + ishft(tmp, 3)
          tmp = ieor(ieor(tmp, m6), ishft(tmp, -16))
          hash2 = ieor(hash2, tmp) * mult
          mult = mult + 82520_i8 + 4_i8
       end do
       hash2 = hash2 + 97531_i8
       hash2 = modulo(hash2 + int(c, i8), int(this%size, i8))
       hash = int(hash2, i4)
    class default
       hash = -1
    end select
  end function htable_i4t2_hash
 
  subroutine htable_i4t2_remove(this, key)
    class(htable_i4t2_t), intent(inout) :: this
    type(tuple_i4_t), intent(inout) :: key
 
    call htable_remove(this, key)
 
  end subroutine htable_i4t2_remove
 
  subroutine htable_iter_i4t2_init(this, t)
    class(htable_iter_i4t2_t), intent(inout) :: this
    type(htable_i4t2_t), target, intent(inout) :: t
 
    this%t => t
 
  end subroutine htable_iter_i4t2_init
 
  subroutine htable_iter_i4t2_free(this)
    type(htable_iter_i4t2_t), intent(inout) :: this
    nullify(this%t)
    nullify(this%current)
  end subroutine htable_iter_i4t2_free
 
  function htable_iter_i4t2_value(this) result(value)
    class(htable_iter_i4t2_t), intent(inout) :: this
    type(tuple_i4_t), pointer :: value
 
    select type (hdp => this%current%data)
    type is (tuple_i4_t)
       value => hdp
    class default
       call neko_error('Key and data of different kind (i4t2)')
    end select
 
  end function htable_iter_i4t2_value
 
  function htable_iter_i4t2_key(this) result(key)
    class(htable_iter_i4t2_t), intent(inout) :: this
    type(tuple_i4_t), pointer :: key
 
    select type (kp => this%current%key)
    type is (tuple_i4_t)
       key => kp
    class default
       call neko_error('Invalid key (i4t2)')
    end select
 
  end function htable_iter_i4t2_key
 
  !
  ! Integer 4-tuple based implementation
  !
  subroutine htable_i4t4_init(this, size, data)
    class(htable_i4t4_t), intent(inout) :: this
    integer, value :: size
    class(*), intent(inout), optional :: data
    type(tuple4_i4_t) :: key
 
    if (present(data)) then
       call htable_init(this, size, key, data)
    else
       call htable_init(this, size, key)
    end if
 
  end subroutine htable_i4t4_init
 
  subroutine htable_i4t4_set(this, key, data)
    class(htable_i4t4_t), intent(inout) :: this
    type(tuple4_i4_t), intent(inout) :: key
    class(*), intent(inout) :: data
 
    call htable_set(this, key, data)
 
  end subroutine htable_i4t4_set
 
  function htable_i4t4_get(this, key, data) result(rcode)
    class(htable_i4t4_t), intent(inout) :: this
    type(tuple4_i4_t), intent(inout) :: key
    class(*), intent(inout) :: data
    integer :: rcode
 
    rcode = htable_get(this, key, data)
 
  end function htable_i4t4_get
 
  pure function htable_i4t4_hash(this, k, c) result(hash)
    class(htable_i4t4_t), intent(in) :: this
    class(*), intent(in) :: k
    integer, value :: c
    integer :: i, hash
    integer(kind=i8) :: tmp, hash2, mult
    integer(kind=i8), parameter :: m1 = int(z'7ed55d15', i8)
    integer(kind=i8), parameter :: m2 = int(z'c761c23c', i8)
    integer(kind=i8), parameter :: m3 = int(z'165667b1', i8)
    integer(kind=i8), parameter :: m4 = int(z'd3a2646c', i8)
    integer(kind=i8), parameter :: m5 = int(z'fd7046c5', i8)
    integer(kind=i8), parameter :: m6 = int(z'b55a4f09', i8)
 
    select type(k)
    type is (tuple4_i4_t)
       mult = int(1000003, i8)
       hash2 = int(z'345678', i8)
       do i = 1, 4
          tmp = int(k%x(i), i8)
          tmp = (tmp + m1) + ishft(tmp, 12)
          tmp = ieor(ieor(tmp, m2), ishft(tmp, -19))
          tmp = (tmp + m3) + ishft(tmp, 5)
          tmp = ieor((tmp + m4), ishft(tmp, 9))
          tmp = (tmp + m5) + ishft(tmp, 3)
          tmp = ieor(ieor(tmp, m6), ishft(tmp, -16))
          hash2 = ieor(hash2, tmp) * mult
          mult = mult + 82520_i8 + 8_i8
       end do
       hash2 = hash2 + 97531_i8
       hash2 = modulo(hash2 + int(c, i8), int(this%size, i8))
       hash = int(hash2, i4)
    class default
       hash = -1
    end select
  end function htable_i4t4_hash
 
  subroutine htable_i4t4_remove(this, key)
    class(htable_i4t4_t), intent(inout) :: this
    type(tuple4_i4_t), intent(inout) :: key
 
    call htable_remove(this, key)
 
  end subroutine htable_i4t4_remove
 
  subroutine htable_iter_i4t4_init(this, t)
    class(htable_iter_i4t4_t), intent(inout) :: this
    type(htable_i4t4_t), target, intent(inout) :: t
 
    this%t => t
 
  end subroutine htable_iter_i4t4_init
 
  subroutine htable_iter_i4t4_free(this)
    type(htable_iter_i4t4_t), intent(inout) :: this
    nullify(this%t)
    nullify(this%current)
  end subroutine htable_iter_i4t4_free
 
  function htable_iter_i4t4_value(this) result(value)
    class(htable_iter_i4t4_t), target, intent(inout) :: this
    type(tuple4_i4_t), pointer :: value
 
    select type (hdp => this%current%data)
    type is (tuple4_i4_t)
       value => hdp
    class default
       call neko_error('Key and data of different kind (i4t4)')
    end select
 
  end function htable_iter_i4t4_value
 
  function htable_iter_i4t4_key(this) result(key)
    class(htable_iter_i4t4_t), target, intent(inout) :: this
    type(tuple4_i4_t), pointer :: key
 
    ! We should not need this extra select block, and it works great
    ! without it for GNU, Intel and NEC, but breaks horribly on Cray
    ! (>11.0.x) when using high opt. levels.
    select type(hti => this)
    type is(htable_iter_i4t4_t)
       select type (kp => hti%current%key)
       type is (tuple4_i4_t)
          key => kp
       class default
          call neko_error('Invalid key (i4t4)')
       end select
    class default
       call neko_error('Corrupt htable iter. (i4t4)')
    end select
 
  end function htable_iter_i4t4_key
 
  !
  ! C pointer based implementation
  !
  subroutine htable_cptr_init(this, size, data)
    class(htable_cptr_t), intent(inout) :: this
    integer, value :: size
    class(*), intent(inout), optional :: data
    type(h_cptr_t) :: key
 
    if (present(data)) then
       call htable_init(this, size, key, data)
    else
       call htable_init(this, size, key)
    end if
 
  end subroutine htable_cptr_init
 
  subroutine htable_cptr_set(this, key, data)
    class(htable_cptr_t), target, intent(inout) :: this
    type(h_cptr_t), intent(inout) :: key
    class(*), intent(inout) :: data
 
    call htable_set(this, key, data)
 
  end subroutine htable_cptr_set
 
  function htable_cptr_get(this, key, data) result(rcode)
    class(htable_cptr_t), target, intent(inout) :: this
    type(h_cptr_t), intent(inout) :: key
    class(*), intent(inout) :: data
    integer :: rcode
 
    rcode = htable_get(this, key, data)
 
  end function htable_cptr_get
 
  pure function htable_cptr_hash(this, k, c) result(hash)
    class(htable_cptr_t), intent(in) :: this
    class(*), intent(in) :: k
    integer, value :: c
    integer :: hash
    integer(kind=i8) :: k_int
 
    select type(k)
    type is (h_cptr_t)
       k_int = transfer(k%ptr, k_int)
       hash = int(modulo(k_int * 2654435761_i8 + int(c, i8),&
            int(this%size, i8)), i4)
    class default
       hash = -1
    end select
  end function htable_cptr_hash
 
  subroutine htable_cptr_remove(this, key)
    class(htable_cptr_t), target, intent(inout) :: this
    type(h_cptr_t), intent(inout) :: key
 
    call htable_remove(this, key)
 
  end subroutine htable_cptr_remove
 
  subroutine htable_iter_cptr_init(this, t)
    class(htable_iter_cptr_t), intent(inout) :: this
    type(htable_cptr_t), target, intent(inout) :: t
 
    this%t => t
 
  end subroutine htable_iter_cptr_init
 
  subroutine htable_iter_cptr_free(this)
    type(htable_iter_cptr_t), intent(inout) :: this
    nullify(this%t)
    nullify(this%current)
  end subroutine htable_iter_cptr_free
 
  function htable_iter_cptr_value(this) result(value)
    class(htable_iter_cptr_t), target, intent(inout) :: this
    class(*), pointer :: hdp
    type(h_cptr_t), pointer :: value
 
    hdp => this%current%data
    select type (hdp)
    type is (h_cptr_t)
       value => hdp
    class default
       call neko_error('Key and data of different kind (cptr)')
    end select
 
  end function htable_iter_cptr_value
 
  function htable_iter_cptr_key(this) result(key)
    class(htable_iter_cptr_t), target, intent(inout) :: this
    class(*), pointer :: kp
    type(h_cptr_t), pointer :: key
 
    kp => this%current%key
    select type (kp)
    type is (h_cptr_t)
       key => kp
    class default
       call neko_error('Invalid key (cptr)')
    end select
 
  end function htable_iter_cptr_key
 
end module htable