CFile:delete CFile:Close

CFile:Open


The Open method opens a general file and attaches it to the CFile object.

Syntax

bResult = CFile:Open( sPath, sAccessMode )

    sPath is the full path specification of the file.

    sAccessMode is a string specifying the file access.

    On success, this method returns true.

    On failure, this method returns false.

Remarks

Usually, the CFile class would not be used to open images that are in formats supported by the CImage class, but it may be used to provide raw access to images.

This class can access the file in text mode for reading, writing, or appending. See CFile Access Modes.

When the script is finished with the file, it should closed using Close or the delete destructor. The latter method sets the CFile object to nil, whereas Closing the file leaves the CFile object available for continued use.

Example

Suppose a text file exists with name sPath. This script fragment opens it and appends it with its name using, at most, 60 characters:

 

F = CFile:new()

-- create a CFile object

sPath = GetFileName()

-- use Open dialog to get a file

sMode = "w+t"

-- text mode, append the file

bOk = F:Open(sPath,sMode)

-- open the file

if ( not bOk ) then

-- if not opened, then...

  Exit()

-- leave the script, etc.

end

 

F:Printf("Path: %s\n", F:Path(60))

-- write the path into the file

F:Close()

-- close the file when done

Related Topics

CFile, Close