class ActiveRecord::Result

Parent:: Объект
Included modules:: Enumerable

Этот класс инкапсулирует результат, возвращаемый при вызове #exec_query на любом адаптере подключения к базе данных. Например:

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_a
# => [{"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

Атрибуты

column_types[R]

columns[R]

rows[R]

Публичные методы класса

new(columns, rows, column_types = {}) Показать исходный код

# File activerecord/lib/active_record/result.rb, line 39
def initialize(columns, rows, column_types = {})
  @columns      = columns
  @rows         = rows
  @hash_rows    = nil
  @column_types = column_types
end

Публичные методы экземпляра

[](idx) Показать исходный код

# File activerecord/lib/active_record/result.rb, line 91
def [](idx)
  hash_rows[idx]
end

each() { |row| ... } Показать исходный код

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

Вызывает переданный блок один раз для каждого элемента в коллекции строк, передавая строку в качестве параметра.

Возвращает Enumerator, если блок не передан.

empty?() Показать исходный код

# File activerecord/lib/active_record/result.rb, line 80
def empty?
  rows.empty?
end

Возвращает true, если записей нет, в противном случае false.

first() Показать исходный код

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

Возвращает первую запись из коллекции строк. Если коллекция строк пуста, возвращает nil.

includes_column?(name) Показать исходный код

# File activerecord/lib/active_record/result.rb, line 47
def includes_column?(name)
  @columns.include? name
end

Возвращает true, если этот результат набора содержит столбец с именем name

initialize_copy(other) Показать исходный код

# File activerecord/lib/active_record/result.rb, line 127
def initialize_copy(other)
  @columns      = columns.dup
  @rows         = rows.dup
  @column_types = column_types.dup
  @hash_rows    = nil
end

last() Показать исходный код

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

Возвращает последнюю запись из коллекции строк. Если коллекция строк пуста, возвращает nil.

length() Показать исходный код

# File activerecord/lib/active_record/result.rb, line 52
def length
  @rows.length
end

Возвращает количество элементов в массиве строк.

to_a()

Псевдоним для: to_ary

to_ary() Показать исходный код

# File activerecord/lib/active_record/result.rb, line 85
def to_ary
  hash_rows
end

Возвращает массив хешей, представляющих каждую строку записи.

Также алиас: to_a

to_hash() Показать исходный код

# File activerecord/lib/active_record/result.rb, line 68
    def to_hash
      ActiveSupport::Deprecation.warn(<<-MSG.squish)
        `ActiveRecord::Result#to_hash` has been renamed to `to_a`.
        `to_hash` is deprecated and will be removed in Rails 6.1.
      MSG
      to_a
    end