<doc>
  <legacy_id>1753</legacy_id>
  <name>volumes</name>
  <type>function</type>
  <syntax>
    <example>the volumes</example>
    <example>volumes()</example>
  </syntax>
  <library></library>
  <objects>
  </objects>
  <synonyms>
    <synonym>drives</synonym>
  </synonyms>
  <classification>
    <category>Files, Folders, &amp; Resources</category>
    <category>The System Environment</category>
  </classification>
  <references>
    <function tag="diskSpace">diskSpace Function</function>
    <function tag="files">files Function</function>
    <function tag="folders">folders Function</function>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
  </classes>
  <security>
    <disk access="???"/>
  </security>
  <summary><glossary tag="return">Returns</glossary> a list of volumes.</summary>
  <examples>
    <example>the volumes</example>
    <example>if myDisk is among the lines of the volumes then setNewDirectory</example>
  </examples>
  <description>
    <p>Use the <b>volumes</b> <control_st tag="function">function</control_st> to find out which disks are available for use.</p><p/><p><b>Value:</b></p><p>The <b>volumes</b> <control_st tag="function">function</control_st> <glossary tag="return">returns</glossary> a list of volume names, one per <keyword tag="line">line</keyword>.</p><p/><p><b>Comments:</b></p><p>A volume is usually a disk, but a single disk may be partitioned into multiple volumes, each of which appears as a separate icon. In this case, each partitioned volume is listed separately by the <b>volumes</b> <control_st tag="function">function</control_st>.</p><p/><p>Disks which are physically installed or inserted into a disk drive, but are not currently mounted, do not appear in the list returned by the <b>volumes</b> <control_st tag="function">function</control_st>.</p><p/><p><img src="202652"/> <b>Cross-platform note:</b> On <glossary tag="Mac OS">Mac OS</glossary> and <glossary tag="OS X">OS X systems</glossary>, removable drives (such as floppy drives) that are connected, but do not contain a disk, do not appear in the list returned by the <b>volumes</b> <control_st tag="function">function</control_st>. On <glossary tag="Windows">Windows systems</glossary>, empty but connected removable drives are reported by the <b>volumes</b> <control_st tag="function">function</control_st>.</p><p/><p>This function always returns empty on Unix systems.</p><p/><p><b>Note:</b> On Mac OS and OS X systems, volumes may contain slash characters (/) in their names. To use such a volume as part of a path, <command tag="replace">replace</command> the slash with a semi colon before constructing the path.</p><p/>
  </description>
</doc>