Document multi-dimensional array emulation.
authorIan Goodacre <ian@debian.lan>
Fri, 10 Jun 2011 09:47:38 +0000 (21:47 +1200)
committerFather Chrysostomos <sprout@cpan.org>
Fri, 10 Jun 2011 16:49:03 +0000 (09:49 -0700)
pod/perldata.pod

index 28e4ecc..9673ed9 100644 (file)
@@ -697,6 +697,20 @@ You can also subscript a list to get a single element from it:
 
     $dir = (getpwnam("daemon"))[7];
 
+=head2 Multi-dimensional array emulation
+
+Multidimensional arrays may be emulated by subscripting a hash with a
+list. The elements of the list are joined with the subscript separator
+(see C<$;> in L<perlvar>).
+
+    $foo{$a,$b,$c}
+
+is equivalent to
+
+    $foo{join($;, $a, $b, $c)}
+
+The default subscript separator is "\034", the same as SUBSEP in B<awk>.
+
 =head2 Slices
 X<slice> X<array, slice> X<hash, slice>