Added docs for methods floor, ceiling, round and truncate in class Complex

Author: Jan-Olof Hendig

doc/Type/Complex.pod

@@ -101,4 +101,71 @@ Usage:
 Returns a two-element list of the polar coordinates for this value,
 i.e. magnitude and angle in radians.
 
+=head2 method floor
+
+Defined as:
+
+    method floor(Complex:D:) returns Complex:D
+
+Usage:
+
+    COMPLEX.floor
+
+Returns C<self.re.floor + self.im.floor>. That is, each of the real and
+imaginary parts is rounded to the highest integer not greater than
+the value of that part.
+
+    say (1.2-3.8i).floor;           # 1-4i
+
+=head2 method ceiling
+
+Defined as:
+
+    method ceiling(Complex:D:) returns Complex:D
+
+Usage:
+
+    COMPLEX.ceiling
+
+Returns C<self.re.ceiling + self.im.ceiling>. That is, each of the real and 
+imaginary parts is rounded to the lowest integer not less than the value
+of that part.
+
+    say (1.2-3.8i).ceiling;         # 2-3i
+
+=head2 method round
+
+Defined as:
+
+    multi method round(Complex:D:) returns Complex:D
+    multi method round(Complex:D: Real() $scale) returns Complex:D
+
+Usage:
+
+    COMPLEX.round
+    COMPLEX.round($scale)
+
+With no arguments, rounds both the real and imaginary parts to the nearest
+integer and returns a new C<Complex> number. If C<$scale> is given, rounds both
+parts of the invocant to the nearest multiple of C<$scale>. Uses the same
+algorithm as L<Real.round|/type/Real#method_round> on each part of the number.
+
+    say (1.2-3.8i).round;           # 1-4i
+    say (1.256-3.875i).round(0.1);  # 1.3-3.9i
+
+=head2 method truncate
+
+Defined as:
+
+    method truncate(Complex:D:) returns Complex:D
+
+Usage:
+
+    COMPLEX.truncate
+
+Removes the fractional part of both the real and imaginary parts of the
+number, using L<Real.truncate|/type/Real#method_truncate>, and returns the result as a new C<Complex>.
+
+    say (1.2-3.8i).truncate;        # 1-3i
+
 =end pod