Module: Mongoid::Equality

Included in:
Composable
Defined in:
lib/mongoid/equality.rb

Overview

This module contains the behavior of Mongoid’s clone/dup of documents.

Instance Method Summary collapse

Instance Method Details

#<=>(other) ⇒ Integer

Default comparison is via the string version of the id.

Examples:

Compare two documents.

person <=> other_person

Parameters:

  • other (Document) —

    The document to compare with.

Returns:

  • (Integer) —

    -1, 0, 1.

Since:

  • 1.0.0



19
20
21
 
# File 'lib/mongoid/equality.rb', line 19

def <=>(other)
  attributes["_id"].to_s <=> other.attributes["_id"].to_s
end

#==(other) ⇒ true, false

Performs equality checking on the document ids. For more robust equality checking please override this method.

Examples:

Compare for equality.

document == other

Parameters:

  • other (Document, Object) —

    The other object to compare with.

Returns:

  • (true, false) —

    True if the ids are equal, false if not.

Since:

  • 1.0.0



34
35
36
37
 
# File 'lib/mongoid/equality.rb', line 34

def ==(other)
  self.class == other.class &&
      attributes["_id"] == other.attributes["_id"]
end

#===(other) ⇒ true, false

Performs class equality checking.

Examples:

Compare the classes.

document === other

Parameters:

  • other (Document, Object) —

    The other object to compare with.

Returns:

  • (true, false) —

    True if the classes are equal, false if not.

Since:

  • 1.0.0



49
50
51
 
# File 'lib/mongoid/equality.rb', line 49

def ===(other)
  other.class == Class ? self.class === other : self == other
end

#eql?(other) ⇒ true, false

Delegates to ==. Used when needing checks in hashes.

Examples:

Perform equality checking.

document.eql?(other)

Parameters:

  • other (Document, Object) —

    The object to check against.

Returns:

  • (true, false) —

    True if equal, false if not.

Since:

  • 1.0.0



63
64
65
 
# File 'lib/mongoid/equality.rb', line 63

def eql?(other)
  self == (other)
end