###Function###
FileCopy

###Description###
Copies one or more files.

###Syntax###
FileCopy ( "source", "dest" [, flag = 0] )


###Parameters###
@@ParamTable@@
source
	The source path of the file(s) to copy.  Wildcards are supported.
dest
	The destination path of the copied file(s).
flag
	[optional] this flag determines whether to overwrite files if they already exist.
	Can be a combination of the following:
	$FC_NOOVERWRITE (0) = (default) do not overwrite existing files
	$FC_OVERWRITE (1) = overwrite existing files
	$FC_CREATEPATH (8) = Create destination directory structure if it doesn't exist (See Remarks).
	Constants are defined in FileConstants.au3
@@End@@

###ReturnValue###
@@ReturnTable@@
Success:	Returns 1.
Failure:	Returns 0.
@@End@@


###Remarks###
See <a href="FileFindFirstFile.htm">FileFindFirstFile()</a> for a discussion about wildcards.

The destination directory must already exist, except using with flag value $FC_CREATEPATH.
For instance the combined flag $FC_OVERWRITE + $FC_CREATEPATH overwrites the target file and pre-checks for the destination directory structure and if it doesn't exist creates it automatically.

Some file attributes can make the overwriting impossible, if this is the case look at <a href="FileSetAttrib.htm">FileSetAttrib()</a> to change the attributes of a file.


###Related###
FileMove, FileDelete, DirCopy, DirCreate


###Example###
@@IncludeExample@@
