summaryrefslogtreecommitdiff
path: root/pod/perlapi.pod
diff options
context:
space:
mode:
authorRafael Garcia-Suarez <rgarciasuarez@gmail.com>2006-10-31 13:49:26 +0000
committerRafael Garcia-Suarez <rgarciasuarez@gmail.com>2006-10-31 13:49:26 +0000
commit1d51329b7b2db5dad38362dae2635cd5f623f6a3 (patch)
tree536b49cbb6c98fb034ff58dba5df65fc009e32d0 /pod/perlapi.pod
parente3f73d4edc1b72464d0a94ac202f6e1bd3daf149 (diff)
downloadperl-1d51329b7b2db5dad38362dae2635cd5f623f6a3.tar.gz
Make S_readpipe_override() compile with threads; regenerate perlapi.pod
p4raw-id: //depot/perl@29169
Diffstat (limited to 'pod/perlapi.pod')
-rw-r--r--pod/perlapi.pod12
1 files changed, 9 insertions, 3 deletions
diff --git a/pod/perlapi.pod b/pod/perlapi.pod
index 64bb6b8b49..3ea050e943 100644
--- a/pod/perlapi.pod
+++ b/pod/perlapi.pod
@@ -188,9 +188,15 @@ Found in file av.c
=item av_fill
X<av_fill>
-Ensure than an array has a given number of elements, equivalent to
+Set the highest index in the array to the given number, equivalent to
Perl's C<$#array = $fill;>.
+The number of elements in the an array will be C<fill + 1> after
+av_fill() returns. If the array was previously shorter then the
+additional elements appended are set to C<PL_sv_undef>. If the array
+was longer, then the excess elements are freed. C<av_fill(av, -1)> is
+the same as C<av_clear(av)>.
+
void av_fill(AV* ar, I32 fill)
=for hackers
@@ -199,8 +205,8 @@ Found in file av.c
=item av_len
X<av_len>
-Returns the highest index in the array. Returns -1 if the array is
-empty.
+Returns the highest index in the array. The number of elements in the
+array is C<av_len(av) + 1>. Returns -1 if the array is empty.
I32 av_len(const AV* ar)