Changeset 2404

Timestamp:

Nov 22, 2004, 7:03:47 PM (22 years ago)

Author:

jhoblitt

Message:

add array & hash subscripts

File:

• trunk/doc/misc/perlCodeConventions.tex (modified) (2 diffs)

trunk/doc/misc/perlCodeConventions.tex

@@ -1 @@
-%%% $Id: perlCodeConventions.tex,v 1.27 2004-11-23 04:24:52 jhoblitt Exp $
+%%% $Id: perlCodeConventions.tex,v 1.28 2004-11-23 05:03:47 jhoblitt Exp $
 \documentclass[panstarrs]{panstarrs}
 
@@ -1082 +1082 @@
 \end{verbatim}
 
+\subsubsection{Array Subscripts}
+
+Use ``cuddled'' brackets \code{[]} when accessing an array element.
+
+\begin{verbatim}
+    $foo[-1];                           # Correct
+    (someSub($foo))[1];                 # Correct
+    $foo[ 6 ];                          # AVOID!
+\end{verbatim}
+
+\subsubsection{Hash Subscripts}
+
+Use ``cuddled'' brackets \CODE.{}. when accessing a hash element.  It is
+acceptable to use ``bare-words'' as a hash key (Note: this rule may be subject
+to change).
+
+\begin{verbatim}
+    $foo{bar};                          # Correct
+    $foo{$baz};                         # Correct
+    $foo{'fiddle'};                     # Correct
+    $foo{ lish };                       # AVOID!
+    $foo{ 'zab' };                      # AVOID!
+\end{verbatim}
+
+
 %------------------------------------------------------------------------------
 \appendix                               %Begin Appendices