gjson

func GetBool ¶

func GetBool(json, path string) bool

GetBool returns a boolean representation.

func GetFloat ¶

func GetFloat(json, path string) float64

GetFloat searches json for the specified path. A path is in dot syntax, such as "name.last" or "age". When the value is found it's returned immediately.

A path is a series of keys separated by a dot. A key may contain special wildcard characters '*' and '?'. To access an array value use the index as the key. To get the number of elements in an array or to access a child path, use the '#' character. The dot and wildcard character can be escaped with '\'.

{
  "name": {"first": "Tom", "last": "Anderson"},
  "age":37,
  "children": ["Sara","Alex","Jack"],
  "friends": [
    {"first": "James", "last": "Murphy"},
    {"first": "Roger", "last": "Craig"}
  ]
}
"name.last"          >> "Anderson"
"age"                >> 37
"children"           >> ["Sara","Alex","Jack"]
"children.#"         >> 3
"children.1"         >> "Alex"
"child*.2"           >> "Jack"
"c?ildren.0"         >> "Sara"
"friends.#.first"    >> ["James","Roger"]

This function expects that the json is well-formed, and does not validate. Invalid json will not panic, but it may return unexpected results. If you are consuming JSON from an unpredictable source then you may want to use the Valid function first.

func GetInt ¶

func GetInt(json, path string) int64

GetInt returns an integer representation.

func GetInterface ¶

func GetInterface(json, path string) interface{}

GetInterface returns one of these types:

bool, for JSON booleans
float64, for JSON numbers
Number, for JSON numbers
string, for JSON string literals
nil, for JSON null
map[string]interface{}, for JSON objects
[]interface{}, for JSON arrays

func GetMap ¶

func GetMap(json, path string) map[string]gjson.Result

GetMap returns a map of values. The result should be a JSON array.

func GetString ¶

func GetString(json, path string) string

GetString returns a string representation of the value.