buffer

Documentation

Overview

Package buffer provides an implementation of an unbounded buffer.

Index

• type Unbounded
  • func NewUnbounded() *Unbounded
  • func (b *Unbounded) Get() <-chan interface{}
  • func (b *Unbounded) Load()
  • func (b *Unbounded) Put(t interface{})

Types

type Unbounded

type Unbounded struct {
	// contains filtered or unexported fields
}

Unbounded is an implementation of an unbounded buffer which does not use extra goroutines. This is typically used for passing updates from one entity to another within gRPC.

All methods on this type are thread-safe and don't block on anything except the underlying mutex used for synchronization.

func NewUnbounded

func NewUnbounded() *Unbounded

NewUnbounded returns a new instance of Unbounded.

func (*Unbounded) Get

func (b *Unbounded) Get() <-chan interface{}

Get returns a read channel on which values added to the buffer, via Put(), are sent on.

Upon reading a value from this channel, users are expected to call Load() to send the next buffered value onto the channel if there is any.

func (*Unbounded) Load

func (b *Unbounded) Load()

Load sends the earliest buffered data, if any, onto the read channel returned by Get(). Users are expected to call this every time they read a value from the read channel.

func (*Unbounded) Put

func (b *Unbounded) Put(t interface{})

Put adds t to the unbounded buffer.