<doc>
  <legacy_id>1510</legacy_id>
  <name>pop</name>
  <type>command</type>
  <syntax>
    <example>pop card [{into | before | after} <i>container</i>]</example>
  </syntax>
  <library></library>
  <objects>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Navigation &amp; Hypertext</category>
    <category>Standalone Applications</category>
  </classification>
  <references>
    <command tag="push">push Command</command>
  </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>Retrieves a <keyword tag="card">card</keyword> from the list created with the <command tag="push">push</command> <glossary tag="command">command</glossary>, and either goes to that <keyword tag="card">card</keyword> or places its <property tag="ID">ID</property> in a <glossary tag="container">container</glossary>.</summary>
  <examples>
    <example>pop card <code><i>-- go to the popped card</i></code></example>
    <example>pop card after reverseListOfCards</example>
  </examples>
  <description>
    <p>Use the <b>pop</b> command to <constant tag="return">return</constant> to a <keyword tag="card">card</keyword> whose location you have previously stored.</p><p/><p><b>Parameters:</b></p><p>The <i>container</i> is a <keyword tag="field">field</keyword>, <keyword tag="button">button</keyword>, <keyword tag="URL">URL</keyword>, or <glossary tag="variable">variable</glossary>, or the <keyword tag="message box">message box</keyword>.</p><p/><p><b>Comments:</b></p><p>If you do not specify a container, the <b>pop</b> <glossary tag="command">command</glossary> goes to the last <keyword tag="card">card</keyword> you placed on the list with the <command tag="push">push</command> <glossary tag="command">command</glossary>, and removes that <keyword tag="card">card</keyword> from the list.</p><p/><p>If you specify a container, the long <b>ID</b> of the <keyword tag="card">card</keyword> is placed in the <glossary tag="container">container</glossary> and removed from the list. The <glossary tag="current card">current card</glossary> doe not change.</p><p/><p>If the list is empty when you use the <b>pop</b> <glossary tag="command">command</glossary>, LiveCode goes to the Home <keyword tag="card">card</keyword>. If you are running in the LiveCode <glossary tag="development environment">development environment</glossary>, this is the first <keyword tag="card">card</keyword> of the "license.rev" <object tag="stack">stack</object>, which is the splash screen that appears when you start up LiveCode. (Click this card to close the stack.) If you are running in a <glossary tag="standalone application">standalone application</glossary>, the Home <keyword tag="card">card</keyword> is the first <keyword tag="card">card</keyword> of the <glossary tag="standalone application">standalone's</glossary> <glossary tag="main stack">main stack</glossary>.</p>
  </description>
</doc>