"Using References" in perlref says:

Using References

That's it for creating references. By now you're probably dying to know how to use references to get back to your long-lost data. There are several basic methods.

1. Anywhere you'd put an identifier (or chain of identifiers) as part of a variable or subroutine name, you can replace the identifier with a simple scalar variable containing a reference of the correct type:

[snip]

2. Anywhere you'd put an identifier (or chain of identifiers) as part of a variable or subroutine name, you can replace the identifier with a BLOCK returning a reference of the correct type. In other words, the previous examples could be written like this:

[snip]

The first documents $#$aref, the second $#{$aref}. $aref->$#* is documented by example further down in the "Postfix Dereference Syntax" section.

I like the distillation of the rules I came up with long ago at References Quick Reference. If that distillation or something substantially similar hasn't made it into the Perl docs, I think it would be a useful addition. I certainly still often see the same questions repeated that were a big motivation for me publishing that.

Yes, Ikegami's table isn't bad either.

But I think as a minimum $# should be listed as one of the examples in perlref#Using-References

IMHO the only syntactic option missing.

Cheers Rolf

_{(addicted to the Perl Programming Language and ☆☆☆☆ :)}

The documentation for using references is at http://perldoc.perl.org/perlref.html#Using-References. It does not mention $# at all, but points 1 and 2 there address exactly what you are asking about. In general, the documentation does not strive to cover every possible combination of interacting features.

> It does not mention $# at all

well in these 5.20 docs this is mentioned  $aref->$#*; # same as $#{ $aref }

> but points 1 and 2 there address exactly what you are asking about.

Anywhere you'd put an identifier (or chain of identifiers) as part of a variable or subroutine name

So I suppose $# counts as a special function since its not a variable, but addressing an attribute of a variable?

Thanks anyway! :)

Cheers Rolf

_{(addicted to the Perl Programming Language and ☆☆☆☆ :)}

Special function? No.

The a in @a is the identifier part of the variable name; the documentation addresses anywhere you'd put that a, which includes $#a.

Update: hmm, it does say "as part of a variable...name", implying it would only work if $#a is a considered a variable. I shy away from that because, even though it is an assignable lvalue, it really is just an attribute of an array variable. So the doc could use a minor tweak.

In any case, $#$arrayref / $#{$arrayref} ought to be added to the examples there.

--
A math joke: r = | |csc(θ)|+|sec(θ)| |-| |csc(θ)|-|sec(θ)| |

$#a is no more a function and as much a variable as $a and @a.

FWIW this might help.

I scanned perldata and it only mentions the classic use with an @array symbol (i.e. $#array ), but no array ref (i.e. $#$aref or $#{$aref} ).

IIRC does perldsc show code using the trick, but w/o worded explanation.

Is it meant to be an undocumented feature, which can possibly change in the future?

Cheers Rolf

_{(addicted to the Perl Programming Language and ☆☆☆☆ :)}