z/OS V1R9.0 UNIX System Services Command ... - Christian Grothoff

shift
Description
Examples
Usage Note
Localization
Exit Values
Messages
Portability
shift renames the positional parameters so that i+nth positional parameter becomes
the ith positional parameter, where n is the value of the given arithmetic expression.
If you omit expression, the default value is 1. The value of expression must be
between zero and the number of positional parameters ($#), inclusive. The value of
$# is updated.
shift in the tcsh shell
Without arguments, shift discards argv[1] and shifts the members of argv to the
left. It is an error for argv not to be set or to have less than one word as value.
With variable, shift performs the same function on variable. See “tcsh — Invoke a
C shell” on page 626.
The commands:
set a b c d
shift 2
echo $*
produce:
c d
shift is a special built-in shell command.
shift uses the following localization environment variables:
v LANG
v LC_ALL
v LC_MESSAGES
v NLSPATH
See Appendix F for more information.
0 Successful completion
1 Failure because the expression had a negative value or was greater than
the number of positional parameters.
Possible error messages include:
bad shift count expr
You specified an expression that did not evaluate to a number in the range
from 0 to the number of remaining positional parameters.
POSIX.2, X/Open Portability Guide, UNIX systems.
Allowing an expression, rather than just a number, is an extension found in the
z/OS UNIX System Services shell (a KornShell).
584 z/OS V1R9.0 UNIX System Services Command Reference