<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<link rel="stylesheet" href="../../style.css">
<title>
Gambas Documentation - COPY
</title>
</head>
<body>
<table class="none" width="100%" cellpadding="0" cellspacing="0" border="0">
<tr><td align="left">
<font size="-1">
<a href="../../help%3Fen"><img class="flag" alt="Home" border="0" src="../../img/lang/en.png" align="center"></a>&nbsp;&nbsp;
<a href="../lang%3Fen">Up</a>&nbsp;&nbsp;
<a href="conv%3Fen">Previous</a>&nbsp;&nbsp;
<a href="cos%3Fen">Next</a>&nbsp;&nbsp;
</td></tr></table>
<div class="notab">
<h1>
COPY
</h1>
<div class="black"><font color="white" size="-2"><b>Syntax</b></font></div>
<pre class="syntax"><b>COPY</b> <u>Source path</u> <b>TO</b> <u>Destination path</u></pre><p>

Copies a file from <u>Source path</u> to <u>Destination path</u>.
<p>
The destination path does not need to have the same name as the source path.
<p>
Note that you cannot copy directories recursively with this function.
<p>
<div class="gray"><font color="white" size="-2"><b>Example</b></font></div>
<pre class="example">' Save the gambas configuration file
COPY User.Home &/ &quot;.config/gambas/gambas.conf&quot; TO &quot;/mnt/save/gambas.conf.save&quot;</pre>
<p>
<div class="gray"><font color="white" size="-2"><b>Errors</b></font></div>
<table class="table" border="0" bordercolor="#000000" cellpadding="6" cellspacing="0" width="100%">
<tr><th>Message</th><th>Description</th></tr><tr bgcolor="white"><td valign="top">
<a href="../error/exist%3Fen">File already exists (#38)</a>
</td><td valign="top">
The destination file already exists.
</td></tr>
</table>
<p>
<div class="warning"><table class="none" border="0"><tr><td width="40" valign="top"><img border="0" src="../../img/info.png" align="center"></td><td valign="top">
This instruction internally uses the functions <a href="open%3Fen">OPEN</a>, <a href="read%3Fen">READ</a>, <a href="write%3Fen">WRITE</a> and <a href="close%3Fen">CLOSE</a>. So it can raise any of their errors.
</td></tr></table></div>
<p>
<hr><b>See also</b><br>
<a href="../cat/file%3Fen">File &amp; Directory Functions</a>&nbsp;&nbsp; <a href="open%3Fen">OPEN</a>&nbsp;&nbsp; <a href="read%3Fen">READ</a>&nbsp;&nbsp; <a href="write%3Fen">WRITE</a>&nbsp;&nbsp; <a href="close%3Fen">CLOSE</a>&nbsp;&nbsp;

</div>
<hr>
</body>
</html>

