Skip to content

Commit 95bed1d

Browse files
committed
add links in stdlib_hashmaps
1 parent fa71f36 commit 95bed1d

File tree

1 file changed

+24
-2
lines changed

1 file changed

+24
-2
lines changed

src/stdlib_hashmaps.f90

Lines changed: 24 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,7 @@ module stdlib_hashmaps
7070
!! Version: Experimental
7171
!!
7272
!! Type implementing an abstract hash map
73+
!! ([Specifications](../page/specs/stdlib_hashmaps.html#the-hashmap_type-abstract-type))
7374
private
7475
integer(int_calls) :: call_count = 0
7576
!! Number of calls
@@ -158,6 +159,8 @@ subroutine key_test(map, key, present)
158159
!! Version: Experimental
159160
!!
160161
!! Returns a logical flag indicating whether KEY exists in the hash map
162+
!! ([Specifications](../page/specs/stdlib_hashmaps.html#key_test-indicates-whether-key-is-present))
163+
!!
161164
!! Arguments:
162165
!! map - the hash map of interest
163166
!! key - the key of interest
@@ -173,6 +176,8 @@ pure function loading( map )
173176
!! Version: Experimental
174177
!!
175178
!! Returns the number of entries relative to slots in a hash map
179+
!! ([Specifications](../page/specs/stdlib_hashmaps.html#loading-returns-the-ratio-of-entries-to-slots))
180+
!!
176181
!! Arguments:
177182
!! map - a hash map
178183
import hashmap_type
@@ -184,8 +189,8 @@ subroutine map_entry(map, key, other, conflict)
184189
!! Version: Experimental
185190
!!
186191
!! Inserts an entry into the hash table
187-
!! Arguments:
188-
!
192+
!! ([Specifications](../page/specs/stdlib_hashmaps.html#map_entry-inserts-an-entry-into-the-hash-map))
193+
!!
189194
import hashmap_type, key_type, other_type
190195
class(hashmap_type), intent(inout) :: map
191196
type(key_type), intent(in) :: key
@@ -246,6 +251,7 @@ function total_depth( map )
246251
!!
247252
!! Returns the total number of ones based offsets of slot entriesyy from
248253
!! their slot index for a hash map
254+
!! ([Specifications](../page/specs/stdlib_hashmaps.html#total_depth-returns-the-total-depth-of-the-hash-map-entries))
249255
!! Arguments:
250256
!! map - a hash map
251257
import hashmap_type, int64
@@ -261,6 +267,7 @@ end function total_depth
261267
!! Version: Experimental
262268
!!
263269
!! Chaining hash map entry type
270+
!! ([Specifications](../page/specs/stdlib_hashmaps.html#the-chaining_map_entry_type-derived-type))
264271
private
265272
integer(int_hash) :: hash_val
266273
!! Full hash value
@@ -279,6 +286,7 @@ end function total_depth
279286
!! Version: Experimental
280287
!!
281288
!! Wrapper for a pointer to a chaining map entry type object
289+
!! ([Specifications](../page/specs/stdlib_hashmaps.html#the-chaining_map_entry_type_ptr-derived-type))
282290
type(chaining_map_entry_type), pointer :: target => null()
283291
end type chaining_map_entry_ptr
284292

@@ -287,6 +295,7 @@ end function total_depth
287295
!! Version: Experimental
288296
!!
289297
!! Type implementing a pool of allocated `chaining_map_entry_type`
298+
!! ([Specifications](../page/specs/stdlib_hashmaps.html#the-chaining_map_entry_pool-derived-type))
290299
private
291300
! Index of next bucket
292301
integer(int_index) :: next = 0
@@ -299,6 +308,7 @@ end function total_depth
299308
!! Version: Experimental
300309
!!
301310
!! Type implementing the `chaining_hashmap_type` types
311+
!! ([Specifications](../page/specs/stdlib_hashmaps.html#the-chaining_hashmap_type-derived-type))
302312
private
303313
type(chaining_map_entry_pool), pointer :: cache => null()
304314
!! Pool of allocated chaining_map_entry_type objects
@@ -487,6 +497,7 @@ end function total_chaining_depth
487497
!! Version: Experimental
488498
!!
489499
!! Open hash map entry type
500+
!! ([Specifications](../page/specs/stdlib_hashmaps.html#the-open_map_entry_type-derived-type))
490501
private
491502
integer(int_hash) :: hash_val
492503
!! Full hash value
@@ -512,6 +523,7 @@ end function total_chaining_depth
512523
!! Version: Experimental
513524
!!
514525
!! Wrapper for a pointer to an open hash map entry type object
526+
!! ([Specifications](../page/specs/stdlib_hashmaps.html#the-open_map_entry_ptr-derived-type))
515527
type(open_map_entry_type), pointer :: target => null()
516528
end type open_map_entry_ptr
517529

@@ -720,6 +732,8 @@ pure function calls( map )
720732
!! Version: Experimental
721733
!!
722734
!! Returns the number of subroutine calls on an open hash map
735+
!! ([Specifications](../page/specs/stdlib_hashmaps.html#calls-returns-the-number-of-calls-on-the-hash-map))
736+
!!
723737
!! Arguments:
724738
!! map - an open hash map
725739
class(hashmap_type), intent(in) :: map
@@ -733,6 +747,8 @@ pure function entries( map )
733747
!! Version: Experimental
734748
!!
735749
!! Returns the number of entries in a hash map
750+
!! ([Specifications](../page/specs/stdlib_hashmaps.html#entries-returns-the-number-of-entries-in-the-hash-map))
751+
!!
736752
!! Arguments:
737753
!! map - an open hash map
738754
class(hashmap_type), intent(in) :: map
@@ -747,6 +763,8 @@ pure function map_probes( map )
747763
!! Version: Experimental
748764
!!
749765
!! Returns the total number of table probes on a hash map
766+
!! ([Specifications](../page/specs/stdlib_hashmaps.html#map_probes-returns-the-number-of-hash-map-probes))
767+
!!
750768
!! Arguments:
751769
!! map - an open hash map
752770
class(hashmap_type), intent(in) :: map
@@ -761,6 +779,8 @@ pure function num_slots( map )
761779
!! Version: Experimental
762780
!!
763781
!! Returns the number of allocated slots in a hash map
782+
!! ([Specifications](../page/specs/stdlib_hashmaps.html#num_slots-returns-the-number-of-hash-map-slots))
783+
!!
764784
!! Arguments:
765785
!! map - an open hash map
766786
class(hashmap_type), intent(in) :: map
@@ -776,6 +796,8 @@ pure function slots_bits( map )
776796
!!
777797
!! Returns the number of bits used to specify the number of allocated
778798
!! slots in a hash map
799+
!! ([Specifications](../page/specs/stdlib_hashmaps.html#slots_bits-returns-the-number-of-bits-used-to-address-the-hash-map-slots))
800+
!!
779801
!! Arguments:
780802
!! map - an open hash map
781803
class(hashmap_type), intent(in) :: map

0 commit comments

Comments
 (0)