<doc>
  <legacy_id>1476</legacy_id>
  <name>next repeat</name>
  <type>control structure</type>
  <syntax>
    <example>next repeat</example>
  </syntax>
  <library></library>
  <objects>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Writing LiveCode</category>
  </classification>
  <references>
    <control_st tag="repeat">repeat Control Structure</control_st>
    <keyword tag="end repeat">end repeat Keyword</keyword>
    <control_st tag="exit repeat">exit repeat Control Structure</control_st>
    <keyword tag="next">next Keyword</keyword>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
    <ios/>
    <android/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
    <mobile/>
  </classes>
  <security>
  </security>
  <summary>Skips the rest of the current <glossary tag="iteration">iteration</glossary> and goes back to the top of the <control_st tag="repeat">repeat</control_st> <glossary tag="control structure">structure</glossary>.</summary>
  <examples>
  </examples>
  <description>
    <p>Use the <b>next repeat</b> <glossary tag="control structure">control structure</glossary> to skip part of a <control_st tag="repeat">repeat</control_st> loop.</p><p/><p><b>Form:</b></p><p>The <b>next repeat</b> <glossary tag="statement">statement</glossary> appears on a line by itself, anywhere inside a <control_st tag="repeat">repeat</control_st> <glossary tag="control structure">control structure</glossary>.</p><p/><p><b>Comments:</b></p><p>The <b>next repeat</b> <glossary tag="control structure">control structure</glossary> skips the rest of the current <glossary tag="iteration">iteration</glossary>, and continues to the next <glossary tag="iteration">iteration</glossary>. The following example performs the loop action only if the <glossary tag="current card">current card's</glossary> name contains the letter "e":</p><p/><p><code>  repeat for the number of cards of this stack</code></p><p><code>    go to next card</code></p><p><code>    if "e" is in the short name of this card then next repeat</code></p><p><code>    put the short name of this card &amp; return after myCardsList</code></p><p><code>  end repeat</code></p><p/><p>Usually, <b>next repeat</b> is used within an <control_st tag="if">if</control_st> <glossary tag="control structure">control structure</glossary>, so that the current <glossary tag="iteration">iteration</glossary> is skipped if a condition is true and continues if the condition is false.</p>
  </description>
</doc>