develooper Front page | perl.perl5.porters | Postings from October 2013

Re: [perl #120386] av_len documentation

Thread Previous | Thread Next
Karl Williamson
October 30, 2013 05:27
Re: [perl #120386] av_len documentation
Message ID:
On 10/27/2013 03:56 PM, (via RT) wrote:
> # New Ticket Created by
> # Please include the string:  [perl #120386]
> # in the subject line of all future correspondence about this issue.
> # <URL: >
> This is a bug report for perl from,
> generated with the help of perlbug 1.39 running under perl 5.18.1.
> -----------------------------------------------------------------
> [Please describe your issue here]
> The av_len documentation for 5.18.1 says:
>     Note that the return value is +1 what its name implies it returns; and
>     hence differs in meaning from what the similarly named "sv_len" returns.
> That seems wrong. Shouldn't it be:
>     Note that the return value +1 is what its name implies it returns
> Or maybe even less confusing:
>     Note that, unlike the name implies, it returns the highest index in the array, so to get the size
>     of the array you need to use C<av_len (av) + 1>.

I wrote the original text.  I realize that I do not have the talent to 
explain things easily, so I often look at what I've written and think of 
a better way to say it, or appreciate other people cleaning it up.  But 
this time, I don't see anything wrong with the original.  sv_len of a 
length 1 string will return 1.  av_len of a length 1 array will return 
0.  I think it is worth pointing out that their behaviors do not correspond.

In your first proposal, the word 'is' is missing, so it is not correct 

I like your second proposal, but again, I think it useful to contrast 
this behavior with sv_len.

Thread Previous | Thread Next Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at | Group listing | About