apply(1) [mojave man page]

APPLY(1)						    BSD General Commands Manual 						  APPLY(1)

NAME

     apply -- apply a command to a set of arguments

SYNOPSIS

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

DESCRIPTION

     The apply utility runs the named command on each argument argument in turn.

     Character sequences of the form ``%d'' in command, where 'd' is a digit from 1 to 9, are replaced by the d'th following unused argument.  In
     this case, the largest digit number of arguments are discarded for each execution of command.

     The options are as follows:

     -#      Normally arguments are taken singly; the optional number -# specifies the number of arguments to be passed to command.  If the number
	     is zero, command is run, without arguments, once for each argument.

	     If any sequences of ``%d'' occur in command, the -# option is ignored.

     -a c    The use of the character '%' as a magic character may be changed with the -a option.

     -d      Display the commands that would have been executed, but do not actually execute them.

ENVIRONMENT

     The following environment variable affects the execution of apply:

     SHELL  Pathname of shell to use.  If this variable is not defined, the Bourne shell is used.

EXAMPLES

     apply echo a*
	    is similar to ls(1);
     apply -2 cmp a1 b1 a2 b2 a3 b3
	    compares the `a' files to the `b' files;
     apply -0 who 1 2 3 4 5
	    runs who(1) 5 times; and
     apply 'ln %1 /usr/joe' *
	    links all files in the current directory to the directory /usr/joe.

FILES

     /bin/sh  default shell

AUTHORS

     Rob Pike

BUGS

     Shell metacharacters in command may have bizarre effects; it is best to enclose complicated commands in single quotes ('').

HISTORY

     The apply command appeared in 4.2BSD.

BSD
								   April 4, 1994							       BSD

apply(1)						      General Commands Manual							  apply(1)

NAME

       apply - Applies a command to a set of arguments

SYNOPSIS

       apply [-acharacter] [-number] command argument...

       The apply command runs the specified command on each argument in turn.

OPTIONS

       Identifies  the	character  used instead of the % (percent sign) to designate argument substitution strings.  Specifies the number of argu-
       ments to be passed to command.

DESCRIPTION

       Normally, arguments are chosen individually; the optional number specifies the number of arguments to be passed to command. If number is  0
       (zero), command is run without arguments once for each argument.

       If you include character sequences of the form %n (where n is a digit from 1 to 9) in command, they are replaced by the nth unused argument
       following command when command is executed.  If any such sequences occur, number is ignored, and the number of arguments passed to  command
       is the maximum value of n in command.

       You  can specify a character other than % (percent sign) to designate argument substitution character strings with the -a option; for exam-
       ple, -a@ would indicate that the sequences @1 and @2 were to be replaced by the first and second unused arguments following command.

NOTES

       Shell metacharacters in command may have undesirable effects; it is best to enclose complicated commands in '  ' (single quotes).

       There is no way to pass a % (percent sign) followed immediately by any number if % is the argument expansion character.

EXAMPLES

       The following command is similar to ls: apply echo * The following command compares the file a1 to the file b1, a2 to b2, and so on:  apply
       -2 cmp a1 b1 a2 b2 ...  The following command runs who 5 times: apply -0 who 1 2 3 4 5 The following command links all files in the current
       directory to the directory /usr/joe: apply 'ln %1 /usr/joe' *

SEE ALSO

       Commands:  sh(1), xargs(1)

																	  apply(1)