encoding/json: document that object keys are sorted

Fixes #15424

Change-Id: Ib9e97509f5ac239ee54fe6fe37152a7f5fc75087
Reviewed-on: https://go-review.googlesource.com/23109
Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
This commit is contained in:
Scott Bell 2016-05-16 12:36:02 -07:00 committed by Brad Fitzpatrick
parent 64770f642f
commit 181000896e

View file

@ -119,8 +119,8 @@ import (
//
// Map values encode as JSON objects. The map's key type must either be a
// string, an integer type, or implement encoding.TextMarshaler. The map keys
// are used as JSON object keys by applying the following rules, subject to the
// UTF-8 coercion described for string values above:
// are sorted and used as JSON object keys by applying the following rules,
// subject to the UTF-8 coercion described for string values above:
// - string keys are used directly
// - encoding.TextMarshalers are marshaled
// - integer keys are converted to strings