instance method `pluck`

Ruby on Rails 3.2.22.5

Since v3.2.22.5

Available in: v3.2.22.5 v4.0.13 v4.1.16 v4.2.9 v5.2.8.1 v6.0.6 v6.1.7.10 v7.0.10 v7.1.6 v7.2.3 v8.0.4 v8.1.2

Compare with:

pluck(column_name)

This method is designed to perform select by a single column as direct SQL query Returns Array with values of the specified column name The values has same data type as column.

Examples:

Person.pluck(:id) # SELECT people.id FROM people
Person.uniq.pluck(:role) # SELECT DISTINCT role FROM people
Person.where(:confirmed => true).limit(5).pluck(:id)

Parameters

column_name req

Source

# File activerecord/lib/active_record/relation/calculations.rb, line 179
    def pluck(column_name)
      if column_name.is_a?(Symbol) && column_names.include?(column_name.to_s)
        column_name = "#{connection.quote_table_name(table_name)}.#{connection.quote_column_name(column_name)}"
      end

      result = klass.connection.exec_query(select(column_name).to_sql)
      last_column = result.columns.last

      result.map do |attributes|
        klass.type_cast_attribute(last_column, klass.initialize_attributes(attributes))
      end
    end

Defined in activerecord/lib/active_record/relation/calculations.rb line 179 · View on GitHub · Improve this page · Find usages on GitHub

Defined in ActiveRecord::Calculations

Signature

Parameters