Maintenance Ruby 3.4 gets fixes, but no new features. Switch to Ruby 4.0 →
instance method
Net::HTTPResponse#read_body
() -> ::String
(::Net::HTTPResponse::_Dest dest) -> ::String
() { (::String) -> void } -> ::String
read_body(dest = nil, &block)
lib/net/http/response.rb
View on GitHub ↗
# File tmp/rubies/ruby-3.4.1/lib/net/http/response.rb, line 355
def read_body(dest = nil, &block)
if @read
raise IOError, "#{self.class}\#read_body called twice" if dest or block
return @body
end
to = procdest(dest, block)
stream_check
if @body_exist
read_body_0 to
@body = to
else
@body = nil
end
@read = true
return if @body.nil?
case enc = @body_encoding
when Encoding, false, nil
# Encoding: force given encoding
# false/nil: do not force encoding
else
# other value: detect encoding from body
enc = detect_encoding(@body)
end
@body.force_encoding(enc) if enc
@body
end
Gets the entity body returned by the remote HTTP server.
If a block is given, the body is passed to the block, and the body is provided in fragments, as it is read in from the socket.
If dest argument is given, response is read into that variable, with dest#<< method (it could be String or IO, or any other object responding to <<).
Calling this method a second or subsequent time for the same HTTPResponse object will return the value already read.
Example
http.request_get('/index.html') {|res| puts res.read_body } http.request_get('/index.html') {|res| p res.read_body.object_id # 538149362 p res.read_body.object_id # 538149362 } # using iterator http.request_get('/index.html') {|res| res.read_body do |segment| print segment end }