

    \filetitle{array}{Insert an array with user data in report}{report/array}

	\paragraph{Syntax}
 
 \begin{verbatim}
 P.array(CAP,DATA)
 \end{verbatim}
 \paragraph{Input arguments}
 
 \begin{itemize}
 \item
   \texttt{P} {[} struct {]} - Report object created by the
   \href{report/new}{\texttt{report.new}} function.
 \item
   \texttt{CAP} {[} char \textbar{} cellstr {]} - Caption (title,
   subtitle) displayed at the top of the matrix.
 \item
   \texttt{DATA} {[} cell {]} - Cell array with input data; numeric and
   text entries are allowed.
 \end{itemize}
 \paragraph{Options}
 
 \begin{itemize}
 \item
   \texttt{'arrayStretch='} {[} numeric \textbar{} \emph{\texttt{1.15}}
   {]} - (Inheritable from parent objects) Stretch between lines in the
   array (in pts).
 \item
   \texttt{'captionTypeface='} {[} cellstr \textbar{} char \textbar{}
   \emph{\texttt{'\textbackslash{}large\textbackslash{}bfseries'}} {]} -
   \LaTeX\\format commands for typesetting the array caption; the
   subcaption format can be entered as the second cell in a cell array.
 \item
   \texttt{'colWidth' {[} numeric \textbar{}}NaN` {]} - (Inheritable from
   parent objects) Width of the array columns; if NaN the column width
   will be automatically adjusted.
 \item
   \texttt{'format='} {[} char \textbar{} \emph{\texttt{'\%.2f'}} {]} -
   (Inheritable from parent objects) Numeric format string; see help on
   the built-in \texttt{sprintf} function.
 \item
   \texttt{'footnote='} {[} char \textbar{} \emph{empty} {]} - Footnote
   at the array title; only shows if the title is non-empty.
 \item
   \texttt{'heading='} {[} char \textbar{} \emph{empty} {]} -
   (Inheritable from parent objects) User-supplied heading, i.e.~an extra
   row or rows at the top of the array.
 \item
   \texttt{'inf='} {[} char \textbar{}
   \emph{\texttt{'\$\textbackslash{}infty\$'}} {]} - (Inheritable from
   parent objects) \LaTeX~string that will be used to typeset
   \texttt{Inf}s.
 \item
   \texttt{'long='} {[} \texttt{true} \textbar{} \emph{\texttt{false}}
   {]} - (Inheritable from parent objects) If \texttt{true}, the array
   may stretch over more than one page.
 \item
   \texttt{'longFoot='} {[} char \textbar{} \emph{empty} {]} -
   (Inheritable from parent objects) Footnote that appears at the bottom
   of the array (if it is longer than one page) on each page except the
   last one; works only with \texttt{'long='} \texttt{true}.
 \item
   \texttt{'longFootPosition='} {[} \texttt{'centre'} \textbar{}
   \emph{\texttt{'left'}} \textbar{} \texttt{'right'} {]} - (Inheritable
   from parent objects) Horizontal alignment of the footnote in long
   arrays; works only with \texttt{'long='} \texttt{true}.
 \item
   \texttt{'nan='} {[} char \textbar{}
   \emph{\texttt{'\$\textbackslash{}cdots\$'}} {]} - (Inheritable from
   parent objects) \LaTeX~string that will be used to typeset
   \texttt{NaN}s.
 \item
   \texttt{'pureZero='} {[} char \textbar{} \emph{empty} {]} -
   (Inheritable from parent objects) \LaTeX~string that will be used to
   typeset pure zero entries; if empty the zeros will be printed using
   the current numeric format.
 \item
   \texttt{'printedZero='} {[} char \textbar{} \emph{empty} {]} -
   (Inheritable from parent objects) \LaTeX~string that will be used to
   typeset the entries that would appear as zero under the current
   numeric format used; if empty these numbers will be printed using the
   current numeric format.
 \item
   \texttt{'separator='} {[} char \textbar{}
   \emph{\texttt{'\textbackslash{}medskip\textbackslash{}par'}} {]} -
   (Inheritable from parent objects) \LaTeX~commands that will be
   inserted after the array.
 \item
   \texttt{'sideways='} {[} \texttt{true} \textbar{}
   \emph{\texttt{false}} {]} - (Inheritable from parent objects) Print
   the array rotated by 90 degrees.
 \item
   \texttt{'tabcolsep='} {[} \texttt{NaN} \textbar{} numeric {]} -
   (Inheritable from parent objects) Space between columns in the array,
   measured in em units; \texttt{NaN} means the \LaTeX~default.
 \item
   \texttt{'typeface='} {[} char \textbar{} \emph{empty} {]} - (Not
   inheritable from parent objects) \LaTeX~code specifying the typeface
   for the array as a whole; it must use the declarative forms (such as
   \texttt{\textbackslash{}itshape}) and not the command forms (such as
   \texttt{\textbackslash{}textit\{...\}}).
 \end{itemize}
 \paragraph{Generic options}
 
 See help on \href{report/Contents}{generic options} in report objects.
 
 \paragraph{Description}
 
 \paragraph{Example}


