Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib/String/Range
t
.gitignore
.travis.yml
Build.PL
Changes
INSTALL
LICENSE
MANIFEST
MANIFEST.SKIP
META.json
META.yml
Makefile.PL
README
changes.mkdn
install.mkdn
readme.mkdn

readme.mkdn

NAME

String::Range::Expand - Expand range-like strings

SYNOPSIS

use String::Range::Expand;

print "$_\n" for expand_range('host[aa-ac,^ab,ae][01-04,^02-03]');

# Prints ...
    # hostaa01
    # hostaa04
    # hostac01
    # hostac04
    # hostae01
    # hostae04

DESCRIPTION

This module provides functions to expand a string that contains range-like expressions. This is something that is usually useful when working with hostnames, but can be used elsewhere too.

FUNCTIONS

expand_range($string)

my @list = expand_range('...');

This function accept a single string, evaluates expressions in those strings and returns a list with all available permutations. Ranges with limits are expanded using the Range Operator.

my @list = expand_range('[aa-ad]'); # This is identical to ('aa' .. 'ad')

The following formats are recognized and evaluated

my @list = expand_range('foo[bar,baz]');        # Comma separated list
my @list = expand_range('foo[aa-ad,^ab]');      # Negated element
my @list = expand_range('foo[aa-ag,^ab-ad]');   # Negated range

expand_expr(@array)

my @list = expand_expr('foo-bar[01-03] host[aa-ad,^ab]Z[01-04,^02-03].name');

This runs expand_range against every range-like expression detected in the argument list

SEE ALSO

  • SSH::Batch

    This is an extremely useful distribution if you are working with hostnames. String::Range::Expand was inspired by this distribution, and provides only a subset of features of SSH::Batch

  • String::Glob::Permute

    Pretty similar, but does not evaluate alphabetical ranges

  • Text::Glob::Expand

    Like String::Glob::Permute, it does not evaluate alphabetical ranges. But it does provide some additional functionality like setting upper limits and formatting.

BUGS AND LIMITATIONS

This module does not attempt to limit the number of permutations for an expression.

Please report any bugs or feature requests at https://github.com/mithun/perl-string-range-expand/issues

AUTHOR

Mithun Ayachit mithun@cpan.org

LICENSE AND COPYRIGHT

Copyright (c) 2014, Mithun Ayachit. All rights reserved.

This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See perlartistic.

Something went wrong with that request. Please try again.