json

Documentation

Index

• Variables
• func TokenEquals(x, y Token) bool
• type Decoder
  • func NewDecoder(b []byte) *Decoder
  • func (d *Decoder) Clone() *Decoder
  • func (d *Decoder) Peek() (Token, error)
  • func (d *Decoder) Position(idx int) (line int, column int)
  • func (d *Decoder) Read() (Token, error)
• type Encoder
  • func NewEncoder(buf []byte, indent string) (*Encoder, error)
  • func (e *Encoder) Bytes() []byte
  • func (e *Encoder) EndArray()
  • func (e *Encoder) EndObject()
  • func (e *Encoder) StartArray()
  • func (e *Encoder) StartObject()
  • func (e *Encoder) WriteBool(b bool)
  • func (e *Encoder) WriteFloat(n float64, bitSize int)
  • func (e *Encoder) WriteInt(n int64)
  • func (e *Encoder) WriteName(s string) error
  • func (e *Encoder) WriteNull()
  • func (e *Encoder) WriteString(s string) error
  • func (e *Encoder) WriteUint(n uint64)
• type Kind
  • func (k Kind) String() string
• type Token
  • func (t Token) Bool() bool
  • func (t Token) Float(bitSize int) (float64, bool)
  • func (t Token) Int(bitSize int) (int64, bool)
  • func (t Token) Kind() Kind
  • func (t Token) Name() string
  • func (t Token) ParsedString() string
  • func (t Token) Pos() int
  • func (t Token) RawString() string
  • func (t Token) Uint(bitSize int) (uint64, bool)

Variables

var ErrUnexpectedEOF = errors.New("%v", io.ErrUnexpectedEOF)

ErrUnexpectedEOF means that EOF was encountered in the middle of the input.

Functions

func TokenEquals

func TokenEquals(x, y Token) bool

TokenEquals returns true if given Tokens are equal, else false.

Types

type Decoder

type Decoder struct {
	// contains filtered or unexported fields
}

Decoder is a token-based JSON decoder.

func NewDecoder

func NewDecoder(b []byte) *Decoder

NewDecoder returns a Decoder to read the given []byte.

func (*Decoder) Clone

func (d *Decoder) Clone() *Decoder

Clone returns a copy of the Decoder for use in reading ahead the next JSON object, array or other values without affecting current Decoder.

func (*Decoder) Peek

func (d *Decoder) Peek() (Token, error)

Peek looks ahead and returns the next token kind without advancing a read.

func (*Decoder) Position

func (d *Decoder) Position(idx int) (line int, column int)

Position returns line and column number of given index of the original input. It will panic if index is out of range.

func (*Decoder) Read

func (d *Decoder) Read() (Token, error)

Read returns the next JSON token. It will return an error if there is no valid token.

type Encoder

type Encoder struct {
	// contains filtered or unexported fields
}

Encoder provides methods to write out JSON constructs and values. The user is responsible for producing valid sequences of JSON constructs and values.

func NewEncoder

func NewEncoder(buf []byte, indent string) (*Encoder, error)

NewEncoder returns an Encoder.

If indent is a non-empty string, it causes every entry for an Array or Object to be preceded by the indent and trailed by a newline.

func (*Encoder) Bytes

func (e *Encoder) Bytes() []byte

Bytes returns the content of the written bytes.

func (*Encoder) EndArray

func (e *Encoder) EndArray()

EndArray writes out the ']' symbol.

func (*Encoder) EndObject

func (e *Encoder) EndObject()

EndObject writes out the '}' symbol.

func (*Encoder) StartArray

func (e *Encoder) StartArray()

StartArray writes out the '[' symbol.

func (*Encoder) StartObject

func (e *Encoder) StartObject()

StartObject writes out the '{' symbol.

func (*Encoder) WriteBool

func (e *Encoder) WriteBool(b bool)

WriteBool writes out the given boolean value.

func (*Encoder) WriteFloat

func (e *Encoder) WriteFloat(n float64, bitSize int)

WriteFloat writes out the given float and bitSize in JSON number value.

func (*Encoder) WriteInt

func (e *Encoder) WriteInt(n int64)

WriteInt writes out the given signed integer in JSON number value.

func (*Encoder) WriteName

func (e *Encoder) WriteName(s string) error

WriteName writes out the given string in JSON string value and the name separator ':'. Returns error if input string contains invalid UTF-8, which should not be likely as protobuf field names should be valid.

func (*Encoder) WriteNull

func (e *Encoder) WriteNull()

WriteNull writes out the null value.

func (*Encoder) WriteString

func (e *Encoder) WriteString(s string) error

WriteString writes out the given string in JSON string value. Returns error if input string contains invalid UTF-8.

func (*Encoder) WriteUint

func (e *Encoder) WriteUint(n uint64)

WriteUint writes out the given unsigned integer in JSON number value.

type Kind

type Kind uint16

Kind represents a token kind expressible in the JSON format.

const (
	Invalid Kind = (1 << iota) / 2
	EOF
	Null
	Bool
	Number
	String
	Name
	ObjectOpen
	ObjectClose
	ArrayOpen
	ArrayClose
)

func (Kind) String

func (k Kind) String() string

type Token

type Token struct {
	// contains filtered or unexported fields
}

Token provides a parsed token kind and value.

Values are provided by the difference accessor methods. The accessor methods Name, Bool, and ParsedString will panic if called on the wrong kind. There are different accessor methods for the Number kind for converting to the appropriate Go numeric type and those methods have the ok return value.

func (Token) Bool

func (t Token) Bool() bool

Bool returns the bool value if token kind is Bool, else it panics.

func (Token) Float

func (t Token) Float(bitSize int) (float64, bool)

Float returns the floating-point number if token kind is Number.

The floating-point precision is specified by the bitSize parameter: 32 for float32 or 64 for float64. If bitSize=32, the result still has type float64, but it will be convertible to float32 without changing its value. It will return false if the number exceeds the floating point limits for given bitSize.

func (Token) Int

func (t Token) Int(bitSize int) (int64, bool)

Int returns the signed integer number if token is Number.

The given bitSize specifies the integer type that the result must fit into. It returns false if the number is not an integer value or if the result exceeds the limits for given bitSize.

func (Token) Kind

func (t Token) Kind() Kind

Kind returns the token kind.

func (Token) Name

func (t Token) Name() string

Name returns the object name if token is Name, else it panics.

func (Token) ParsedString

func (t Token) ParsedString() string

ParsedString returns the string value for a JSON string token or the read value in string if token is not a string.

func (Token) Pos

func (t Token) Pos() int

Pos returns the token position from the input.

func (Token) RawString

func (t Token) RawString() string

RawString returns the read value in string.

func (Token) Uint

func (t Token) Uint(bitSize int) (uint64, bool)

Uint returns the signed integer number if token is Number.

The given bitSize specifies the unsigned integer type that the result must fit into. It returns false if the number is not an unsigned integer value or if the result exceeds the limits for given bitSize.