ActiveRecord::Result

This class encapsulates a result returned from calling #exec_query on any database connection adapter. For example:

result = ActiveRecord::Base.connection.exec_query('SELECT id, title, body FROM posts')
result # => #<ActiveRecord::Result:0xdeadbeef>

# Get the column names of the result:
result.columns
# => ["id", "title", "body"]

# Get the record values of the result:
result.rows
# => [[1, "title_1", "body_1"],
      [2, "title_2", "body_2"],
      ...
     ]

# Get an array of hashes representing the result (column => value):
result.to_hash
# => [{"id" => 1, "title" => "title_1", "body" => "body_1"},
      {"id" => 2, "title" => "title_2", "body" => "body_2"},
      ...
     ]

# ActiveRecord::Result also includes Enumerable.
result.each do |row|
  puts row['title'] + " " + row['body']
end
Methods
#
E
F
I
L
N
T
Included Modules
Attributes
[R] column_types
[R] columns
[R] rows
Class Public methods
new(columns, rows, column_types = {})
# File activerecord/lib/active_record/result.rb, line 37
def initialize(columns, rows, column_types = {})
  @columns      = columns
  @rows         = rows
  @hash_rows    = nil
  @column_types = column_types
end
Instance Public methods
[](idx)
# File activerecord/lib/active_record/result.rb, line 79
def [](idx)
  hash_rows[idx]
end
each()

Calls the given block once for each element in row collection, passing row as parameter.

Returns an Enumerator if no block is given.

# File activerecord/lib/active_record/result.rb, line 53
def each
  if block_given?
    hash_rows.each { |row| yield row }
  else
    hash_rows.to_enum { @rows.size }
  end
end
empty?()

Returns true if there are no records, otherwise false.

# File activerecord/lib/active_record/result.rb, line 70
def empty?
  rows.empty?
end
first()

Returns the first record from the rows collection. If the rows collection is empty, returns nil.

# File activerecord/lib/active_record/result.rb, line 85
def first
  return nil if @rows.empty?
  Hash[@columns.zip(@rows.first)]
end
initialize_copy(other)
# File activerecord/lib/active_record/result.rb, line 106
def initialize_copy(other)
  @columns      = columns.dup
  @rows         = rows.dup
  @column_types = column_types.dup
  @hash_rows    = nil
end
last()

Returns the last record from the rows collection. If the rows collection is empty, returns nil.

# File activerecord/lib/active_record/result.rb, line 92
def last
  return nil if @rows.empty?
  Hash[@columns.zip(@rows.last)]
end
length()

Returns the number of elements in the rows array.

# File activerecord/lib/active_record/result.rb, line 45
def length
  @rows.length
end
to_ary()

Returns an array of hashes representing each row record.

# File activerecord/lib/active_record/result.rb, line 75
def to_ary
  hash_rows
end
to_hash()

Returns an array of hashes representing each row record.

# File activerecord/lib/active_record/result.rb, line 62
def to_hash
  hash_rows
end