archive/ruby
1
0
Fork 0
mirror of https://github.com/ruby/ruby.git synced 2025-08-23 21:14:23 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 4

[flori/json] Enhanced RDoc for JSON.dump (#443)

Browse source 
* Enhanced RDoc for JSON.dump
03f1699ec4
This commit is contained in:
Burdette Lamar 2020-08-14 00:03:12 -05:00 • committed by Hiroshi SHIBATA
parent 3d5e833998
commit 71f64e15b9
Notes: git 2020-09-25 17:29:10 +09:00
1 changed files with 23 additions and 11 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -590,21 +590,33 @@ module JSON
:escape_slash => false, :escape_slash => false,
} }
# Dumps _obj_ as a JSON string, i.e. calls generate on the object and returns # :call-seq:
# the result. # JSON.dump(obj, io = nil, limit = nil)
# #
# If anIO (an IO-like object or an object that responds to the write method) # Dumps +obj+ as a \JSON string, i.e. calls generate on the object and returns the result.
# was given, the resulting JSON is written to it.
# #
# If the number of nested arrays or objects exceeds _limit_, an ArgumentError # The default options can be changed via method JSON.dump_default_options.
# exception is raised. This argument is similar (but not exactly the
# same!) to the _limit_ argument in Marshal.dump.
# #
# The default options for the generator can be changed via the # - Argument +io+, if given, should respond to method +write+;
# dump_default_options method. # the \JSON \String is written to +io+, and +io+ is returned.
# If +io+ is not given, the \JSON \String is returned.
# - Argument +limit+, if given, is passed to JSON.generate as option +max_nesting+.
# #
# This method is part of the implementation of the load/dump interface of # ---
# Marshal and YAML. #
# When argument +io+ is not given, returns the \JSON \String generated from +obj+:
# obj = {foo: [0, 1], bar: {baz: 2, bat: 3}, bam: :bad}
# json = JSON.dump(obj)
# json # => "{\"foo\":[0,1],\"bar\":{\"baz\":2,\"bat\":3},\"bam\":\"bad\"}"
#
# When argument +io+ is given, writes the \JSON \String to +io+ and returns +io+:
# path = 't.json'
# File.open(path, 'w') do |file|
# JSON.dump(obj, file)
# end # => #<File:t.json (closed)>
# puts File.read(path)
# Output:
# {"foo":[0,1],"bar":{"baz":2,"bat":3},"bam":"bad"}
def dump(obj, anIO = nil, limit = nil) def dump(obj, anIO = nil, limit = nil)
if anIO and limit.nil? if anIO and limit.nil?
anIO = anIO.to_io if anIO.respond_to?(:to_io) anIO = anIO.to_io if anIO.respond_to?(:to_io)