class ActiveRecord::QueryMethods::WhereChain

Parent:
Object

WhereChain objects act as placeholder for queries in which where does not have any parameter. In this case, where must be chained with not to return a new relation.

Public Class Methods

new(scope) Show source
# File activerecord/lib/active_record/relation/query_methods.rb, line 19
def initialize(scope)
  @scope = scope
end

Public Instance Methods

not(opts, *rest) Show source
# File activerecord/lib/active_record/relation/query_methods.rb, line 46
def not(opts, *rest)
  opts = sanitize_forbidden_attributes(opts)

  where_clause = @scope.send(:where_clause_factory).build(opts, rest)

  @scope.references!(PredicateBuilder.references(opts)) if Hash === opts
  @scope.where_clause += where_clause.invert
  @scope
end

Returns a new relation expressing WHERE + NOT condition according to the conditions in the arguments.

not accepts conditions as a string, array, or hash. See ActiveRecord::QueryMethods#where for more details on each format.

User.where.not("name = 'Jon'")
# SELECT * FROM users WHERE NOT (name = 'Jon')

User.where.not(["name = ?", "Jon"])
# SELECT * FROM users WHERE NOT (name = 'Jon')

User.where.not(name: "Jon")
# SELECT * FROM users WHERE name != 'Jon'

User.where.not(name: nil)
# SELECT * FROM users WHERE name IS NOT NULL

User.where.not(name: %w(Ko1 Nobu))
# SELECT * FROM users WHERE name NOT IN ('Ko1', 'Nobu')

User.where.not(name: "Jon", role: "admin")
# SELECT * FROM users WHERE name != 'Jon' AND role != 'admin'

© 2004–2018 David Heinemeier Hansson
Licensed under the MIT License.