Package: encoding

Involved Source Files d encoding.go Package encoding defines interfaces shared by other packages that convert data to and from byte-level and textual representations. Packages that check for these interfaces include encoding/gob, encoding/json, and encoding/xml. As a result, implementing an interface once can make a type useful in multiple encodings. Standard types that implement these interfaces include time.Time and net.IP. The interfaces come in pairs that produce and consume encoded data. Adding encoding/decoding methods to existing types may constitute a breaking change, as they can be used for serialization in communicating with programs written with different library versions. The policy for packages maintained by the Go project is to only allow the addition of marshaling functions if no existing, reasonable marshaling exists.

Package-Level Type Names (total 6)

/* sort by: alphabet | popularity */

type BinaryAppender (interface) BinaryAppender is the interface implemented by an object that can append the binary representation of itself. If a type implements both [BinaryAppender] and [BinaryMarshaler], then v.MarshalBinary() must be semantically identical to v.AppendBinary(nil). Methods (only one) ( BinaryAppender) AppendBinary(b []byte) ([]byte, error) AppendBinary appends the binary representation of itself to the end of b (allocating a larger slice if necessary) and returns the updated slice. Implementations must not retain b, nor mutate any bytes within b[:len(b)]. Implemented By (at least 14) *crypto/internal/fips140/sha256.Digest *crypto/internal/fips140/sha3.Digest *crypto/internal/fips140/sha3.SHAKE *crypto/internal/fips140/sha512.Digest *crypto/sha3.SHA3 *crypto/sha3.SHAKE crypto/x509.OID *math/rand/v2.ChaCha8 *math/rand/v2.PCG net/netip.Addr net/netip.AddrPort net/netip.Prefix *net/url.URL time.Time

type BinaryMarshaler (interface) BinaryMarshaler is the interface implemented by an object that can marshal itself into a binary form. MarshalBinary encodes the receiver into a binary form and returns the result. Methods (only one) ( BinaryMarshaler) MarshalBinary() (data []byte, err error) Implemented By (at least 14) *crypto/internal/fips140/sha256.Digest *crypto/internal/fips140/sha3.Digest *crypto/internal/fips140/sha3.SHAKE *crypto/internal/fips140/sha512.Digest *crypto/sha3.SHA3 *crypto/sha3.SHAKE crypto/x509.OID *math/rand/v2.ChaCha8 *math/rand/v2.PCG net/netip.Addr net/netip.AddrPort net/netip.Prefix *net/url.URL time.Time

type BinaryUnmarshaler (interface) BinaryUnmarshaler is the interface implemented by an object that can unmarshal a binary representation of itself. UnmarshalBinary must be able to decode the form generated by MarshalBinary. UnmarshalBinary must copy the data if it wishes to retain the data after returning. Methods (only one) ( BinaryUnmarshaler) UnmarshalBinary(data []byte) error Implemented By (at least 14) *crypto/internal/fips140/sha256.Digest *crypto/internal/fips140/sha3.Digest *crypto/internal/fips140/sha3.SHAKE *crypto/internal/fips140/sha512.Digest *crypto/sha3.SHA3 *crypto/sha3.SHAKE *crypto/x509.OID *math/rand/v2.ChaCha8 *math/rand/v2.PCG *net/netip.Addr *net/netip.AddrPort *net/netip.Prefix *net/url.URL *time.Time

type TextAppender (interface) TextAppender is the interface implemented by an object that can append the textual representation of itself. If a type implements both [TextAppender] and [TextMarshaler], then v.MarshalText() must be semantically identical to v.AppendText(nil). Methods (only one) ( TextAppender) AppendText(b []byte) ([]byte, error) AppendText appends the textual representation of itself to the end of b (allocating a larger slice if necessary) and returns the updated slice. Implementations must not retain b, nor mutate any bytes within b[:len(b)]. Implemented By (at least 12) crypto/x509.OID log/slog.Level *log/slog.LevelVar *math/big.Float *math/big.Int *math/big.Rat net.IP net/netip.Addr net/netip.AddrPort net/netip.Prefix *regexp.Regexp time.Time

type TextMarshaler (interface) TextMarshaler is the interface implemented by an object that can marshal itself into a textual form. MarshalText encodes the receiver into UTF-8-encoded text and returns the result. Methods (only one) ( TextMarshaler) MarshalText() (text []byte, err error) Implemented By (at least 12) crypto/x509.OID log/slog.Level *log/slog.LevelVar *math/big.Float *math/big.Int *math/big.Rat net.IP net/netip.Addr net/netip.AddrPort net/netip.Prefix *regexp.Regexp time.Time As Inputs Of (at least 2) func flag.TextVar(p TextUnmarshaler, name string, value TextMarshaler, usage string) func flag.(*FlagSet).TextVar(p TextUnmarshaler, name string, value TextMarshaler, usage string)

type TextUnmarshaler (interface) TextUnmarshaler is the interface implemented by an object that can unmarshal a textual representation of itself. UnmarshalText must be able to decode the form generated by MarshalText. UnmarshalText must copy the text if it wishes to retain the text after returning. Methods (only one) ( TextUnmarshaler) UnmarshalText(text []byte) error Implemented By (at least 12) *crypto/x509.OID *log/slog.Level *log/slog.LevelVar *math/big.Float *math/big.Int *math/big.Rat *net.IP *net/netip.Addr *net/netip.AddrPort *net/netip.Prefix *regexp.Regexp *time.Time As Inputs Of (at least 2) func flag.TextVar(p TextUnmarshaler, name string, value TextMarshaler, usage string) func flag.(*FlagSet).TextVar(p TextUnmarshaler, name string, value TextMarshaler, usage string)