valuectx

Documentation

Index

• func WithValue[K comparable, V any](parent context.Context, key K, val V) context.Context

Functions

func WithValue

func WithValue[K comparable, V any](parent context.Context, key K, val V) context.Context

WithValue returns a copy of parent in which the value associated with key is val.

Use context Values only for request-scoped data that transits processes and APIs, not for passing optional parameters to functions.

The provided key must be comparable and should not be of type string or any other built-in type to avoid collisions between packages using context. Users of WithValue should define their own types for keys. To avoid allocating when assigning to an interface{}, context keys often have concrete type struct{}. Alternatively, exported context key variables' static type should be a pointer or interface.