Description
Moves a file from one location to another on the server.
Syntax
<cffile action = "move" destination = "full pathname" source = "full pathname" attributes = "file attributes list" charset = "character set option" mode = "mode">
cfscript equivalent of the syntax
<cfscript>
cffile(action = "move" , destination = "full pathname" , source = "full pathname" , attributes = "file attributes list" , charset = "character set option" , mode = "mode")
</cfscript>
Note: You can specify this tag's attributes in an attributeCollection attribute whose value is a structure. Specify the structure name in the attributeCollection attribute and use the tag's attribute names as structure keys. |
See also
History
See the History section of the main cffile tag page.
Attributes
Attribute |
Req/Opt |
Default |
Description |
|---|---|---|---|
action |
Required |
|
Type of file manipulation that the tag performs. |
destination |
Required |
|
Pathname of the destination directory or file. If not an absolute path, it is relative to the source directory. |
source |
Required |
|
Pathname of the file to move. If not an absolute path (starting with a drive letter and a colon, or a forward or backward slash), it is relative to the ColdFusion temporary directory, which is returned by the GetTempDirectory function. |
attributes |
Optional |
|
Applies to Windows. A comma-delimited list of attributes to set on the file.
|
charset |
Optional |
JVM default file character set |
The character encoding in which the file contents is encoded. The following list includes commonly used values:
|
mode |
Optional |
|
Applies only to UNIX and Linux. Permissions. Octal values of UNIX chmod command. Assigned to owner, group, and other, respectively; for example:
|
Example
The following example moves the keymemo.doc file from the c:\files\upload\ directory to the c:\files\memo\ directory in Windows:
<cffile action = "move" source = "c:\files\upload\keymemo.doc" destination = "c:\files\memo\">
In this example, the destination directory is "memo."
Sign in to your account