skiplistmap

package module
v0.1.1 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Nov 28, 2021 License: MIT Imports: 9 Imported by: 0

README

Skip List Map in Golang

Skip List Map is an ordered and concurrent map. this Map is gourtine safety for reading/updating/deleting, require locking and coordination. This

features

  • buckets, elemenete(key/value item) structure is concurrent embeded-linked list.
  • keep key order by hash function.
  • ability to store value ( value of key/vale) and elemet of ket/value item(detail is later)
  • improve performance for sync.Map/ internal map in write heavy environment.

require mennt

golang >= 1.17

install

Install this package through go get.

go get "github.com/kazu/skiplistmap"

basic usage

package main 

import (
    "fmt"
)

//create skip list map
sMap := skiplistmap.New()
// create make with configure MaxPerBucket
// sMap := skiplistmap.New(skiplistmap.MaxPefBucket(12))
// sMap := skiplistmap.New(skiplistmap.MaxPefBucket(12))

// Set/Add values
sMap.Set("test1", 1)
sMap.Set("test2", 2)

// get the value for a key, return nil if not found, the ok is found.
inf, ok := sMap.Get("test1)
var value1 int
if ok {
    value1 = inf.(int)
}

ok = sMap.GetByFn(func(v interface{}) {
    value = v.(int)
})


// if directry using key/value item. use SampleItem struct
sMap2 := skiplistmap.New(skiplistmap.MaxPefBucket(12))
item := &skiplistmap.SampleItem{
    K: "test1", 
    V: 1234
}

// store item
ok = sMap2.StoreItem(item)

// get key/value item
item, ok = sMap.LoadItem("test1")
// get next key/value
nItem := sMap.Next()


// delete marking. set nil as value.
sMap.Delete("test2")

// delete key/value entry from map. traverse locked for deleting item to acceess concurrent
sMap.Purge("test2")

Documentation

Overview

Package loncha/list_head is like a kernel's LIST_HEAD list_head is used by loncha/gen/containers_list

Package skitlistmap is concurrent map implementatin

Index

Constants

View Source 
const (
	LenearSearchForBucket SearchMode = 0
	ReversSearchForBucket            = 1
	NestedSearchForBucket            = 2
	CombineSearch                    = 3
	CombineSearch2                   = 4

	NoItemSearchForBucket = 9 // test mode
	FalsesSearchForBucket = 10
)
View Source 
const (
	CntSearchBucket  statKey = 1
	CntLevelBucket   statKey = 2
	CntSearchEntry   statKey = 3
	CntReverseSearch statKey = 4
	CntOfGet         statKey = 5
)

Variables

View Source 
var DebugStats map[statKey]int = map[statKey]int{}
View Source 
var (
	EmptyEntryHMap *entryHMap = emptyEntryHMap
)
View Source 
var EnableStats bool = false
View Source 
var Failreverse uint64 = 0

Functions

func FindBucketWithLevel 

func FindBucketWithLevel(chead *list_head.ListHead, reverse uint64, level int) *bucket

func FindBucketWithLevel2 

func FindBucketWithLevel2(chead *list_head.ListHead, reverse uint64, level int) *bucket

func KeyToHash 

func KeyToHash(key interface{}) (uint64, uint64)

func MemHash 

func MemHash(data []byte) uint64

func MemHashString 

func MemHashString(str string) uint64

func NewEntryMap 

func NewEntryMap(key, value interface{}) *entryHMap

func WithBucket 

func WithBucket(b *bucket) func(*hmapMethod)

Types

type CondOfFinder 

type CondOfFinder func(ehead *entryHMap) bool

func CondOfFind 

func CondOfFind(reverse uint64, l sync.Locker) CondOfFinder

type HMapEntry 

type HMapEntry interface {
	Offset() uintptr
	PtrMapHead() *MapHead
	PtrListHead() *list_head.ListHead
	HmapEntryFromListHead(*list_head.ListHead) HMapEntry
	Next() HMapEntry
	Prev() HMapEntry
}

type HMethodOpt 

type HMethodOpt func(*hmapMethod)

type LevelHead 

type LevelHead list_head.ListHead

type Map 

type Map struct {
	ItemFn func() MapItem
	// contains filtered or unexported fields
}

Map ... Skip List Map is an ordered and concurrent map. this Map is gourtine safety for reading/updating/deleting, require locking and coordination. This

func New 

func New(opts ...OptHMap) *Map

func NewHMap 

func NewHMap(opts ...OptHMap) *Map

func (*Map) ActiveLevels 

func (h *Map) ActiveLevels() (result []int)

func (*Map) Delete 

func (h *Map) Delete(key interface{})

Delete ... set nil to the key of MapItem. cannot Get entry

func (*Map) DumpBucket 

func (h *Map) DumpBucket() string

func (*Map) DumpBucketPerLevel 

func (h *Map) DumpBucketPerLevel() string

func (*Map) DumpEntry 

func (h *Map) DumpEntry() string

func (*Map) Get 

func (h *Map) Get(key interface{}) (value interface{}, ok bool)

Get ... return the value for a key, if not found, ok is false

func (*Map) GetWithFn 

func (h *Map) GetWithFn(key interface{}, onSuccess func(interface{})) bool

GetWithFn ... Get with succes function.

func (*Map) LoadItem 

func (h *Map) LoadItem(key interface{}) (MapItem, bool)

LoadItem ... return key/value item with embedded-linked-list. if not found, ok is false

func (*Map) MakeBucket 

func (h *Map) MakeBucket(ocur *list_head.ListHead, back int)

func (*Map) Options 

func (h *Map) Options(opts ...OptHMap) (previouses []OptHMap)

func (*Map) SearchKey 

func (h *Map) SearchKey(k uint64, opts ...searchArg) HMapEntry

func (*Map) Set 

func (h *Map) Set(key, value interface{}) bool

Set ... set the value for a key

func (*Map) StoreItem 

func (h *Map) StoreItem(item MapItem) bool

StoreItem ... set key/value item with embedded-linked-list

type MapHead 

type MapHead struct {
	list_head.ListHead
	// contains filtered or unexported fields
}
var EmptyMapHead MapHead = MapHead{}

func (*MapHead) ConflictInHamp 

func (mh *MapHead) ConflictInHamp() uint64

func (*MapHead) FromListHead 

func (c *MapHead) FromListHead(l *list_head.ListHead) list_head.List

func (*MapHead) KeyInHmap 

func (mh *MapHead) KeyInHmap() uint64

func (*MapHead) Offset 

func (mh *MapHead) Offset() uintptr

func (*MapHead) PtrListHead 

func (mh *MapHead) PtrListHead() *list_head.ListHead

type MapItem 

type MapItem interface {
	Key() interface{}   // require order for HMap
	Value() interface{} // require order for HMap
	SetValue(interface{}) bool
	Delete()

	HMapEntry
}

type OptHMap 

type OptHMap func(*Map) OptHMap

func BucketMode 

func BucketMode(mode SearchMode) OptHMap

func ItemFn 

func ItemFn(fn func() MapItem) OptHMap

func MaxPefBucket 

func MaxPefBucket(max int) OptHMap

type SampleItem 

type SampleItem struct {
	K interface{}
	V interface{}
	MapHead
}
var EmptySampleHMapEntry SampleItem = SampleItem{}

func SampleItemFromListHead 

func SampleItemFromListHead(head *list_head.ListHead) *SampleItem

func (*SampleItem) Delete 

func (s *SampleItem) Delete()

func (*SampleItem) HmapEntryFromListHead 

func (s *SampleItem) HmapEntryFromListHead(lhead *list_head.ListHead) HMapEntry

func (*SampleItem) Key 

func (s *SampleItem) Key() interface{}

func (*SampleItem) Next 

func (s *SampleItem) Next() HMapEntry

func (*SampleItem) Offset 

func (s *SampleItem) Offset() uintptr

func (*SampleItem) Prev 

func (s *SampleItem) Prev() HMapEntry

func (*SampleItem) PtrMapHead 

func (s *SampleItem) PtrMapHead() *MapHead

func (*SampleItem) PtrMapeHead 

func (s *SampleItem) PtrMapeHead() *MapHead

func (*SampleItem) SetValue 

func (s *SampleItem) SetValue(v interface{}) bool

func (*SampleItem) Value 

func (s *SampleItem) Value() interface{}

type SearchMode 

type SearchMode byte

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.