summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--numeric.c52
1 files changed, 40 insertions, 12 deletions
diff --git a/numeric.c b/numeric.c
index dfe6a1f849..7f6a5f036c 100644
--- a/numeric.c
+++ b/numeric.c
@@ -664,11 +664,33 @@ num_modulo(VALUE x, VALUE y)
/*
* call-seq:
- * num.remainder(numeric) -> real
+ * remainder(other) -> real_number
*
- * <code>x.remainder(y)</code> means <code>x-y*(x/y).truncate</code>.
+ * Returns the remainder after dividing +self+ by +other+.
+ *
+ * Of the Core and Standard Library classes,
+ * only Float and Rational use this implementation.
+ *
+ * Examples:
+ *
+ * 11.0.remainder(4) # => 3.0
+ * 11.0.remainder(-4) # => 3.0
+ * -11.0.remainder(4) # => -3.0
+ * -11.0.remainder(-4) # => -3.0
+ *
+ * 12.0.remainder(4) # => 0.0
+ * 12.0.remainder(-4) # => 0.0
+ * -12.0.remainder(4) # => -0.0
+ * -12.0.remainder(-4) # => -0.0
+ *
+ * 13.0.remainder(4.0) # => 1.0
+ * 13.0.remainder(Rational(4, 1)) # => 1.0
+ *
+ * Rational(13, 1).remainder(4) # => (1/1)
+ * Rational(13, 1).remainder(-4) # => (1/1)
+ * Rational(-13, 1).remainder(4) # => (-1/1)
+ * Rational(-13, 1).remainder(-4) # => (-1/1)
*
- * See Numeric#divmod.
*/
static VALUE
@@ -3816,19 +3838,25 @@ rb_int_modulo(VALUE x, VALUE y)
/*
* call-seq:
- * int.remainder(numeric) -> real
+ * remainder(other) -> real_number
+ *
+ * Returns the remainder after dividing +self+ by +other+.
*
- * Returns the remainder after dividing +int+ by +numeric+.
+ * Examples:
*
- * <code>x.remainder(y)</code> means <code>x-y*(x/y).truncate</code>.
+ * 11.remainder(4) # => 3
+ * 11.remainder(-4) # => 3
+ * -11.remainder(4) # => -3
+ * -11.remainder(-4) # => -3
*
- * 5.remainder(3) #=> 2
- * -5.remainder(3) #=> -2
- * 5.remainder(-3) #=> 2
- * -5.remainder(-3) #=> -2
- * 5.remainder(1.5) #=> 0.5
+ * 12.remainder(4) # => 0
+ * 12.remainder(-4) # => 0
+ * -12.remainder(4) # => 0
+ * -12.remainder(-4) # => 0
+ *
+ * 13.remainder(4.0) # => 1.0
+ * 13.remainder(Rational(4, 1)) # => (1/1)
*
- * See Numeric#divmod.
*/
static VALUE