ruby--ruby/spec/ruby/language/precedence_spec.rb

448 lines
13 KiB
Ruby

require_relative '../spec_helper'
require_relative 'fixtures/precedence'
# Specifying the behavior of operators in combination could
# lead to combinatorial explosion. A better way seems to be
# to use a technique from formal proofs that involve a set of
# equivalent statements. Suppose you have statements A, B, C.
# If they are claimed to be equivalent, this can be shown by
# proving that A implies B, B implies C, and C implies A.
# (Actually any closed circuit of implications.)
#
# Here, we can use a similar technique where we show starting
# at the top that each level of operator has precedence over
# the level below (as well as showing associativity within
# the precedence level).
=begin
Excerpted from 'Programming Ruby: The Pragmatic Programmer's Guide'
Second Edition by Dave Thomas, Chad Fowler, and Andy Hunt, page 324
Table 22.4. Ruby operators (high to low precedence)
Method Operator Description
-----------------------------------------------------------------------
:: .
x* [ ] [ ]= Element reference, element set
x ** Exponentiation
x ! ~ + - Not, complement, unary plus and minus
(method names for the last two are +@ and -@)
x * / % Multiply, divide, and modulo
x + - Plus and minus
x >> << Right and left shift
x & “And” (bitwise for integers)
x ^ | Exclusive “or” and regular “or” (bitwise for integers)
x <= < > >= Comparison operators
x <=> == === != =~ !~ Equality and pattern match operators (!=
and !~ may not be defined as methods)
&& Logical “and”
|| Logical “or”
.. ... Range (inclusive and exclusive)
? : Ternary if-then-else
= %= /= -= += |= &= Assignment
>>= <<= *= &&= ||= **=
defined? Check if symbol defined
not Logical negation
or and Logical composition
if unless while until Expression modifiers
begin/end Block expression
-----------------------------------------------------------------------
* Operators marked with 'x' in the Method column are implemented as methods
and can be overridden (except != and !~ as noted). (But see the specs
below for implementations that define != and !~ as methods.)
** These are not included in the excerpted table but are shown here for
completeness.
=end
# -----------------------------------------------------------------------
# It seems that this table is not correct anymore
# The correct table derived from MRI's parse.y is as follows:
#
# Operator Assoc Description
#---------------------------------------------------------------
# ! ~ + > Not, complement, unary plus
# ** > Exponentiation
# - > Unary minus
# * / % < Multiply, divide, and modulo
# + - < Plus and minus
# >> << < Right and left shift
# & < “And” (bitwise for integers)
# ^ | < Exclusive “or” and regular “or” (bitwise for integers)
# <= < > >= < Comparison operators
# <=> == === != =~ !~ no Equality and pattern match operators (!=
# and !~ may not be defined as methods)
# && < Logical “and”
# || < Logical “or”
# .. ... no Range (inclusive and exclusive)
# ? : > Ternary if-then-else
# rescue < Rescue modifier
# = %= /= -= += |= &= > Assignment
# >>= <<= *= &&= ||= **=
# defined? no Check if symbol defined
# not > Logical negation
# or and < Logical composition
# if unless while until no Expression modifiers
# -----------------------------------------------------------------------
#
# [] and []= seem to fall out of here, as well as begin/end
#
# TODO: Resolve these two tables with actual specs. As the comment at the
# top suggests, these specs need to be reorganized into a single describe
# block for each operator. The describe block should include an example
# for associativity (if relevant), an example for any short circuit behavior
# (e.g. &&, ||, etc.) and an example block for each operator over which the
# instant operator has immediately higher precedence.
describe "Operators" do
it "! ~ + is right-associative" do
(!!true).should == true
(~~0).should == 0
(++2).should == 2
end
it "** is right-associative" do
(2**2**3).should == 256
end
it "** has higher precedence than unary minus" do
(-2**2).should == -4
end
it "unary minus is right-associative" do
(--2).should == 2
end
it "unary minus has higher precedence than * / %" do
class UnaryMinusTest; def -@; 50; end; end
b = UnaryMinusTest.new
(-b * 5).should == 250
(-b / 5).should == 10
(-b % 7).should == 1
end
it "treats +/- as a regular send if the arguments are known locals or block locals" do
a = PrecedenceSpecs::NonUnaryOpTest.new
a.add_num(1).should == [3]
a.sub_num(1).should == [1]
a.add_str.should == ['11']
a.add_var.should == [2]
end
it "* / % are left-associative" do
(2*1/2).should == (2*1)/2
# Guard against the Mathn library
# TODO: Make these specs not rely on specific behaviour / result values
# by using mocks.
guard -> { !defined?(Math.rsqrt) } do
(2*1/2).should_not == 2*(1/2)
end
(10/7/5).should == (10/7)/5
(10/7/5).should_not == 10/(7/5)
(101 % 55 % 7).should == (101 % 55) % 7
(101 % 55 % 7).should_not == 101 % (55 % 7)
(50*20/7%42).should == ((50*20)/7)%42
(50*20/7%42).should_not == 50*(20/(7%42))
end
it "* / % have higher precedence than + -" do
(2+2*2).should == 6
(1+10/5).should == 3
(2+10%5).should == 2
(2-2*2).should == -2
(1-10/5).should == -1
(10-10%4).should == 8
end
it "+ - are left-associative" do
(2-3-4).should == -5
(4-3+2).should == 3
binary_plus = Class.new(String) do
alias_method :plus, :+
def +(a)
plus(a) + "!"
end
end
s = binary_plus.new("a")
(s+s+s).should == (s+s)+s
(s+s+s).should_not == s+(s+s)
end
it "+ - have higher precedence than >> <<" do
(2<<1+2).should == 16
(8>>1+2).should == 1
(4<<1-3).should == 1
(2>>1-3).should == 8
end
it ">> << are left-associative" do
(1 << 2 << 3).should == 32
(10 >> 1 >> 1).should == 2
(10 << 4 >> 1).should == 80
end
it ">> << have higher precedence than &" do
(4 & 2 << 1).should == 4
(2 & 4 >> 1).should == 2
end
it "& is left-associative" do
class BitwiseAndTest; def &(a); a+1; end; end
c = BitwiseAndTest.new
(c & 5 & 2).should == (c & 5) & 2
(c & 5 & 2).should_not == c & (5 & 2)
end
it "& has higher precedence than ^ |" do
(8 ^ 16 & 16).should == 24
(8 | 16 & 16).should == 24
end
it "^ | are left-associative" do
class OrAndXorTest; def ^(a); a+10; end; def |(a); a-10; end; end
d = OrAndXorTest.new
(d ^ 13 ^ 16).should == (d ^ 13) ^ 16
(d ^ 13 ^ 16).should_not == d ^ (13 ^ 16)
(d | 13 | 4).should == (d | 13) | 4
(d | 13 | 4).should_not == d | (13 | 4)
end
it "^ | have higher precedence than <= < > >=" do
(10 <= 7 ^ 7).should == false
(10 < 7 ^ 7).should == false
(10 > 7 ^ 7).should == true
(10 >= 7 ^ 7).should == true
(10 <= 7 | 7).should == false
(10 < 7 | 7).should == false
(10 > 7 | 7).should == true
(10 >= 7 | 7).should == true
end
it "<= < > >= are left-associative" do
class ComparisonTest
def <=(a); 0; end;
def <(a); 0; end;
def >(a); 0; end;
def >=(a); 0; end;
end
e = ComparisonTest.new
(e <= 0 <= 1).should == (e <= 0) <= 1
(e <= 0 <= 1).should_not == e <= (0 <= 1)
(e < 0 < 1).should == (e < 0) < 1
(e < 0 < 1).should_not == e < (0 < 1)
(e >= 0 >= 1).should == (e >= 0) >= 1
(e >= 0 >= 1).should_not == e >= (0 >= 1)
(e > 0 > 1).should == (e > 0) > 1
(e > 0 > 1).should_not == e > (0 > 1)
end
it "<=> == === != =~ !~ are non-associative" do
-> { eval("1 <=> 2 <=> 3") }.should raise_error(SyntaxError)
-> { eval("1 == 2 == 3") }.should raise_error(SyntaxError)
-> { eval("1 === 2 === 3") }.should raise_error(SyntaxError)
-> { eval("1 != 2 != 3") }.should raise_error(SyntaxError)
-> { eval("1 =~ 2 =~ 3") }.should raise_error(SyntaxError)
-> { eval("1 !~ 2 !~ 3") }.should raise_error(SyntaxError)
end
it "<=> == === != =~ !~ have higher precedence than &&" do
(false && 2 <=> 3).should == false
(false && 3 == false).should == false
(false && 3 === false).should == false
(false && 3 != true).should == false
class FalseClass; def =~(o); o == false; end; end
(false && true =~ false).should == (false && (true =~ false))
(false && true =~ false).should_not == ((false && true) =~ false)
class FalseClass; undef_method :=~; end
(false && true !~ true).should == false
end
# XXX: figure out how to test it
# (a && b) && c equals to a && (b && c) for all a,b,c values I can imagine so far
it "&& is left-associative"
it "&& has higher precedence than ||" do
(true || false && false).should == true
end
# XXX: figure out how to test it
it "|| is left-associative"
it "|| has higher precedence than .. ..." do
(1..false||10).should == (1..10)
(1...false||10).should == (1...10)
end
it ".. ... are non-associative" do
-> { eval("1..2..3") }.should raise_error(SyntaxError)
-> { eval("1...2...3") }.should raise_error(SyntaxError)
end
it ".. ... have higher precedence than ? :" do
# Use variables to avoid warnings
from = 1
to = 2
# These are flip-flop, not Range instances
(from..to ? 3 : 4).should == 3
(from...to ? 3 : 4).should == 3
end
it "? : is right-associative" do
(true ? 2 : 3 ? 4 : 5).should == 2
end
def oops; raise end
it "? : has higher precedence than rescue" do
(true ? oops : 0 rescue 10).should == 10
end
# XXX: figure how to test it (problem similar to || associativity)
it "rescue is left-associative"
it "rescue has higher precedence than =" do
a = oops rescue 10
a.should == 10
# rescue doesn't have the same sense for %= /= and friends
end
it "= %= /= -= += |= &= >>= <<= *= &&= ||= **= are right-associative" do
a = b = 10
a.should == 10
b.should == 10
a = b = 10
a %= b %= 3
a.should == 0
b.should == 1
a = b = 10
a /= b /= 2
a.should == 2
b.should == 5
a = b = 10
a -= b -= 2
a.should == 2
b.should == 8
a = b = 10
a += b += 2
a.should == 22
b.should == 12
a,b = 32,64
a |= b |= 2
a.should == 98
b.should == 66
a,b = 25,13
a &= b &= 7
a.should == 1
b.should == 5
a,b=8,2
a >>= b >>= 1
a.should == 4
b.should == 1
a,b=8,2
a <<= b <<= 1
a.should == 128
b.should == 4
a,b=8,2
a *= b *= 2
a.should == 32
b.should == 4
a,b=10,20
a &&= b &&= false
a.should == false
b.should == false
a,b=nil,nil
a ||= b ||= 10
a.should == 10
b.should == 10
a,b=2,3
a **= b **= 2
a.should == 512
b.should == 9
end
it "= %= /= -= += |= &= >>= <<= *= &&= ||= **= have higher precedence than defined? operator" do
(defined? a = 10).should == "assignment"
(defined? a %= 10).should == "assignment"
(defined? a /= 10).should == "assignment"
(defined? a -= 10).should == "assignment"
(defined? a += 10).should == "assignment"
(defined? a |= 10).should == "assignment"
(defined? a &= 10).should == "assignment"
(defined? a >>= 10).should == "assignment"
(defined? a <<= 10).should == "assignment"
(defined? a *= 10).should == "assignment"
(defined? a &&= 10).should == "assignment"
(defined? a ||= 10).should == "assignment"
(defined? a **= 10).should == "assignment"
end
# XXX: figure out how to test it
it "defined? is non-associative"
it "defined? has higher precedence than not" do
# does it have sense?
(not defined? qqq).should == true
end
it "not is right-associative" do
(not not false).should == false
(not not 10).should == true
end
it "not has higher precedence than or/and" do
(not false and false).should == false
(not false or true).should == true
end
# XXX: figure out how to test it
it "or/and are left-associative"
it "or/and have higher precedence than if unless while until modifiers" do
(1 if 2 and 3).should == 1
(1 if 2 or 3).should == 1
(1 unless false and true).should == 1
(1 unless false or false).should == 1
(1 while true and false).should == nil # would hang upon error
(1 while false or false).should == nil
((raise until true and false) rescue 10).should == 10
(1 until false or true).should == nil # would hang upon error
end
# XXX: it seems to me they are right-associative
it "if unless while until are non-associative"
end