go/json-iterator
1
0
Fork 0
mirror of https://github.com/json-iterator/go.git synced 2025-06-06 22:36:25 +02:00
Code Issues Releases Activity

simplify readme

Browse Source
This commit is contained in:
Tao Wen 2017-06-02 11:20:24 +08:00
parent fe9fa8900e
commit 2051e3b8ae
1 changed files with 19 additions and 42 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

61
README.md
View File

@ -2,60 +2,37 @@
jsoniter (json-iterator) is fast and flexible JSON parser available in [Java](https://github.com/json-iterator/java) and [Go](https://github.com/json-iterator/go) jsoniter (json-iterator) is fast and flexible JSON parser available in [Java](https://github.com/json-iterator/java) and [Go](https://github.com/json-iterator/go)
# Why jsoniter? # Usage
* Jsoniter is the fastest JSON parser. It could be up to 10x faster than normal parser, data binding included. Shameless self [benchmark](http://jsoniter.com/benchmark.html) 100% compatibility with standard lib
* Extremely flexible api. You can mix and match three different styles: bind-api, any-api or iterator-api. Checkout your [api choices](http://jsoniter.com/api.html)
* Unique iterator api can iterate through JSON directly, zero memory allocation! See how [iterator](http://jsoniter.com/api.html#iterator-api) works
# Show off Replace
Here is a quick show off, for more complete report you can checkout the full [benchmark](http://jsoniter.com/benchmark.html) with [in-depth optimization](http://jsoniter.com/benchmark.html#optimization-used) to back the numbers up ```
import "encoding/json"
![go-medium](http://jsoniter.com/benchmarks/go-medium.png) json.Marshal(&data)
# Bind-API is the best
Bind-api should always be the first choice. Given this JSON document `[0,1,2,3]`
Parse with Go bind-api
```go
import "github.com/json-iterator/go"
iter := jsoniter.ParseString(`[0,1,2,3]`)
var := iter.Read()
fmt.Println(val)
``` ```
# Iterator-API for quick extraction with
When you do not need to get all the data back, just extract some. ```
Parse with Go iterator-api
```go
import "github.com/json-iterator/go" import "github.com/json-iterator/go"
iter := ParseString(`[0, [1, 2], [3, 4], 5]`) jsoniter.Marshal(&data)
count := 0
for iter.ReadArray() {
iter.Skip()
count++
}
fmt.Println(count) // 4
``` ```
# Any-API for maximum flexibility Replace
Parse with Go any-api ```
import "encoding/json"
```go json.Unmarshal(input, &data)
import "github.com/json-iterator/go"
iter := jsoniter.ParseString(`[{"field1":"11","field2":"12"},{"field1":"21","field2":"22"}]`)
val := iter.ReadAny()
fmt.Println(val.ToInt(1, "field2")) // 22
``` ```
Notice you can extract from nested data structure, and convert any type to the type to you want. with
```
import "github.com/json-iterator/go"
jsoniter.Unmarshal(input, &data)
```
# How to get # How to get