copyFile(String,String)

• Function: copyFile

• Usage:

  copyFile(src,dst)

• 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
• 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
• Consequences:

  • the file may be copied

i1 : src = temporaryFileName()

o1 = /tmp/M2-30521-0/0

i2 : dst = temporaryFileName()

o2 = /tmp/M2-30521-0/1

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

o3 = /tmp/M2-30521-0/0

o3 : File

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

i5 : get dst

o5 = hi there

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

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

o7 = /tmp/M2-30521-0/0

o7 : File

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

i9 : get dst

o9 = hi there

i10 : removeFile src

i11 : removeFile dst