NAME

apply - Run a command many times with different arguments

SYNOPSIS

apply [-a c] [-d] [-#] command argument [argument ...]

DESCRIPTION

apply runs the given command multiple times, with different arguments. Without arguments, command is run once for each argument. If the command contains strings of the form %d+, the d'th next unused argument will be substituted.

OPTIONS

apply accepts the following options:

-a c

Use the character c instead of % for interpolation of arguments.

-d

Print each constructed command but do not execute it.

-#

If an option of the form -# is given, with # a number, apply uses that many arguments for each call of command. If -0 is given as an option, command is called without arguments, and it is called as many times as there are arguments following command on the command line.

This option is ignored if command has magic %d+ sequences.

ENVIRONMENT

The working of apply is not influenced by any environment variables.

CAVEATS

When command has magic %d+ sequences, the string after interpolation of the arguments is handed to a shell for interpretation of meta characters. This shell is determined by Perl, during its building phase, and is typically /bin/sh -c on Unix platforms.

BUGS

apply does not honor the users $SHELL environment variable.

REVISION HISTORY

$Log: apply,v $
Revision 1.2  2004/08/05 14:17:43  cwest
cleanup, new version number on website

Revision 1.1  2004/07/23 20:09:59  cwest
initial import

Revision 1.1  1999/02/27 03:36:18  abigail
Initial revision

AUTHOR

The Perl implementation of apply was written by Abigail, perlpowertools@abigail.be.

COPYRIGHT and LICENSE

This program is copyright by Abigail 1999.

This program is free and open software. You may use, copy, modify, distribute and sell this program (and any modified variants) in any way you wish, provided you do not restrict others to do the same.