codec

func Lookup ¶

func Lookup(f Format) (c Codec, ok bool)

Lookup returns the codec registered under f.

IFACE-PLUGIN: the registry stores plug-in codec instances behind the Codec interface — concrete types are intentionally unexported per-format.

func LookupExt ¶

func LookupExt(ext string) (c Codec, ok bool)

LookupExt returns the codec whose extension list contains ext.

IFACE-PLUGIN: the registry stores plug-in codec instances behind the Codec interface — concrete types are intentionally unexported per-format.

func LookupMIME ¶

func LookupMIME(raw string) (c Codec, ok bool)

LookupMIME returns the codec whose MIME list matches. MIME parameters (e.g. "; charset=utf-8") are stripped before the index lookup so that "application/json; charset=utf-8" resolves like "application/json".

IFACE-PLUGIN: the registry stores plug-in codec instances behind the Codec interface — concrete types are intentionally unexported per-format.

func Register ¶

func Register(c Codec) Codec

Register inserts c into the registry and returns it so callers can bind the singleton to a typed package-level variable like `var Codec codec.Codec = codec.Register(&jsonCodec{})`. Panics on nil argument, on an empty Name / MIME / extension (KEY_EMPTY), or on a duplicate Name / MIME / extension.

Register reads c.Name, c.MIMETypes and c.Extensions through the Codec interface, so the initialiser of the calling package variable does NOT depend, in the sense of the Go specification's package initialization rules, on any package variable those methods read: a dependency is only recorded for a method referenced through a non-interface type. A codec whose methods read package variables must therefore make that dependency visible in the initialiser itself — or, as the SDK's codecs do, return fresh literals from the methods — otherwise those variables may still be unset when Register runs (the gc compiler hides this by initialising constant composite literals statically; garble -literals does not).

IFACE-PLUGIN: the registry hands plug-in codec instances back to callers so each domain can keep its concrete codec type unexported; the only stable contract is the Codec interface itself.

"Nil" here means UNUSABLE, not only an untyped nil: a typed nil pointer and a plug-in whose type is not comparable both satisfy the port and neither can serve one call (see internal/kernel/plugin).

func Available ¶

func Available() []Format

Available returns the sorted list of registered Formats, or nil before any Register.