Tag Archives: FILEMOVE

File Management

Posted on by vivaclipper

File Management Function

DeleteFile Deletes an error-tolerant file
ExeName Full File Name of Executable ( Application )
File Tests for the existence of file(s)
FileMove Moves file(s) to another directory
FileDelete Deletes file(s) by name and attribute
FileSeek Searches for files by name and attribute
HB_FNameExists Detect File / Folder existence
HB_ProgName Returns name and directory of the current Harbour program
HB_FileExists Tests for the existence of a file
HB_FileMatch Makes a file comparison with mask
HB_FTempCreate Creates and opens a temporary file
HB_FTempCreateEx Creates and opens a temporary file with extension
RenameFile Fault tolerant renaming of a file
TempFile Creates a file for temporary use

CT_FILEMOVE

Posted on by vivaclipper 
 FILEMOVE()
 Moves files to another directory
------------------------------------------------------------------------------
 Syntax

     FILEMOVE(<cSourceFile>, <cTargetFile>) --> nErrorCode

 Arguments

     <cSourceFile>  Designates the name and the path of the source file.

     <cTargetFile>  Designates the name and the path of the target file.

 Returns

     FILEMOVE() returns a value of 0 when the file can be moved; otherwise,
     an error code is returned.  The codes are defined below:

     Table 7-14:  FILEMOVE() Error Codes
     ------------------------------------------------------------------------
     Code    Symb. constants        Definition
     ------------------------------------------------------------------------
      0      NO_DISK_ERR            No errors
     -2      ER_FILE_NOT_FOUND      File not found
     -3      ER_PATH_NOT_FOUND      Access path not found
     -5      ER_ACCESS_DENIED       Access denied (e.g., network)
     -17     ER_DIFFERENT_DEVICE    Target file not on same drive
     ------------------------------------------------------------------------

 Description

     If a file is to be copied within a drive and then deleted it from the
     original position, it is quicker to move the file.  FILEMOVE() makes
     this possible.  The directory entries are also changed, which is much
     quicker than copying and deleting.

 Notes

     .  You can use drive designators and access paths in
        <cSourceFile> and <cTargetFile> file names.  Wildcards are not
        permitted.

     .  You can only move a file within a drive.  If the target
        directory already contains a file with the same name as the one from
        <cSourceFile>, the move is not completed.  In this case, FILEMOVE()
        returns a value of -5.  The only option available in this situation,
        is to delete the file in the target directory.

 Example

     Move a file from "\OLD" to "\NEW":

     IF FILEMOVE("\OLD\CUST.DBF", "\NEW\CUST.DBF") = 0
        ? "The file is now in the \NEW directory"
     ENDIF

See Also: FILECOPY()

 

Tools — Disk Utilities

Posted on by vivaclipper 
Introduction Disk Utilities
DELETEFILE() Deletes an error-tolerant file
DIRCHANGE()  Changes the current directory
DIRMAKE()    Creates a directory
DIRNAME()    Determines the name of the current directory
DIRREMOVE()  Removes a directory
DISKCHANGE() Changes the current disk drive
DISKCHECK()  Creates a checksum for a disk
DISKFORMAT() Formats disks, controlled through a UDF
DISKFREE()   Determines the space available on a floppy or hard disk
DISKNAME()   Determines the drive designator for the current drive
DISKREADY()  Tests to see if a disk drive is ready
DISKREADYW() Queries whether you can write to a drive
DISKSPEED()  Determines a comparison value for the drive speed
DISKSTAT()   Determines the status of a drive.
DISKTOTAL()  Determines the total capacity of a floppy or hard disk
DISKTYPE()   Determines the type of data carrier
DRIVETYPE()  Determines the drive type
FILEAPPEND() Appends data to a file
FILEATTR()   Determines a file's attributes
FILECCLOSE() Closes a file after backup mode
FILECCONT()  Copies sections of a file in backup mode
FILECDATI()  Determines which date the target file contains with FILECOPY()
FILECHECK()  Calculates/computes/determines a checksum for a file
FILECOPEN()  Tests to see if the file is still open in the backup mode
FILECOPY()   Copies files normally or in backup mode
FILEDATE()   Determines the file date
FILEDELETE() Deletes file(s) by name and attribute
FILEMOVE()   Moves files to another directory
FILESEEK()   Searches for files by name and attribute
FILESIZE()   Determines the size of a file
FILESTR()    Reads a portion of a file into a string
FILETIME()   Determines a file's time
FILEVALID()  Tests whether a string has a valid file name
FLOPPYTYPE() Determines the exact type of floppy drive
GETSHARE()   Determines the file open (share) mode
NUMDISKF()   Determines the number of installed disk drives
NUMDISKH()   Determines the number of hard disks
NUMDISKL()   Determines the number of available logical drives
RENAMEFILE() Fault tolerant renaming of a file.
RESTFSEEK()  Restores the FILESEEK environment
SAVEFSEEK()  Saves the current FILESEEK environment
SETFATTR()   Sets a file's attributes
SETFCREATE() Default attribute for creating with CA-Clipper Tools functions
SETFDATI()   Sets the date and time of a file
SETSHARE()   Sets default opening mode for CA-Clipper Tools file functions
STRFILE()    Writes a string to a file
TEMPFILE()   Creates a file for temporary use
TRUENAME()   Standardizes the path designation
VOLSERIAL()  Determines the DOS disk serial number
VOLUME()     Establishes a volume label for a floppy or hard disk