How to read Perl command-line arguments

Perl FAQ: How do I read command-line arguments in Perl?

Note: If you want to handle simple Perl command line arguments, such as filenames and strings, this tutorial shows how to do that. If you want to handle command-line options (flags) in your Perl scripts (like -h or --help), my Perl getopts command line options/flags tutorial is what you need.

Back to top

Perl command line args and the @ARGV array

With Perl, command-line arguments are stored in a special array named @ARGV. So you just need to read from that array to access your script’s command-line arguments.

ARGV array elements: In the ARGV array, $ARGV[0] contains the first argument, $ARGV[1] contains the second argument, etc. So if you’re just looking for one command line argument you can test for $ARGV[0], and if you’re looking for two you can also test for $ARGV[1], and so on.

ARGV array size: The variable $#ARGV is the subscript of the last element of the @ARGV array, and because the array is zero-based, the number of arguments given on the command line is $#ARGV + 1.

Back to top

Example 1: A typical Perl command line args example

A typical Perl script that uses command-line arguments will (a) test for the number of command line arguments the user supplied and then (b) attempt to use them. Here’s a simple Perl script named that expects to see two command-line arguments, a person’s first name and last name, and then prints them:

#!/usr/bin/perl -w

# (1) quit unless we have the correct number of command-line args
$num_args = $#ARGV + 1;
if ($num_args != 2) {
    print "\nUsage: first_name last_name\n";

# (2) we got two command line args, so assume they are the
# first name and last name

print "Hello, $first_name $last_name\n";

This is fairly straightforward, where adding 1 to $#ARGV strikes me as the only really unusual thing.

To test this script on a Unix/Linux system, just create a file named, then issue this command to make the script executable:

chmod +x

Then run the script like this:

./ Alvin Alexander

Or, if you want to see the usage statement, run the script without any command line arguments, like this:

Back to top

Example 2: Perl command line arguments in a for loop

For a second example, here’s how you might work through the command line arguments using a Perl for loop:

#  PROGRAM:  #

$numArgs = $#ARGV + 1;
print "thanks, you gave me $numArgs command-line arguments:\n";

foreach $argnum (0 .. $#ARGV) {
    print "$ARGV[$argnum]\n";

Running the example Perl command line program

To demonstrate how this works, if you run this Perl command line args program from a Unix command-line like this:

./ 1 2 3 4

or, from a Windows/DOS command-line like this

perl 1 2 3 4

you’ll get this result:

thanks, you gave me 4 command-line arguments:

As you can see, it prints all the command line arguments you supply to the Perl program.

... this post is sponsored by my books ...

Back to top Back to top



You can also use this:

$numArgs = @ARGV; #counts the number of elements in @ARGV in scalar context  

instead of:

$numArgs = $#ARGV + 1;

Also you can use the Perl map operator:

map { print "$_\n" } @ARGV;

instead of:

foreach $argnum (0 .. $#ARGV) {
  print "$ARGV[$argnum]\n"; 

print "$_\n";
} also quite easy ;-)


I find it easier most of the time to use shift:
my variable = shift;
will read the next command line argument.