simplejson

func (*Json) Array ¶

func (j *Json) Array() result.Result[[]interface{}]

Array type asserts to an `array`

func (*Json) Bool ¶

func (j *Json) Bool() result.Result[bool]

Bool type asserts to `bool`

func (*Json) Bytes ¶

func (j *Json) Bytes() result.Result[[]byte]

Bytes returns []byte from string data

func (*Json) CheckGet ¶

func (j *Json) CheckGet(key string) option.Option[*Json]

CheckGet returns an option.Option[*Json] identifying success or failure

useful for chained operations when success is important:

if data := js.Get("top_level").CheckGet("inner"); data.IsSome() {
    log.Println(data.Unwrap())
}

func (*Json) Del ¶

func (j *Json) Del(key string)

Del modifies `Json` map by deleting `key` if it is present.

func (*Json) Encode ¶

func (j *Json) Encode() ([]byte, error)

Encode returns its marshaled data as `[]byte`

func (*Json) EncodePretty ¶

func (j *Json) EncodePretty() ([]byte, error)

EncodePretty returns its marshaled data as `[]byte` with indentation

func (*Json) Float64 ¶

func (j *Json) Float64() result.Result[float64]

Float64 coerces into a float64

func (*Json) Get ¶

func (j *Json) Get(key string) *Json

Get returns a pointer to a new `Json` object for `key` in its `map` representation

useful for chaining operations (to traverse a nested JSON):

js.Get("top_level").Get("dict").Get("value").Int()

func (*Json) GetIndex ¶

func (j *Json) GetIndex(index int) *Json

GetIndex returns a pointer to a new `Json` object for `index` in its `array` representation

this is the analog to Get when accessing elements of a json array instead of a json object:

js.Get("top_level").Get("array").GetIndex(1).Get("key").Int()

func (*Json) GetPath ¶

func (j *Json) GetPath(branch ...string) *Json

GetPath searches for the item as specified by the branch without the need to deep dive using Get()'s.

js.GetPath("top_level", "dict")

func (*Json) Int ¶

func (j *Json) Int() result.Result[int]

Int coerces into an int

func (*Json) Int64 ¶

func (j *Json) Int64() result.Result[int64]

Int64 coerces into an int64

func (*Json) Int64Array ¶ added in v1.4.0

func (j *Json) Int64Array() result.Result[[]int64]

Int64Array type asserts to an `array` of `int64`

func (*Json) IntArray ¶ added in v1.4.0

func (j *Json) IntArray() result.Result[[]int]

IntArray type asserts to an `array` of `int`

func (*Json) Interface ¶

func (j *Json) Interface() interface{}

Interface returns the underlying data

func (*Json) Map ¶

func (j *Json) Map() result.Result[map[string]interface{}]

Map type asserts to `map`

func (*Json) MarshalJSON ¶

func (j *Json) MarshalJSON() ([]byte, error)

Implements the json.Marshaler interface.

func (*Json) MustArray ¶

func (j *Json) MustArray(args ...[]interface{}) []interface{}

MustArray guarantees the return of a `[]interface{}` (with optional default)

useful when you want to interate over array values in a succinct manner:

for i, v := range js.Get("results").MustArray() {
	fmt.Println(i, v)
}

func (*Json) MustBool ¶

func (j *Json) MustBool(args ...bool) bool

MustBool guarantees the return of a `bool` (with optional default)

useful when you explicitly want a `bool` in a single value return context:

myFunc(js.Get("param1").MustBool(), js.Get("optional_param").MustBool(true))

func (*Json) MustFloat64 ¶

func (j *Json) MustFloat64(args ...float64) float64

MustFloat64 guarantees the return of a `float64` (with optional default)

useful when you explicitly want a `float64` in a single value return context:

myFunc(js.Get("param1").MustFloat64(), js.Get("optional_param").MustFloat64(5.150))

func (*Json) MustInt ¶

func (j *Json) MustInt(args ...int) int

MustInt guarantees the return of an `int` (with optional default)

useful when you explicitly want an `int` in a single value return context:

myFunc(js.Get("param1").MustInt(), js.Get("optional_param").MustInt(5150))

func (*Json) MustInt64 ¶

func (j *Json) MustInt64(args ...int64) int64

MustInt64 guarantees the return of an `int64` (with optional default)

useful when you explicitly want an `int64` in a single value return context:

myFunc(js.Get("param1").MustInt64(), js.Get("optional_param").MustInt64(5150))

func (*Json) MustMap ¶

func (j *Json) MustMap(args ...map[string]interface{}) map[string]interface{}

MustMap guarantees the return of a `map[string]interface{}` (with optional default)

useful when you want to interate over map values in a succinct manner:

for k, v := range js.Get("dictionary").MustMap() {
	fmt.Println(k, v)
}

func (*Json) MustString ¶

func (j *Json) MustString(args ...string) string

MustString guarantees the return of a `string` (with optional default)

useful when you explicitly want a `string` in a single value return context:

myFunc(js.Get("param1").MustString(), js.Get("optional_param").MustString("my_default"))

func (*Json) MustStringArray ¶

func (j *Json) MustStringArray(args ...[]string) []string

MustStringArray guarantees the return of a `[]string` (with optional default)

useful when you want to interate over array values in a succinct manner:

for i, s := range js.Get("results").MustStringArray() {
	fmt.Println(i, s)
}

func (*Json) MustUint64 ¶

func (j *Json) MustUint64(args ...uint64) uint64

MustUInt64 guarantees the return of an `uint64` (with optional default)

useful when you explicitly want an `uint64` in a single value return context:

myFunc(js.Get("param1").MustUint64(), js.Get("optional_param").MustUint64(5150))

func (*Json) Set ¶

func (j *Json) Set(key string, val interface{})

Set modifies `Json` map by `key` and `value` Useful for changing single key/value in a `Json` object easily.

func (*Json) SetPath ¶

func (j *Json) SetPath(branch []string, val interface{})

SetPath modifies `Json`, recursively checking/creating map keys for the supplied path, and then finally writing in the value

func (*Json) String ¶

func (j *Json) String() result.Result[string]

String type asserts to `string`

func (*Json) StringArray ¶

func (j *Json) StringArray() result.Result[[]string]

StringArray type asserts to an `array` of `string`

func (*Json) Uint64 ¶

func (j *Json) Uint64() result.Result[uint64]

Uint64 coerces into an uint64

func (*Json) UnmarshalJSON ¶

func (j *Json) UnmarshalJSON(p []byte) error

Implements the json.Unmarshaler interface.