suzanne.soy/racket
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add a blurb on names in the json library.

Browse Source
This commit is contained in:
Eli Barzilay 2012-04-13 20:12:17 -04:00
parent 8cbd26899f
commit 7360c4c3c2
1 changed files with 12 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
collects/json/json.scrbl
View File

@ -91,7 +91,9 @@ the @rfc for more information about JSON.
jsexpr?]{ jsexpr?]{
Parses the JSON bytes string @racket[str] as an immutable @tech{jsexpr}.} Parses the JSON bytes string @racket[str] as an immutable @tech{jsexpr}.}
@section{A word about design} @section{A Word About Design}
@subsection{The JS-Expression Data Type}
JSON syntactically distinguishes ``@tt{null}'', array literals, and JSON syntactically distinguishes ``@tt{null}'', array literals, and
object literals, and therefore there is a question of what Racket value object literals, and therefore there is a question of what Racket value
@ -127,5 +129,12 @@ collection, the introduction states:
In practice, JSON libraries discard the order of object literals in In practice, JSON libraries discard the order of object literals in
parsed JSON text and make no guarantees about the order of generated parsed JSON text and make no guarantees about the order of generated
object literals. This again makes hash tables a good choice for object literals, usually using a hash table of some flavor as a natural
representing as JSON object literals. choice. We therefore use do so as well.
@subsection{Naming Conventions}
Some names in this library use ``jsexpr'' and some use ``json''. The
rationale that the first is used for our representation, and the second
is used as information that is received from or sent to the outside
world.