File.copy

Calling Pattern

Call

local f = sl.file(a,b)
local r = f.copy(c)

Arguments

c is a string, the target file name.

Results

r is a boolean denoting success or failure of copy operation.

Example Usage

h = sl.file(getinstalldir()..'scripts/testread.dat', 'read')
local r = h.copy(getinstalldir()..'scripts/testcopy.dat')
print(tostring(r))

--> true

Description

The copy method copies the open file to the target filename. Returns true if successful. The current read cursor position is maintained.

Upon Error

If copy is unable to create the target file an error occurs and is handled according to the operant redirection settings. Any other error should cause copy to return false.

See Also

• simplelib

• file

• file.readall

• file.readnext

• file.reopen