From: Gurusamy Sarathy <gsar@cpan.org>
Date: Mon, 7 Feb 2000 07:09:08 +0000 (+0000)
Subject: clarify behavior of vec() when arguments are off the end of the
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=fac7034317257ca372dae1fbecbc49d69a7c7d66;p=p5sagit%2Fp5-mst-13.2.git

clarify behavior of vec() when arguments are off the end of the
string (from M J T Guy)

p4raw-id: //depot/perl@5014
---

diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod
index c9efcd1..88cbb0a 100644
--- a/pod/perlfunc.pod
+++ b/pod/perlfunc.pod
@@ -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'>.