Involved Source Files Package attributes defines a generic key/value store used in various gRPC
components.
# Experimental
Notice: This package is EXPERIMENTAL and may be changed or removed in a
later release.
Package-Level Type Names (only one, which is exported)
/* sort exporteds by: | */
Attributes is an immutable struct for storing and retrieving generic
key/value pairs. Keys must be hashable, and users should define their own
types for keys. Values should not be modified after they are added to an
Attributes or if they were received from one. If values implement 'Equal(o
any) bool', it will be called by (*Attributes).Equal to determine whether
two values with the same key should be considered equal.mmap[any]any Equal returns whether a and o are equivalent. If 'Equal(o any) bool' is
implemented for a value in the attributes, it is called to determine if the
value matches the one stored in the other attributes. If Equal is not
implemented, standard equality is used to determine if the two values are
equal. Note that some types (e.g. maps) aren't comparable by default, so
they must be wrapped in a struct, or in an alias type, with Equal defined. MarshalJSON helps implement the json.Marshaler interface, thereby rendering
the Attributes correctly when printing (via pretty.JSON) structs containing
Attributes as fields.
Is it impossible to unmarshal attributes from a JSON representation and this
method is meant only for debugging purposes. String prints the attribute map. If any key or values throughout the map
implement fmt.Stringer, it calls that method and appends. Value returns the value associated with these attributes for key, or nil if
no value is associated with key. The returned value should not be modified. WithValue returns a new Attributes containing the previous keys and values
and the new key/value pair. If the same key appears multiple times, the
last value overwrites all previous values for that key. To remove an
existing key, use a nil value. value should not be modified later.
*Attributes : encoding/json.Marshaler
*Attributes : expvar.Var
*Attributes : fmt.Stringer
*Attributes : context.stringer
*Attributes : runtime.stringer
func New(key, value any) *Attributes
func (*Attributes).WithValue(key, value any) *Attributes
func (*Attributes).Equal(o *Attributes) bool
Package-Level Functions (total 2, in which 1 is exported)
New returns a new Attributes containing the key/value pair.