Newcomen

Description A static content generator.
Newcomen > Perl Modules > Newcomen::Util::List
Source

Index


NAME ^

Newcomen::Util::List - List related utility functions.

SYNOPSIS ^

use Newcomen::Util::List;

# Create a list with all elements of the source list doubled:
my @doubled = Newcomen::Util::List::dbl (@list);

# Zip two lists:
my @zipped = Newcomen::Util::List::zip (@list_1, @list_2);

DESCRIPTION ^

This package provides a few utility functions dealing with lists. Note that all functions may be imported into the package using Newcomen::Util::List:

use Newcomen::Util::List qw( dbl zip );

No function is exported by default.

FUNCTIONS ^

dbl

Toggle source:   dbl

sub dbl {     map { ($_)         x 2 }       @_           }
my @doubled = dbl (@list);

Returns a list that contains all elements of the input list twice, i.e. if the input list is (1, 2, 3), the resulting list will be (1, 1, 2, 2, 3, 3).

zip

Toggle source:   zip

sub zip { @_ [map {  $_, $_ + @_ / 2 } 0 .. (@_ / 2 - 1)] }
my @zipped = zip (@list_1, @list_2);

Zips the two input lists. For example, zipping the lists ('a', 'b', 'c') and (1, 2, 3) will result in the list ('a', 1, 'b', 2, 'c', 3).

VERSION ^

This is version 2014052501.

AUTHOR ^

Stefan Goebel - newcomen {at} subtype {dot} de

COPYRIGHT AND LICENSE ^

Copyright 2013-2014 Stefan Goebel.

This file is part of Newcomen.

Newcomen is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the license, or (at your option) any later version.

Newcomen is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Newcomen. If not, see <http://www.gnu.org/licenses/>.