Module: Mongoid::Matcher::ElemMatch Private

Defined in:
lib/mongoid/matcher/elem_match.rb

Overview

This module is part of a private API. You should avoid using this module if possible, as it may be removed or be changed in the future.

In-memory matcher for $elemMatch expression.

Class Method Summary collapse

Class Method Details

.matches?(exists, value, condition) ⇒ true | false, Boolean

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns whether a value satisfies an $elemMatch expression.

Parameters:

  • exists (true | false)

    Not used.

  • value (Object | Array<Object>)

    The value to check.

  • expr (Hash)

    The $elemMatch condition predicate.

Returns:

  • (true | false)

    Whether the value matches.

  • (Boolean)


21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
# File 'lib/mongoid/matcher/elem_match.rb', line 21

module_function def matches?(exists, value, condition)
  unless Hash === condition
    raise Errors::InvalidQuery, "$elemMatch requires a Hash operand: #{Errors::InvalidQuery.truncate_expr(condition)}"
  end
  if Array === value && !value.empty?
    value.any? do |v|
      ElemMatchExpression.matches?(v, condition)
    end
  else
    # Validate the condition is valid, even though we will never attempt
    # matching it.
    condition.each do |k, v|
      k = k.to_s
      if k.start_with?('$')
        begin
          ExpressionOperator.get(k)
        rescue Mongoid::Errors::InvalidExpressionOperator
          begin
            FieldOperator.get(k)
          rescue Mongoid::Errors::InvalidFieldOperator => exc
            raise Mongoid::Errors::InvalidElemMatchOperator.new(exc.operator)
          end
        end
      end
    end
    false
  end
end