method

create

Ruby on Rails latest stable (v7.1.3.2) - 3 notes - Class: ActiveRecord::Base

1.0.0 (0)
1.1.6 (0)
1.2.6 (0)
2.0.3 (11)
2.1.0 (11)
2.2.1 (0)
2.3.8 (0)
3.0.0 (0)
3.0.9 (-1)
3.1.0 (13)
3.2.1
3.2.8
3.2.13
4.0.2
4.1.8
4.2.1
4.2.7
4.2.9
5.0.0.1
5.1.7
5.2.3
6.0.0
6.1.3.1
6.1.7.7
7.0.0
7.1.3.2
7.1.3.4
What's this?

Method deprecated or moved

This method is deprecated or moved on the latest stable version. The last existing version (v3.1.0) is shown here.

These similar methods exist in v7.1.3.2:

create(attributes = nil, options = {}, &block) public

Creates an object (or multiple objects) and saves it to the database, if validations pass. The resulting object is returned whether the object was saved successfully to the database or not.

The attributes parameter can be either be a Hash or an Array of Hashes. These Hashes describe the attributes on the objects that are to be created.

create respects mass-assignment security and accepts either :as or :without_protection options in the options parameter.

Examples

# Create a single new object
User.create(:first_name => 'Jamie')

# Create a single new object using the :admin mass-assignment security role
User.create({ :first_name => 'Jamie', :is_admin => true }, :as => :admin)

# Create a single new object bypassing mass-assignment security
User.create({ :first_name => 'Jamie', :is_admin => true }, :without_protection => true)

# Create an Array of new objects
User.create([{ :first_name => 'Jamie' }, { :first_name => 'Jeremy' }])

# Create a single object and pass it into a block to set other attributes.
User.create(:first_name => 'Jamie') do |u|
  u.is_admin = false
end

# Creating an Array of new objects using a block, where the block is executed for each object:
User.create([{ :first_name => 'Jamie' }, { :first_name => 'Jeremy' }]) do |u|
  u.is_admin = false
end

Show source

# File activerecord/lib/active_record/base.rb, line 504
      def create(attributes = nil, options = {}, &block)
        if attributes.is_a?(Array)
          attributes.collect { |attr| create(attr, options, &block) }
        else
          object = new(attributes, options)
          yield(object) if block_given?
          object.save
          object
        end
      end