- Changed the behavior of the Math.map() method. Now it maps a given …

…value from one range to another.

Example:
	# map the value 300 from range 0-600 to range 0-256
	say Math.map(300, 0, 600, 0, 256);	# 128

- The old Math.map() method is now available as Math.map_range()

Example:
	# map 10 values inside the range from 0 to 1
	say Math.map_range(10, 0, 1).to_a;

- Updated .pod files

lib/Sidef/Math/Math.pm

@@ -252,21 +252,31 @@ package Sidef::Math::Math {
     *rangeSum = \&range_sum;
 
     sub map {
+        my ($self, $value, $in_min, $in_max, $out_min, $out_max) = @_;
+
+        $value = $value->get_value;
+
+        $in_min = $in_min->get_value;
+        $in_max = $in_max->get_value;
+
+        $out_min = $out_min->get_value;
+        $out_max = $out_max->get_value;
+
+        Sidef::Types::Number::Number->new(($value - $in_min) * ($out_max - $out_min) / ($in_max - $in_min) + $out_min);
+    }
+
+    sub map_range {
         my ($self, $amount, $from, $to) = @_;
 
         $amount = $amount->get_value;
         $from   = $from->get_value;
         $to     = $to->get_value;
 
-        my $step = ($to - $from) / $amount;
-        $step == 0 && return (Sidef::Types::Array::Array->new());
-
-        my @values;
-        for (my $i = $from ; $i <= $to ; $i += $step) {
-            push @values, Sidef::Types::Number::Number->new($i);
-        }
-
-        Sidef::Types::Array::Array->new(@values);
+        Sidef::Types::Array::RangeNumber->new(
+                                              from => $from,
+                                              to   => $to,
+                                              step => ($to - $from) / $amount,
+                                             );
     }
 
     sub number_to_percentage {

lib/Sidef/Math/Math.pod

@@ -445,14 +445,17 @@ Return the
 
 =head2 map
 
-Math.map(I<amount>, I<from>, I<to>) -> I<Array>
+Math.map() -> I<Obj>
 
-This function returns an I<amount> of numbers mapped between I<from> and I<to>,
-each number having the same distance between each other.
+Return the
+
+=cut
 
-    Math.map(8, 1, 3);   # returns: [1, 1.25, 1.5, 1.75, 2, 2.25, 2.5, 2.75]
+=head2 map_range
 
-Returns an object of type: C<Sidef::Types::Array::Array>
+Math.map_range() -> I<Obj>
+
+Return the
 
 =cut
 

lib/Sidef/Types/Array/RangeNumber.pod

@@ -81,6 +81,14 @@ Return the
 
 =cut
 
+=head2 reverse
+
+RangeNumber.reverse() -> I<Obj>
+
+Return the
+
+=cut
+
 =head2 step
 
 RangeNumber.step() -> I<Obj>

lib/Sidef/Types/Array/RangeString.pod

@@ -73,6 +73,14 @@ Return the
 
 =cut
 
+=head2 reverse
+
+RangeString.reverse() -> I<Obj>
+
+Return the
+
+=cut
+
 =head2 to_a
 
 RangeString.to_a() -> I<Obj>

lib/Sidef/Types/Number/Complex.pod

@@ -258,6 +258,8 @@ Complex.nok() -> I<Obj>
 
 Return the
 
+Aliases: I<binomial>
+
 =cut
 
 =head2 not

lib/Sidef/Types/Number/Number.pod

@@ -636,6 +636,8 @@ Number.nok() -> I<Obj>
 
 Return the
 
+Aliases: I<binomial>
+
 =cut
 
 =head2 npow

lib/Sidef/Types/String/String.pod

@@ -760,7 +760,7 @@ String.to() -> I<Obj>
 
 Return the
 
-Aliases: I<...()>, I<..^()>, I<upto>, I<upTo>
+Aliases: I<...()>, I<..^()>, I<upto>, I<upTo>, I<range>
 
 =cut