gjson

package
v1.6.4 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Apr 24, 2019 License: MIT Imports: 16 Imported by: 0

Documentation

Overview

Package gjson provides convenient API for JSON/XML/YAML/TOML data handling.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func Decode 

func Decode(data interface{}) (interface{}, error)

Decode decodes <data>(string/[]byte) to golang variable.

func DecodeTo 

func DecodeTo(data interface{}, v interface{}) error

Decode decodes <data>(string/[]byte) to specified golang variable <v>. The <v> should be a pointer type.

func Encode 

func Encode(value interface{}) ([]byte, error)

Encode encodes <value> to JSON data type of bytes.

func Valid 

func Valid(data interface{}) bool

Valid checks whether <data> is a valid JSON data type.

Types

type Json 

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

The customized JSON struct.

func DecodeToJson 

func DecodeToJson(data interface{}, unsafe ...bool) (*Json, error)

DecodeToJson codes <data>(string/[]byte) to a Json object.

func Load 

func Load(path string, unsafe ...bool) (*Json, error)

Load loads content from specified file <path>, and creates a Json object from its content.

func LoadContent 

func LoadContent(data interface{}, unsafe ...bool) (*Json, error)

LoadContent creates a Json object from given content, it checks the data type of <content> automatically, supporting JSON, XML, YAML and TOML types of data.

func New 

func New(data interface{}, unsafe ...bool) *Json

New creates a Json object with any variable type of <data>, but <data> should be a map or slice for data access reason, or it will make no sense. The <unsafe> param specifies whether using this Json object in un-concurrent-safe context, which is false in default.

func NewUnsafe 

func NewUnsafe(data ...interface{}) *Json

NewUnsafe creates a un-concurrent-safe Json object.

func (*Json) Append 

func (j *Json) Append(pattern string, value interface{}) error

Append appends value to the value by specified <pattern>. The target value by <pattern> should be type of slice.

func (*Json) Contains 

func (j *Json) Contains(pattern ...string) bool

Contains checks whether the value by specified <pattern> exist.

func (*Json) Dump 

func (j *Json) Dump() error

Dump prints current Json object with more manually readable.

func (*Json) Get 

func (j *Json) Get(pattern ...string) interface{}

Get returns value by specified <pattern>. It returns all values of current Json object, if <pattern> is empty or not specified. It returns nil if no value found by <pattern>.

We can also access slice item by its index number in <pattern>, eg: "items.name.first", "list.10".

func (*Json) GetArray 

func (j *Json) GetArray(pattern string) []interface{}

GetArray gets the value by specified <pattern>, and converts it to a slice of []interface{}.

func (*Json) GetBool 

func (j *Json) GetBool(pattern string) bool

GetBool gets the value by specified <pattern>, and converts it to bool. It returns false when value is: "", 0, false, off, nil; or returns true instead.

func (*Json) GetFloat32 

func (j *Json) GetFloat32(pattern string) float32

func (*Json) GetFloat64 

func (j *Json) GetFloat64(pattern string) float64

func (*Json) GetFloats 

func (j *Json) GetFloats(pattern string) []float64

func (*Json) GetInt 

func (j *Json) GetInt(pattern string) int

func (*Json) GetInt16 

func (j *Json) GetInt16(pattern string) int16

func (*Json) GetInt32 

func (j *Json) GetInt32(pattern string) int32

func (*Json) GetInt64 

func (j *Json) GetInt64(pattern string) int64

func (*Json) GetInt8 

func (j *Json) GetInt8(pattern string) int8

func (*Json) GetInterfaces 

func (j *Json) GetInterfaces(pattern string) []interface{}

See GetArray.

func (*Json) GetInts 

func (j *Json) GetInts(pattern string) []int

func (*Json) GetJson 

func (j *Json) GetJson(pattern string) *Json

GetJson gets the value by specified <pattern>, and converts it to a Json object.

func (*Json) GetJsons 

func (j *Json) GetJsons(pattern string) []*Json

GetJsons gets the value by specified <pattern>, and converts it to a slice of Json object.

func (*Json) GetMap 

func (j *Json) GetMap(pattern string) map[string]interface{}

GetMap gets the value by specified <pattern>, and converts it to map[string]interface{}.

func (*Json) GetString 

func (j *Json) GetString(pattern string) string

GetString gets the value by specified <pattern>, and converts it to string.

func (*Json) GetStrings 

func (j *Json) GetStrings(pattern string) []string

GetStrings gets the value by specified <pattern>, and converts it to a slice of []string.

func (*Json) GetTime 

func (j *Json) GetTime(pattern string, format ...string) time.Time

func (*Json) GetTimeDuration added in v1.5.0 

func (j *Json) GetTimeDuration(pattern string) time.Duration

func (*Json) GetToStruct 

func (j *Json) GetToStruct(pattern string, objPointer interface{}) error

GetToStruct gets the value by specified <pattern>, and converts it to specified object <objPointer>. The <objPointer> should be the pointer to an object.

func (*Json) GetToVar 

func (j *Json) GetToVar(pattern string, v interface{}) error

GetToVar gets the value by specified <pattern>, and converts it to specified golang variable <v>. The <v> should be a pointer type.

func (*Json) GetUint 

func (j *Json) GetUint(pattern string) uint

func (*Json) GetUint16 

func (j *Json) GetUint16(pattern string) uint16

func (*Json) GetUint32 

func (j *Json) GetUint32(pattern string) uint32

func (*Json) GetUint64 

func (j *Json) GetUint64(pattern string) uint64

func (*Json) GetUint8 

func (j *Json) GetUint8(pattern string) uint8

func (*Json) Len 

func (j *Json) Len(pattern string) int

Len returns the length/size of the value by specified <pattern>. The target value by <pattern> should be type of slice or map. It returns -1 if the target value is not found, or its type is invalid.

func (*Json) Remove 

func (j *Json) Remove(pattern string) error

Remove deletes value with specified <pattern>. It supports hierarchical data access by char separator, which is '.' in default.

func (*Json) Set 

func (j *Json) Set(pattern string, value interface{}) error

Set sets value with specified <pattern>. It supports hierarchical data access by char separator, which is '.' in default.

func (*Json) SetSplitChar 

func (j *Json) SetSplitChar(char byte)

SetSplitChar sets the separator char for hierarchical data access.

func (*Json) SetViolenceCheck 

func (j *Json) SetViolenceCheck(enabled bool)

SetViolenceCheck enables/disables violence check for hierarchical data access.

func (*Json) ToArray 

func (j *Json) ToArray() []interface{}

ToArray converts current Json object to []interface{}. It returns nil if fails.

func (*Json) ToJson 

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

func (*Json) ToJsonIndent 

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

func (*Json) ToJsonIndentString 

func (j *Json) ToJsonIndentString() (string, error)

func (*Json) ToJsonString 

func (j *Json) ToJsonString() (string, error)

func (*Json) ToMap 

func (j *Json) ToMap() map[string]interface{}

ToMap converts current Json object to map[string]interface{}. It returns nil if fails.

func (*Json) ToStruct 

func (j *Json) ToStruct(objPointer interface{}) error

ToStruct converts current Json object to specified object. The <objPointer> should be a pointer type.

func (*Json) ToToml 

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

func (*Json) ToTomlString 

func (j *Json) ToTomlString() (string, error)

func (*Json) ToXml 

func (j *Json) ToXml(rootTag ...string) ([]byte, error)

func (*Json) ToXmlIndent 

func (j *Json) ToXmlIndent(rootTag ...string) ([]byte, error)

func (*Json) ToXmlIndentString 

func (j *Json) ToXmlIndentString(rootTag ...string) (string, error)

func (*Json) ToXmlString 

func (j *Json) ToXmlString(rootTag ...string) (string, error)

func (*Json) ToYaml 

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

func (*Json) ToYamlString 

func (j *Json) ToYamlString() (string, error)

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.