author Ken Williams Sat, 16 Feb 2008 23:22:15 +0000 (17:22 -0600) committer Rafael Garcia-Suarez Mon, 18 Feb 2008 11:10:13 +0000 (11:10 +0000)
From: "Ken Williams" <kenahoo@gmail.com>
Message-ID: <6a7ee8cc0802162122r4e59b93boee18b1f045b8954d@mail.gmail.com>

p4raw-id: //depot/perl@33328

 pod/perlop.pod patch | blob | blame | history

index cf2cfc7..1827757 100644 (file)
@@ -260,9 +260,11 @@ X<*>
Binary "/" divides two numbers.
X</> X<slash>

-Binary "%" computes the division remainder of two numbers.  Given integer
+Binary "%" is the modulo operator, which computes the division
+remainder of its first argument with respect to its second argument.
+Given integer
operands C<\$a> and C<\$b>: If C<\$b> is positive, then C<\$a % \$b> is
-C<\$a> minus the largest multiple of C<\$b> that is not greater than
+C<\$a> minus the largest multiple of C<\$b> less than or equal to
C<\$a>.  If C<\$b> is negative, then C<\$a % \$b> is C<\$a> minus the
smallest multiple of C<\$b> that is not less than C<\$a> (i.e. the
result will be less than or equal to zero).  If the operands
@@ -273,14 +275,14 @@ the integer portion of C<\$a> and C<\$b> will be used in the operation
If the absolute value of the right operand (C<abs(\$b)>) is greater than
or equal to C<(UV_MAX + 1)>, "%" computes the floating-point remainder
C<\$r> in the equation C<(\$r = \$a - \$i*\$b)> where C<\$i> is a certain
-integer that makes C<\$r> should have the same sign as the right operand
+integer that makes C<\$r> have the same sign as the right operand
C<\$b> (B<not> as the left operand C<\$a> like C function C<fmod()>)
and the absolute value less than that of C<\$b>.
Note that when C<use integer> is in scope, "%" gives you direct access
-to the modulus operator as implemented by your C compiler.  This
+to the modulo operator as implemented by your C compiler.  This
operator is not as well defined for negative operands, but it will
execute faster.
-X<%> X<remainder> X<modulus> X<mod>
+X<%> X<remainder> X<modulo> X<mod>

Binary "x" is the repetition operator.  In scalar context or if the left
operand is not enclosed in parentheses, it returns a string consisting 