rename-file

(rename-file file new-name)

file を new-name へリネーム (移動) し、補完後の新しい名前をパス名として返します。 new-name は merge-pathnames と同じ規則で file とマージ されるため、ファイル名だけを渡すと元のディレクトリに留まります。ファイルが元の場所に 残る結果になった場合は、delete-file と同じく「そもそも存在しなかった」 場合も含めてエラーになります。

CL-USER> (rename-file "notes.txt" "notes.bak")
#P"notes.bak"
CL-USER> (rename-file "db/2026.up.sql" "2026.down.sql")
#P"db/2026.down.sql"

制限: Common Lisp は (values defaulted-new-name old-truename new-truename) を 返しますが、ここでは補完後の新しい名前だけを返します。コンパイル系バックエンドでは 副次値が関数境界を越えられないためで、ensure-directories-exist と同じ方針です。

バックエンドサポート

4つのバックエンドすべてが実際にリネームします。2つのWASMバックエンドは path_rename というWASIインポートを通じて移動し（Preview 1は直接、--component は wasi:filesystem の rename-at 経由）、「そもそも存在しなかった」場合はどこでも delete-file と同じ file-error になります。