cybercyst/go
1
0
Fork 0
mirror of https://github.com/golang/go.git synced 2025-05-30 11:51:34 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

encoding/json: document that marshaling invalid utf-8 sequence will return error

Browse Source 
Also added docs for InvalidUTF8Error.
Fixes #5360.

R=golang-dev, adg, r
CC=golang-dev
https://golang.org/cl/8926046
This commit is contained in:
Shenghou Ma 2013-04-30 11:21:48 +08:00
parent b42c8294eb
commit 5c20a4f260
1 changed files with 5 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
src/pkg/encoding/json/encode.go
View File

@ -39,8 +39,8 @@ import (
// //
// Floating point, integer, and Number values encode as JSON numbers. // Floating point, integer, and Number values encode as JSON numbers.
// //
// String values encode as JSON strings, with each invalid UTF-8 sequence // String values encode as JSON strings. InvalidUTF8Error will be returned
// replaced by the encoding of the Unicode replacement character U+FFFD. // if an invalid UTF-8 sequence is encountered.
// The angle brackets "<" and ">" are escaped to "\u003c" and "\u003e" // The angle brackets "<" and ">" are escaped to "\u003c" and "\u003e"
// to keep some browsers from misinterpreting JSON output as HTML. // to keep some browsers from misinterpreting JSON output as HTML.
// //
@ -200,8 +200,10 @@ func (e *UnsupportedValueError) Error() string {
return "json: unsupported value: " + e.Str return "json: unsupported value: " + e.Str
} }
// An InvalidUTF8Error is returned by Marshal when attempting
// to encode a string value with invalid UTF-8 sequences.
type InvalidUTF8Error struct { type InvalidUTF8Error struct {
S string S string // the whole string value that caused the error
} }
func (e *InvalidUTF8Error) Error() string { func (e *InvalidUTF8Error) Error() string {