method

validates_inclusion_of

Importance_3
Ruby on Rails latest stable (v2.1.0) - 1 note - Class: ActiveModel::Validations::ClassMethods
  • v1.0.0
  • v1.1.0
  • v1.1.1
  • v1.1.2
  • v1.1.3
  • v1.1.4
  • v1.1.5
  • v1.1.6
  • v1.2.0
  • v1.2.1
  • v1.2.2
  • v1.2.3
  • v1.2.4
  • v1.2.5
  • v1.2.6
  • v2.0.0
  • v2.0.1
  • v2.0.2
  • v2.0.3
  • 2.1.0 (0)
  • What's this?
validates_inclusion_of(*attr_names) public

Validates whether the value of the specified attribute is available in a particular enumerable object.

  class Person < ActiveRecord::Base
    validates_inclusion_of :gender, :in => %w( m f ), :message => "woah! what are you then!??!!"
    validates_inclusion_of :age, :in => 0..99
    validates_inclusion_of :format, :in => %w( jpg gif png ), :message => "extension %s is not included in the list"
  end

Configuration options:

  • :in - An enumerable object of available items
  • :message - Specifies a custom error message (default is: "is not included in the list")
  • :allow_nil - If set to true, skips this validation if the attribute is null (default is: false)
  • :allow_blank - If set to true, skips this validation if the attribute is blank (default is: false)
  • :if - Specifies a method, proc or string to call to determine if the validation should occur (e.g. :if => :allow_validation, or :if => Proc.new { |user| user.signup_step > 2 }). The method, proc or string should return or evaluate to a true or false value.
  • :unless - Specifies a method, proc or string to call to determine if the validation should not occur (e.g. :unless => :skip_validation, or :unless => Proc.new { |user| user.signup_step <= 2 }). The method, proc or string should return or evaluate to a true or false value.
Show source
Register or log in to add new notes.
August 25, 2008
2 thanks

%w(true false) != [true, false]

Don“t confuse the right:

 validates_inclusion_of :published, :in => [true, false]

with the wrong:

 validates_inclusion_of :published, :in => %w(true false)

cause:

 %w(true false) == ["true", "false"]