kotovalexarian-likes-github/ruby--ruby
1
0
Fork 0
mirror of https://github.com/ruby/ruby.git synced 2022-11-09 12:17:21 -05:00
Code Releases Activity

[flori/json] RDoc enhancements

Browse source 
7bee2c7c13
This commit is contained in:
BurdetteLamar 2020-06-25 12:09:28 -05:00 • committed by Hiroshi SHIBATA
parent fe10323a35
commit 99980b3034
No known key found for this signature in database
GPG key ID: F9CF13417264FAC2
2 changed files with 3 additions and 28 deletions
Download patch file Download diff file Expand all files Collapse all files

4
ext/json/lib/json.rb
View file

@ -150,8 +150,8 @@ require 'json/common'
#
# When the source is a Ruby \Integer or \Float, JSON.generate returns
# a \String containing a \JSON number:
# JSON.generate(Integer(0)) # => "0""
# JSON.generate(Float(1.0)) # => "1.0"
# JSON.generate(42) # => "42"
# JSON.generate(0.42) # => "0.42"
#
# When the source is a Ruby \String, JSON.generate returns
# a \String containing a \JSON string (with double-quotes):

27
ext/json/lib/json/common.rb
View file

@ -201,9 +201,6 @@ module JSON
# source = '[NaN, Infinity, -Infinity]'
# ruby = JSON.parse(source, {allow_nan: true})
# ruby # => [NaN, Infinity, -Infinity]
# With a truthy value:
# ruby = JSON.parse(source, {allow_nan: :foo})
# ruby # => [NaN, Infinity, -Infinity]
#
# ====== Output Options
#
@ -232,12 +229,6 @@ module JSON
# Use class \OpenStruct:
# ruby = JSON.parse(source, {object_class: OpenStruct})
# ruby # => #<OpenStruct a="foo", b=1.0, c=true, d=false, e=nil>
# Try class \Object:
# # Raises NoMethodError (undefined method `[]=' for #<Object:>):
# JSON.parse(source, {object_class: Object})
# Bad value:
# # Raises TypeError (wrong argument type Symbol (expected Class)):
# JSON.parse(source, {object_class: :foo})
#
# ---
#
@ -319,7 +310,6 @@ module JSON
# obj = ["foo", 1.0, true, false, nil]
# json = JSON.generate(obj)
# json # => "[\"foo\",1.0,true,false,null]"
# json.class # => String
#
# When +obj+ is a
# {Hash-convertible object}[doc/implicit_conversion_rdoc.html#label-Hash-Convertible+Objects],
@ -346,7 +336,7 @@ module JSON
# JSON.generate(JSON::MinusInfinity)
#
# Allow:
# ruby = [JSON::NaN, JSON::Infinity, JSON::MinusInfinity]
# ruby = [Float::NaN, Float::Infinity, Float::MinusInfinity]
# JSON.generate(ruby, allow_nan: true) # => "[NaN,Infinity,-Infinity]"
#
# ---
@ -362,10 +352,6 @@ module JSON
# # Raises JSON::NestingError (nesting of 2 is too deep):
# JSON.generate(obj, max_nesting: 2)
#
# Bad Value:
# # Raises TypeError (can't convert Symbol into Hash):
# JSON.generate(obj, :foo)
#
# ====== Output Options
#
# The default formatting options generate the most compact
@ -427,22 +413,11 @@ module JSON
#
# ====== Exceptions
#
# Raises an exception if +obj+ is not a valid Ruby object:
# # Raises NameError (uninitialized constant Foo):
# JSON.generate(Foo)
# # Raises NameError (undefined local variable or method `foo' for main:Object):
# JSON.generate(foo)
#
# Raises an exception if +obj+ contains circular references:
# a = []; b = []; a.push(b); b.push(a)
# # Raises JSON::NestingError (nesting of 100 is too deep):
# JSON.generate(a)
#
# Raises an exception if +opts is not a
# {Hash-convertible object}[doc/implicit_conversion_rdoc.html#label-Hash-Convertible+Objects]
# (implementing +to_hash+):
# # Raises TypeError (can't convert Symbol into Hash):
# JSON.generate('x', :foo)
def generate(obj, opts = nil)
if State === opts
state, opts = opts, nil