summaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorDaniel Bovensiepen <[email protected]>2012-05-27 04:34:47 +0800
committerDaniel Bovensiepen <[email protected]>2012-05-27 04:34:47 +0800
commitc1faad90ec8768b9364638da4bb56b47b87c6661 (patch)
tree71f41a76b5055b987872d1a97364ce36a516680b
parentf6d539eabd305d40afe18639d2e19e0fb8dafc55 (diff)
downloadmruby-c1faad90ec8768b9364638da4bb56b47b87c6661.tar.gz
mruby-c1faad90ec8768b9364638da4bb56b47b87c6661.zip
Add documentation to Comparable
-rw-r--r--mrblib/compar.rb52
1 files changed, 44 insertions, 8 deletions
diff --git a/mrblib/compar.rb b/mrblib/compar.rb
index 3badf57de..9f2ab887d 100644
--- a/mrblib/compar.rb
+++ b/mrblib/compar.rb
@@ -1,5 +1,15 @@
+##
+# Comparable
+#
+# ISO 15.3.3
module Comparable
- # 15.3.3.2.1
+
+ ##
+ # Return true if +self+ is less
+ # than +other+. Otherwise return
+ # false.
+ #
+ # ISO 15.3.3.2.1
def < other
cmp = self <=> other
if cmp.nil?
@@ -11,7 +21,12 @@ module Comparable
end
end
- # 15.3.3.2.2
+ ##
+ # Return true if +self+ is less
+ # than or equal to +other+.
+ # Otherwise return false.
+ #
+ # ISO 15.3.3.2.2
def <= other
cmp = self <=> other
if cmp.nil?
@@ -23,7 +38,12 @@ module Comparable
end
end
- # 15.3.3.2.3
+ ##
+ # Return true if +self+ is equal
+ # to +other+. Otherwise return
+ # false.
+ #
+ # ISO 15.3.3.2.3
def == other
cmp = self <=> other
if cmp == 0
@@ -33,7 +53,12 @@ module Comparable
end
end
- # 15.3.3.2.4
+ ##
+ # Return true if +self+ is greater
+ # than +other+. Otherwise return
+ # false.
+ #
+ # ISO 15.3.3.2.4
def > other
cmp = self <=> other
if cmp.nil?
@@ -45,9 +70,14 @@ module Comparable
end
end
- # 15.3.3.2.5
+ ##
+ # Return true if +self+ is greater
+ # than or equal to +other+.
+ # Otherwise return false.
+ #
+ # ISO 15.3.3.2.5
def >= other
- cmp = self <=> other
+ cmp = self <=> other
if cmp.nil?
false
elsif cmp >= 0
@@ -57,8 +87,14 @@ module Comparable
end
end
- # 15.3.3.2.6
- def between?(min,max)
+ ##
+ # Return true if +self+ is greater
+ # than or equal to +min+ and
+ # less than or equal to +max+.
+ # Otherwise return false.
+ #
+ # ISO 15.3.3.2.6
+ def between?(min, max)
if self < min or self > max
false
else