context

Documentation

Overview

Packaage context provides a Context type to propagate state and cancellation information.

Index

• Variables
• type Context
  • func New() *Context
  • func TODO() *Context
  • func (c *Context) Cancel()
  • func (c *Context) Done() <-chan struct{}
  • func (c *Context) New() *Context

Variables

var ErrCanceled = errors.New("canceled")

ErrCanceled may be returned by code when it receives from a Context.Done channel.

Types

type Context

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

A Context is carries state and cancellation information between calls. A nil Context pointer is valid, for now.

func New

func New() *Context

func TODO

func TODO() *Context

TODO returns a dummy context. It's a signal that the caller code is not yet correct, and needs its own context to propagate.

func (*Context) Cancel

func (c *Context) Cancel()

func (*Context) Done

func (c *Context) Done() <-chan struct{}

Done returns a channel that is closed when the Context is cancelled or finished.

func (*Context) New

func (c *Context) New() *Context

New returns a child context attached to the receiver parent context c. The returned context is done when the parent is done, but the returned child context can be canceled indepedently without affecting the parent.