.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Array::Group 3pm"
.TH Array::Group 3pm "2022-10-13" "perl v5.34.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
Array::Group \- Convert an array into array of arrayrefs of uniform size N.
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
.Vb 1
\&  use Array::Group qw( :all );
\&
\&  @sample = ( 1 .. 10 );
\&  $rowsize = 3;
\&
\&  ngroup $rowsize => \e@sample ;
\&  # yields
\&         (
\&            [   1,   2,   3   ],
\&            [   4,   5,   6   ],
\&            [   7,   8,   9   ],
\&            [   10   ]
\&          );
\&
\&  dissect $rowsize => \e@sample ;
\&  # yields
\&         (
\&            [   1,   5,   9   ],
\&            [   2,   6,  10   ],
\&            [   3,   7   ],
\&            [   4,   8   ]
\&          );
.Ve
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
The \f(CW\*(C`ngroup\*(C'\fR method reformats a list into a list of
arrayrefs. It is often used for formatting data into \s-1HTML\s0 tables, amongst
other things.
.PP
\&\f(CW\*(C`dissect()\*(C'\fR returns a list of lists where the first
element of each sublist will be one of the first elements of the
source list, and the last element will be one of the last.
This behaviour is much more useful when the input list is sorted.
.PP
The key difference between the two methods is that \f(CW\*(C`dissect()\*(C'\fR takes
elements from the start of the list provided and pushes them onto each
of the subarrays sequentially, rather than simply dividing the list
into discrete chunks.
.PP
Both methods can be called as either functions or class methods (to
ensure compatibility with previous releases), and the array to be
reformed can be passed as a reference.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
.IP "\(bu" 4
Array::Reform
.SH "AUTHOR"
.IX Header "AUTHOR"
Currently maintained by Mike Accardo, <accardo@cpan.org>
.PP
Original author Terrence Monroe Brannon.
.SS "\s-1CONTRIBUTORS\s0"
.IX Subsection "CONTRIBUTORS"
I would like to thank Alexandr Ciornii for his help in upgrading this
distribution's format. He took me from using a \fItest.pl\fR file to using
the \fIt/\fR directory and removed some old crufty things that were not needed.
He also upgraded the Makefile.PL.
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
.Vb 2
\&    Copyright (c) 2015 Mike Accardo
\&    Copyright (c) 1999\-2014 Terrence Brannon
.Ve
.PP
This library is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.