summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--av.h8
1 files changed, 4 insertions, 4 deletions
diff --git a/av.h b/av.h
index 526699066b..a4263b4b2d 100644
--- a/av.h
+++ b/av.h
@@ -131,8 +131,8 @@ might be called directly:
Or it might be called implicitly when the first element is stored:
(void)av_store(av, 0, sv);
-Whether or not any as-yet-untouched array elements are initialized by
-av_extend depends upon whether the array is "real" at the time.
+Unused array elements are typically initialized by av_extend, but this
+is undesirable and will not be the case for some specific arrays.
In contrast, when an AV is created for immediate population with a known
(or likely) number of elements, it is more efficient to immediately
@@ -148,8 +148,8 @@ newAV_alloc_x does not initialize the array elements - and so the
expectation is that all should be initialized elsewhere prior to any
potentials reads. newAV_alloc_xz does initialize the array elements.
-As an example, the following examples all result in an array that can
-fit four elements (indexes 0 .. 3):
+The following examples all result in an array that can fit four elements
+(indexes 0 .. 3):
AV *av = newAV();
av_extend(av, 1);