core/builtins/repeat.cif
author Tom Sutcliffe <thomas.sutcliffe@accenture.com>
Wed, 25 Aug 2010 22:17:52 +0100
changeset 36 698ccde15713
parent 0 7f656887cf89
child 66 2a78c4ff2eab
permissions -rw-r--r--
Migrated the writing fshell commands guide to the wiki.

# repeat.cif
# 
# Copyright (c) 2010 Accenture. All rights reserved.
# This component and the accompanying materials are made available
# under the terms of the "Eclipse Public License v1.0"
# which accompanies this distribution, and is available
# at the URL "http://www.eclipse.org/legal/epl-v10.html".
# 
# Initial Contributors:
# Accenture - Initial contribution
#

==name repeat

==short-description

Execute a command-line multiple times.

==long-description

On each iteration, the environment variable C<REPEAT_COUNT> is set to an integer value representing the iteration number currently being processed. This can be used, for example, to produce unique file names.

==argument uint count

The number of repetitions to perform. If set to zero, will repeat indefinitely.

==argument string command last

The command to run.

==option bool k keep-going

If an iteration returns an error, proceed with the next iteration. Ordinarily execution will abort if an error is returned.

==option int w wait

If specified, wait this number of milliseconds between iterations.

==copyright

Copyright (c) 2006-2010 Accenture. All rights reserved.