fish-shell/doc_src/cmds/continue.rst

.. _cmd-continue:

continue - skip the remainder of the current iteration of the current inner loop
================================================================================

Synopsis
--------

**LOOP_CONSTRUCT**; [*COMMANDS* ...;] **continue**; [*COMMANDS* ...;] **end**

Description
-----------

``continue`` skips the remainder of the current iteration of the current inner loop, such as a :ref:`for <cmd-for>` loop or a :ref:`while <cmd-while>` loop. It is usually added inside of a conditional block such as an :ref:`if <cmd-if>` statement or a :ref:`switch <cmd-switch>` statement.

Example
-------

The following code removes all tmp files that do not contain the word smurf.

::

    for i in *.tmp
        if grep smurf $i
            continue
        end
        # This "rm" is skipped over if "continue" is executed.
        rm $i
        # As is this "echo"
        echo $i
    end

See Also
--------

- the :ref:`break <cmd-break>` command, to stop the current inner loop
docs: Add labels to all commands This allows us to use :ref: references, which don't require hardcoding it as html [ci skip] 2019-03-31 09:05:09 +00:00			`.. _cmd-continue:`

Switch command docs from \section to reStructuredText 2018-12-17 01:39:33 +00:00			`continue - skip the remainder of the current iteration of the current inner loop`
Fix command section separator line lengths 2019-01-03 04:10:47 +00:00			`================================================================================`
Switch command docs from \section to reStructuredText 2018-12-17 01:39:33 +00:00
Migrate the 'synopsis' sections to .rst format 2018-12-18 01:58:24 +00:00			`Synopsis`
			`--------`
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 21:08:41 +00:00
docs synopses: add space before ellipsis This matches the style in man(1) (except that we use the … ligature). A previous iteration did the reverse (never use a space before the ellipsis). That would be a smaller change. 2022-01-09 08:49:51 +00:00			`LOOP_CONSTRUCT; [COMMANDS ...;] continue; [COMMANDS ...;] end`
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 21:08:41 +00:00
Convert \\subsection sections into rst format 2018-12-19 02:44:30 +00:00			`Description`
Fix command section separator line lengths 2019-01-03 04:10:47 +00:00			`-----------`
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 21:08:41 +00:00
docs: Use more command labels 2019-03-31 09:24:04 +00:00			``continue`` skips the remainder of the current iteration of the current inner loop, such as a :ref:`for <cmd-for>` loop or a :ref:`while <cmd-while>` loop. It is usually added inside of a conditional block such as an :ref:`if <cmd-if>` statement or a :ref:`switch <cmd-switch>` statement.
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 21:08:41 +00:00
Convert \\subsection sections into rst format 2018-12-19 02:44:30 +00:00			`Example`
Fix command section separator line lengths 2019-01-03 04:10:47 +00:00			`-------`
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 21:08:41 +00:00
			`The following code removes all tmp files that do not contain the word smurf.`

Switch \fish sections to rst format 2018-12-19 03:14:04 +00:00			`::`

			`for i in *.tmp`
			`if grep smurf $i`
			`continue`
			`end`
			`# This "rm" is skipped over if "continue" is executed.`
			`rm $i`
			`# As is this "echo"`
			`echo $i`
Copy doc_src to sphinx_doc_src and add a TOC 2018-12-16 21:08:41 +00:00			`end`
Switch \fish sections to rst format 2018-12-19 03:14:04 +00:00
doc: add interlinks between `break` and `continue` commands 2020-03-07 14:57:22 +00:00			`See Also`
			`--------`

			- the :ref:`break <cmd-break>` command, to stop the current inner loop