array

Documentation

Overview

Example

Get(arrData, "b.hhTy3.666.3")

Index

• Variables
• func Exists(source any, key string) bool
• func Find(source any, key string) any
• func Get(source any, key string, defVal ...any) any
• func JSONPointerToSlice(path string) ([]string, error)
• func KeyDelimPathToSlice(path, keyDelim string) []string
• type Array
  • func JSONPointer(source any, path string) (*Array, error)
  • func New(source any) *Array
  • func ParseJSON(source []byte) (*Array, error)
  • func ParseJSONDecoder(decoder *json.Decoder) (*Array, error)
  • func Search(source any, path ...string) *Array
  • func Sub(source any, key string) *Array
  • func (this *Array) ArrayOfSize(size int, path ...any) (*Array, error)
  • func (this *Array) ArrayOfSizeIndex(size, index int) (*Array, error)
  • func (this *Array) ArrayOfSizeKey(size int, key string) (*Array, error)
  • func (this *Array) Children() []*Array
  • func (this *Array) ChildrenMap() map[string]*Array
  • func (this *Array) Delete(path ...any) error
  • func (this *Array) DeleteKey(key string) error
  • func (this *Array) Exists(key string) bool
  • func (this *Array) Find(key string) any
  • func (this *Array) Flatten() (map[string]any, error)
  • func (this *Array) FlattenIncludeEmpty() (map[string]any, error)
  • func (this *Array) Get(key string, defVal ...any) any
  • func (this *Array) Index(index int) *Array
  • func (this *Array) JSONPointer(path string) (*Array, error)
  • func (this *Array) Search(path ...string) *Array
  • func (this *Array) Set(value any, path ...any) (*Array, error)
  • func (this *Array) SetIndex(value any, index int) (*Array, error)
  • func (this *Array) SetKey(value any, key string) (*Array, error)
  • func (this *Array) String() string
  • func (this *Array) Sub(key string) *Array
  • func (this *Array) ToJSON() []byte
  • func (this *Array) ToJSONIndent(prefix, indent string) []byte
  • func (this *Array) Value() any
  • func (this *Array) WithKeyDelim(data string) *Array

Examples

• Package

Variables

var (
	ErrOutOfBounds = errors.New("out of bounds")
)

Functions

func Exists

func Exists(source any, key string) bool

判断是否存在 if key in source return true or false

func Find

func Find(source any, key string) any

查找 find key data from source

func Get

func Get(source any, key string, defVal ...any) any

获取 get key data from source with default value

func JSONPointerToSlice

func JSONPointerToSlice(path string) ([]string, error)

func KeyDelimPathToSlice

func KeyDelimPathToSlice(path, keyDelim string) []string

Types

type Array

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

*

• 获取数组数据 / array struct *
• @create 2022-5-3
• @author deatil

func JSONPointer

func JSONPointer(source any, path string) (*Array, error)

获取数据 get data and return Array

func New

func New(source any) *Array

构造函数 / New

func ParseJSON

func ParseJSON(source []byte) (*Array, error)

解析 JSON 数据 / parse json data

func ParseJSONDecoder

func ParseJSONDecoder(decoder *json.Decoder) (*Array, error)

ParseJSONDecoder applies a json.Decoder to a *Container.

func Search

func Search(source any, path ...string) *Array

搜索 Search data with key from source

func Sub

func Sub(source any, key string) *Array

获取数据 get data and return Array

func (*Array) ArrayOfSize

func (this *Array) ArrayOfSize(size int, path ...any) (*Array, error)

ArrayOfSize creates a new JSON array of a particular size at a path. Returns an error if the path contains a collision with a non object type.

func (*Array) ArrayOfSizeIndex

func (this *Array) ArrayOfSizeIndex(size, index int) (*Array, error)

func (*Array) ArrayOfSizeKey

func (this *Array) ArrayOfSizeKey(size int, key string) (*Array, error)

func (*Array) Children

func (this *Array) Children() []*Array

Children returns a slice of all children of an array element. This also works for objects, however, the children returned for an source will be in a random order and you lose the names of the returned objects this way. If the underlying container value isn't an array or map nil is returned.

func (*Array) ChildrenMap

func (this *Array) ChildrenMap() map[string]*Array

ChildrenMap returns a map of all the children of an source element. IF the underlying value isn't a source then an empty map is returned.

func (*Array) Delete

func (this *Array) Delete(path ...any) error

删除更加路径 delete data with path

func (*Array) DeleteKey

func (this *Array) DeleteKey(key string) error

删除根据 key delete data with key

func (*Array) Exists

func (this *Array) Exists(key string) bool

判断是否存在 if key in source return true or false

func (*Array) Find

func (this *Array) Find(key string) any

查找 find key data from source

func (*Array) Flatten

func (this *Array) Flatten() (map[string]any, error)

Flatten a array or slice into an source of key/value pairs for each field, where the key is the full path of the structured field in dot path notation matching the spec for the method Path.

func (*Array) FlattenIncludeEmpty

func (this *Array) FlattenIncludeEmpty() (map[string]any, error)

FlattenIncludeEmpty a array or slice into an source of key/value pairs for each field, just as Flatten, but includes empty arrays and objects, where the key is the full path of the structured field in dot path notation matching the spec for the method Path.

func (*Array) Get

func (this *Array) Get(key string, defVal ...any) any

获取 get key data from source with default value

func (*Array) Index

func (this *Array) Index(index int) *Array

Index attempts to find and return an element

func (*Array) JSONPointer

func (this *Array) JSONPointer(path string) (*Array, error)

func (*Array) Search

func (this *Array) Search(path ...string) *Array

搜索 Search data with key from source

func (*Array) Set

func (this *Array) Set(value any, path ...any) (*Array, error)

设置数据 set data with path

func (*Array) SetIndex

func (this *Array) SetIndex(value any, index int) (*Array, error)

SetIndex attempts to set a value of an array element based on an index.

func (*Array) SetKey

func (this *Array) SetKey(value any, key string) (*Array, error)

设置数据 set data with key

func (*Array) String

func (this *Array) String() string

String marshals an element to a JSON formatted string.

func (*Array) Sub

func (this *Array) Sub(key string) *Array

获取数据 get data and return Array

func (*Array) ToJSON

func (this *Array) ToJSON() []byte

返回 JSON 数据 return JSON data

func (*Array) ToJSONIndent

func (this *Array) ToJSONIndent(prefix, indent string) []byte

BytesIndent marshals an element to a JSON []byte blob formatted with a prefix and indent string.

func (*Array) Value

func (this *Array) Value() any

返回数据 return source data

func (*Array) WithKeyDelim

func (this *Array) WithKeyDelim(data string) *Array

设置 keyDelim with keyDelim