This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
clarify behavior of vec() when arguments are off the end of the
authorGurusamy Sarathy <gsar@cpan.org>
Mon, 7 Feb 2000 07:09:08 +0000 (07:09 +0000)
committerGurusamy Sarathy <gsar@cpan.org>
Mon, 7 Feb 2000 07:09:08 +0000 (07:09 +0000)
string (from M J T Guy)

p4raw-id: //depot/perl@5014

pod/perlfunc.pod

index c9efcd1..88cbb0a 100644 (file)
@@ -5273,9 +5273,13 @@ to give the expression the correct precedence as in
 
     vec($image, $max_x * $x + $y, 8) = 3;
 
-Vectors created with C<vec> can also be manipulated with the logical
-operators C<|>, C<&>, and C<^>, which will assume a bit vector
-operation is desired when both operands are strings.
+If the selected element is off the end of the string, the value 0 is
+returned.  If an element off the end of the string is written to,
+Perl will first extend the string with sufficiently many zero bytes.
+
+Strings created with C<vec> can also be manipulated with the logical
+operators C<|>, C<&>, C<^>, and C<~>.  These operators will assume a bit
+vector operation is desired when both operands are strings.
 See L<perlop/"Bitwise String Operators">.
 
 The following code will build up an ASCII string saying C<'PerlPerlPerl'>.