protobuf: google.golang.org/protobuf/internal/encoding/tag Index | Files

package tag

import "google.golang.org/protobuf/internal/encoding/tag"

Package tag marshals and unmarshals the legacy struct tags as generated by historical versions of protoc-gen-go.

Index

Package Files

tag.go

func Marshal Uses

func Marshal(fd pref.FieldDescriptor, enumName string) string

Marshal encodes the protoreflect.FieldDescriptor as a tag.

The enumName must be provided if the kind is an enum. Historically, the formulation of the enum "name" was the proto package dot-concatenated with the generated Go identifier for the enum type. Depending on the context on how Marshal is called, there are different ways through which that information is determined. As such it is the caller's responsibility to provide a function to obtain that information.

func Unmarshal Uses

func Unmarshal(tag string, goType reflect.Type, evs pref.EnumValueDescriptors) pref.FieldDescriptor

Unmarshal decodes the tag into a prototype.Field.

The goType is needed to determine the original protoreflect.Kind since the tag does not record sufficient information to determine that. The type is the underlying field type (e.g., a repeated field may be represented by []T, but the Go type passed in is just T). A list of enum value descriptors must be provided for enum fields. This does not populate the Enum or Message (except for weak message).

This function is a best effort attempt; parsing errors are ignored.

Package tag imports 7 packages (graph) and is imported by 4 packages. Updated 2020-09-09. Refresh now. Tools for package owners.