Class | Sequel::SQL::ComplexExpression |
In: |
lib/sequel/sql.rb
|
Parent: | Expression |
Represents a complex SQL expression, with a given operator and one or more attributes (which may also be ComplexExpressions, forming a tree). This class is the backbone of the blockless filter support in Sequel.
This is an abstract class that is not that useful by itself. The subclasses BooleanExpression, NumericExpression, and StringExpression define the behavior of the DSL via operators.
OPERTATOR_INVERSIONS | = | {:AND => :OR, :OR => :AND, :< => :>=, :> => :<=, :<= => :>, :>= => :<, :'=' => :'!=' , :'!=' => :'=', :LIKE => :'NOT LIKE', :'NOT LIKE' => :LIKE, :~ => :'!~', :'!~' => :~, :IN => :'NOT IN', :'NOT IN' => :IN, :IS => :'IS NOT', :'IS NOT' => :IS, :'~*' => :'!~*', :'!~*' => :'~*', :NOT => :NOOP, :NOOP => :NOT, :ILIKE => :'NOT ILIKE', :'NOT ILIKE'=>:ILIKE} | A hash of the opposite for each operator symbol, used for inverting objects. | |
MATHEMATICAL_OPERATORS | = | [:+, :-, :/, :*] | Mathematical Operators used in NumericMethods | |
BITWISE_OPERATORS | = | [:&, :|, :^, :<<, :>>] | Mathematical Operators used in NumericMethods | |
INEQUALITY_OPERATORS | = | [:<, :>, :<=, :>=] | Inequality Operators used in InequalityMethods | |
BOOLEAN_OPERATOR_METHODS | = | {:& => :AND, :| =>:OR} | Hash of ruby operator symbols to SQL operators, used in BooleanMethods | |
IS_OPERATORS | = | [:IS, :'IS NOT'] | Operators that use IS, used for special casing to override literal true/false values | |
TWO_ARITY_OPERATORS | = | [:'=', :'!=', :LIKE, :'NOT LIKE', \ :~, :'!~', :'~*', :'!~*', :IN, :'NOT IN', :ILIKE, :'NOT ILIKE'] + \ INEQUALITY_OPERATORS + BITWISE_OPERATORS + IS_OPERATORS | Operator symbols that take exactly two arguments | |
N_ARITY_OPERATORS | = | [:AND, :OR, :'||'] + MATHEMATICAL_OPERATORS | Operator symbols that take one or more arguments | |
ONE_ARITY_OPERATORS | = | [:NOT, :NOOP, :'B~'] | Operator symbols that take one argument |
args | [R] | An array of args for this object |
op | [R] | The operator symbol for this object |
Set the operator symbol and arguments for this object to the ones given. Convert all args that are hashes or arrays with all two pairs to BooleanExpressions. Raise an error if the operator doesn‘t allow boolean input and a boolean argument is given. Raise an error if the wrong number of arguments for a given operator is used.
# File lib/sequel/sql.rb, line 92 92: def initialize(op, *args) 93: args.map!{|a| Sequel.condition_specifier?(a) ? SQL::BooleanExpression.from_value_pairs(a) : a} 94: case op 95: when *N_ARITY_OPERATORS 96: raise(Error, "The #{op} operator requires at least 1 argument") unless args.length >= 1 97: when *TWO_ARITY_OPERATORS 98: raise(Error, "The #{op} operator requires precisely 2 arguments") unless args.length == 2 99: when *ONE_ARITY_OPERATORS 100: raise(Error, "The #{op} operator requires a single argument") unless args.length == 1 101: else 102: raise(Error, "Invalid operator #{op}") 103: end 104: @op = op 105: @args = args 106: end