Documentation ¶
Index ¶
- func Encode(val interface{}, opts Options) ([]byte, error)
- func EncodeIndented(val interface{}, prefix string, indent string, opts Options) ([]byte, error)
- func EncodeInto(buf *[]byte, val interface{}, opts Options) error
- func HTMLEscape(dst []byte, src []byte) []byte
- func Pretouch(vt reflect.Type, opts ...option.CompileOption) error
- func Quote(s string) string
- func Valid(data []byte) (ok bool, start int)
- type Encoder
- func (self *Encoder) Encode(v interface{}) ([]byte, error)
- func (self *Encoder) SetCompactMarshaler(f bool)
- func (self *Encoder) SetEscapeHTML(f bool)
- func (enc *Encoder) SetIndent(prefix, indent string)
- func (self *Encoder) SetNoQuoteTextMarshaler(f bool)
- func (self *Encoder) SetValidateString(f bool)
- func (self *Encoder) SortKeys() *Encoder
- type Options
- type StreamEncoder
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func EncodeIndented ¶
EncodeIndented is like Encode but applies Indent to format the output. Each JSON element in the output will begin on a new line beginning with prefix followed by one or more copies of indent according to the indentation nesting.
func EncodeInto ¶
EncodeInto is like Encode but uses a user-supplied buffer instead of allocating a new one.
func HTMLEscape ¶ added in v1.0.2
HTMLEscape appends to dst the JSON-encoded src with <, >, &, U+2028 and U+2029 characters inside string literals changed to \u003c, \u003e, \u0026, \u2028, \u2029 so that the JSON will be safe to embed inside HTML <script> tags. For historical reasons, web browsers don't honor standard HTML escaping within <script> tags, so an alternative JSON encoding must be used.
func Pretouch ¶
func Pretouch(vt reflect.Type, opts ...option.CompileOption) error
Pretouch compiles vt ahead-of-time to avoid JIT compilation on-the-fly, in order to reduce the first-hit latency.
Opts are the compile options, for example, "option.WithCompileRecursiveDepth" is a compile option to set the depth of recursive compile for the nested struct type.
Types ¶
type Encoder ¶
type Encoder struct { Opts Options // contains filtered or unexported fields }
Encoder represents a specific set of encoder configurations.
func (*Encoder) SetCompactMarshaler ¶ added in v1.3.0
SetCompactMarshaler specifies if option CompactMarshaler opens
func (*Encoder) SetEscapeHTML ¶ added in v1.3.0
SetEscapeHTML specifies if option EscapeHTML opens
func (*Encoder) SetIndent ¶ added in v1.3.0
SetIndent instructs the encoder to format each subsequent encoded value as if indented by the package-level function EncodeIndent(). Calling SetIndent("", "") disables indentation.
func (*Encoder) SetNoQuoteTextMarshaler ¶ added in v1.3.0
SetNoQuoteTextMarshaler specifies if option NoQuoteTextMarshaler opens
func (*Encoder) SetValidateString ¶ added in v1.8.0
SetValidateString specifies if option ValidateString opens
type Options ¶
type Options uint64
Options is a set of encoding options.
const ( // SortMapKeys indicates that the keys of a map needs to be sorted // before serializing into JSON. // WARNING: This hurts performance A LOT, USE WITH CARE. SortMapKeys Options = 1 << bitSortMapKeys // EscapeHTML indicates encoder to escape all HTML characters // after serializing into JSON (see https://pkg.go.dev/encoding/json#HTMLEscape). // WARNING: This hurts performance A LOT, USE WITH CARE. EscapeHTML Options = 1 << bitEscapeHTML // CompactMarshaler indicates that the output JSON from json.Marshaler // is always compact and needs no validation CompactMarshaler Options = 1 << bitCompactMarshaler // NoQuoteTextMarshaler indicates that the output text from encoding.TextMarshaler // is always escaped string and needs no quoting NoQuoteTextMarshaler Options = 1 << bitNoQuoteTextMarshaler // NoNullSliceOrMap indicates all empty Array or Object are encoded as '[]' or '{}', // instead of 'null' NoNullSliceOrMap Options = 1 << bitNoNullSliceOrMap // ValidateString indicates that encoder should validate the input string // before encoding it into JSON. ValidateString Options = 1 << bitValidateString // CompatibleWithStd is used to be compatible with std encoder. CompatibleWithStd Options = SortMapKeys | EscapeHTML | CompactMarshaler )
type StreamEncoder ¶ added in v1.3.0
type StreamEncoder struct { Encoder // contains filtered or unexported fields }
StreamEncoder uses io.Writer as
func NewStreamEncoder ¶ added in v1.3.0
func NewStreamEncoder(w io.Writer) *StreamEncoder
NewStreamEncoder adapts to encoding/json.NewDecoder API.
NewStreamEncoder returns a new encoder that write to w.
func (*StreamEncoder) Encode ¶ added in v1.3.0
func (enc *StreamEncoder) Encode(val interface{}) (err error)
Encode encodes interface{} as JSON to io.Writer