copyFile(String,String)

Synopsis

Usage:
copyFile(src,dst)
Function: copyFile
Inputs:
- src, a string, the filename or path to an existing regular file
- dst, a string, the filename or path to the copy to be made
Consequences:
- the file may be copied
Optional inputs:
- UpdateOnly => a Boolean value, default value false, whether to copy file only if the destination file does not exist or is older than the source file
- Verbose => a Boolean value, default value false, whether to report individual file operations

i1 : src = temporaryFileName()

o1 = /tmp/M2-28588-1

i2 : dst = temporaryFileName()

o2 = /tmp/M2-28588-2

i3 : src << "hi there" << close

o3 = /tmp/M2-28588-1

o3 : File

i4 : copyFile(src,dst,Verbose=>true)
--copying: /tmp/M2-28588-1 -> /tmp/M2-28588-2

i5 : get dst

o5 = hi there

i6 : copyFile(src,dst,Verbose=>true,UpdateOnly => true)
--skipping: /tmp/M2-28588-1 not newer than /tmp/M2-28588-2

i7 : src << "ho there" << close

o7 = /tmp/M2-28588-1

o7 : File

i8 : copyFile(src,dst,Verbose=>true,UpdateOnly => true)
--skipping: /tmp/M2-28588-1 not newer than /tmp/M2-28588-2

i9 : get dst

o9 = hi there

i10 : removeFile src

i11 : removeFile dst