1Shellwords(3)         User Contributed Perl Documentation        Shellwords(3)
2
3
4

NAME

6       Text::Shellwords
7

SYNOPSIS

9         use Text::Shellwords;
10         @words = shellwords($line);
11         @words = shellwords(@lines);
12

DESCRIPTION

14       This used to be a wrapper around shellwords.pl, but has now been super‐
15       seded by Text::ParseWords.  Use that module insteade.  If you use this
16       module, it will simply report the shellwords() function from
17       Text::ParseWords.
18
19       The old description follows:
20
21       This is a thin wrapper around the shellwords.pl package, which comes
22       preinstalled with Perl.  This module imports a single subroutine,
23       shellwords().  The shellwords() routine parses lines of text and
24       returns a set of tokens using the same rules that the Unix shell does
25       for its command-line arguments.  Tokens are separated by whitespace,
26       and can be delimited by single or double quotes.  The module also
27       respects backslash escapes.
28
29       If called with one or more arguments, shellwords() will treat each
30       argument as a line of text, parse it, and return the tokens.
31
32       Note that the old behavior of parsing $_ if no arguments are provided
33       is no longer supported. Sorry.
34

BUGS

36       Please report them.
37

SEE ALSO

39       shellwords.pl
40

AUTHOR

42       Lincoln Stein <lstein@cshl.org>.
43
44       Copyright (c) 2001 Cold Spring Harbor Laboratory
45
46       This library is free software; you can redistribute it and/or modify it
47       under the same terms as Perl itself.  See DISCLAIMER.txt for dis‐
48       claimers of warranty.
49
50
51
52perl v5.8.8                       2005-11-10                     Shellwords(3)