RENAME

可搬用関数：ファイルの名前を変更します。

モジュール：USE DFPORT

形式

result = RENAME (from, to)

from
(入力) CHARACTER*(*)。既存のファイルのパス。

to
(入力) CHARACTER*(*)。新しいのパス (以下の警告を参照)。

結果

結果の形式は，INTEGER(4) です。成功した場合，結果は 0 で，そうでなければ，以下のようなエラー・コードになります。

• EACCES - to で指定されたファイルまたはディレクトリが作成できませんでした (不正なパス)。このエラーは，指定されたドライブが現在装置に接続されていない場合も発生します。

• ENOENT - from で指定されたファイルまたはパスが見つかりませんでした。

• EXDEV - ファイルを異なった装置に移動しようとしました。

---

警告：このルーチンによりデータが失われます。to に指定したファイルが既に存在する場合，RENAME は既存のファイルを削除します。

---

エラーなしでファイルを自分自身に名前を変更することは可能です。

パス区切り子としてスラッシュ (/) またはバックスラッシュ (\) をパスに使うことができますし，ドライブ文字を含むこともできます。

互換性

CONSOLE STANDARD GRAPHICS QUICKWIN GRAPHICS WINDOWS DLL LIB

関連情報

RENAMEFILEQQ

例

	use dfport
	integer(4) istatus
	character*12 old_name, new_name
	print *, "Enter file to rename: "
	read *, old_name
	print *, "Enter new name: "
	read *, new_name
	ISTATUS = RENAME (old_name, new_name)