.. _continue-statement:

Continue Statement
==================

The `Continue statement <https://en.wikipedia.org/wiki/Control_flow#Continuation_with_next_iteration>`_ gives you the option to skip over the part of a loop where an external condition is triggered, but to go on to complete the rest of the loop iterations. That is, the current iteration of the loop will be disrupted, but the program will return to the top of the loop. The Continue statement will be within the block of code under the Loop statement, usually after a conditional if statement.

The continue statement (in most computer programming languages), takes the generic form of:

| **WHILE** Boolean expression
|     statement_1 
|     ...
|     **IF** Boolean expression **THEN**
|         **CONTINUE**
|     **ENDIF**
|     statement_2
|     ...
|     counter = counter + 1
| **ENDWHILE**

| **FOR** counter in range(n)
|     statement_1
|     ...
|     **IF** Boolean expression **THEN**
|         **CONTINUE**
|     **ENDIF**
|     statement_2
|     ...
| **ENDFOR**

In this example program, the user is asked to enter a positive integer and the program will count how many times it goes through the loop until it reaches that number, except it will always skip 5!

Top-Down Design for the Continue Statement
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. image:: ./images/top-down-continue.png
    :alt: Top-Down Design for Continue Statement
    :align: center

Flowchart for the Continue Statement
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. image:: ./images/flowchart-continue.png
    :alt: Continue Statement flowchart
    :align: center

Pseudocode for the Continue Statement
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
| **GET** positive_integer
| **WHILE** (counter < positive_integer)
|     counter = counter - 1
|     **IF** (counter + 1 == 5) **THEN**
|         **CONTINUE**
|     **ENDIF**
|     **SHOW** counter + 1
| **ENDFOR** 

Code for the Continue Statement
^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. tabs::

  .. group-tab:: C
      .. literalinclude:: ../../code_examples/3-Structured_Problem_Solving/17-Continue/C/main.c
        :language: C
        :linenos:
        :emphasize-lines: 24-26

  .. group-tab:: C++
      .. literalinclude:: ../../code_examples/3-Structured_Problem_Solving/17-Continue/CPP/main.cpp
        :language: C++
        :linenos:
        :emphasize-lines: 24-26

  .. group-tab:: C#
      .. literalinclude:: ../../code_examples/3-Structured_Problem_Solving/17-Continue/CSharp/main.cs
        :language: C#
        :linenos:
        :emphasize-lines: 28-30

  .. group-tab:: Go
      .. literalinclude:: ../../code_examples/3-Structured_Problem_Solving/17-Continue/Go/main.go
        :language: go
        :linenos:
        :emphasize-lines: 30-32

  .. group-tab:: Java
      .. literalinclude:: ../../code_examples/3-Structured_Problem_Solving/17-Continue/Java/Main.java
        :language: java
        :linenos:
        :emphasize-lines: 31-33

  .. group-tab:: JavaScript
      .. literalinclude:: ../../code_examples/3-Structured_Problem_Solving/17-Continue/JavaScript/main.js
        :language: javascript
        :linenos:
        :emphasize-lines: 22-24

  .. group-tab:: Python
      .. literalinclude:: ../../code_examples/3-Structured_Problem_Solving/17-Continue/Python/main.py
        :language: python
        :linenos:
        :emphasize-lines: 21-22

Example Output
^^^^^^^^^^^^^^
.. image:: ../../code_examples/3-Structured_Problem_Solving/17-Continue/vhs.gif
    :alt: Code example output
    :align: left