mirror
/
gjson
mirror of https://github.com/tidwall/gjson.git
1
0
Fork 1
Code Issues Packages Projects Releases Wiki Activity

mention GetBytes function

This commit is contained in:
Josh Baker 2016-10-28 09:07:48 -07:00 committed by GitHub
parent 5fdbb97fe1
commit 95c6f92c50
1 changed files with 14 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
README.md
View File

@ -29,7 +29,7 @@ $ go get -u github.com/tidwall/gjson
This will retrieve the library. This will retrieve the library.
## Get a value ## Get a value
Get searches json for the specified path. A path is in dot syntax, such as "name.last" or "age". This function expects that the json is well-formed and validates. Invalid json will not panic, but it may return back unexpected results. When the value is found it's returned immediately. Get searches json for the specified path. A path is in dot syntax, such as "name.last" or "age". This function expects that the json is well-formed and validates. Invalid json will not panic, but it may return back unexpected results. When the value is found it's returned immediately.
```go ```go
package main package main
@ -50,6 +50,9 @@ This will print:
Prichard Prichard
``` ```
*There also the [GetBytes](#working-with-bytes) function when working with JSON byte slices.*
## Path Syntax ## Path Syntax
A path is a series of keys separated by a dot. A path is a series of keys separated by a dot.
@ -214,6 +217,16 @@ if !ok{
} }
``` ```
## Working with Bytes
If your JSON is contained a `[]byte` slice, there's the [GetBytes](https://godoc.org/github.com/tidwall/gjson#GetBytes) function. This is preferred over `Get(string(data), path)`.
```go
var data []byte = ...
res := gjson.GetBytes(data, path)
```
## Performance ## Performance
Benchmarks of GJSON alongside [encoding/json](https://golang.org/pkg/encoding/json/), Benchmarks of GJSON alongside [encoding/json](https://golang.org/pkg/encoding/json/),