rename-file-acl6.1

Arguments: filespec new-name

The function is similar to cl:rename-file in that it renames the file or directory specified by the filespec to the file or directory specified by the new-name argument. It is the Allegro CL 6.1 version of cl:rename-file. In Allegro CL 6.2, errors in the implementation of cl:rename-file have been corrected, and a new function, rename-file-raw, has been added (it mimics the behavior of the UNIX mv/Windows Move commands with regard to relative pathnames). Both cl:rename-file and rename-file-raw behave differently under certain circumstances than they did in release 6.1 (and in earlier releases). User who want the exact Allegro CL 6.1 behavior can use this function.

Tha behavior of rename-file-acl6.1 depends on the value of *default-pathname-defaults*. If that value is an absolute pathname, rename-file-acl6.1 works like rename-file-raw. If that value is a empty pathname (#p""), rename-file-acl6.1 works like cl:rename-file. The difference can be seen with the following example:

*default-pathname-defaults*
  -> #p"/usr/home/user1/"

(rename-file-acl6.1 "tmp/foo.cl" "tmp/baz.cl")
  -> #p"/usr/home/user1/tmp/baz.cl" [and additional values]

;;  OR

*default-pathname-defaults* -> #p""

(rename-file-acl6.1 "tmp/foo.cl" "tmp/baz.cl")
  -> #p"/usr/home/user1/tmp/tmp/baz.cl" [and additional values]

Like cl:rename-file, rename-file-acl6.1 returns three values: The new name, the truename of filespec, and the truename of the new name.

See cl:rename-file and excl:rename-file-raw in release-notes.htm for a complete discussion of this issue.

Copyright (c) 1998-2002, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 6.2. This page is new in the 6.2 release.
Created 2002.2.26.