ファイルの名前を変更します。
構文:
call "CBL_RENAME_FILE" using old-filename
new-filename
returning status-code
パラメーター:
- old-filename
- pic x(n)
- new-filename
- pic x(n)
- status-code
- 「説明の読み方」を参照
入力パラメーター:
- old-filename
- 名前を変更するファイル。名前にはパス名を含めることもでき、空白文字で終了します。パスを指定しない場合は、現在のディレクトリと見なされます。
このルーチンは、ワイルドカード文字を含むファイル名に対しては機能しません。
- new-filename
- 空白文字で終了する新しい名前。old-filename にパス名または URL を指定した場合は、この値にも同じパス名または URL を含める必要があります。一部のオペレーティング システムでは、new-filename の名前のファイルがすでに存在する場合に、ファイル名を変更できないことがあります。
説明:
CBL_RENAME_FILE はストライプを認識しません。このルーチンをストライプ化したファイルで使用すると、ルーチンは、最初のストライプのみの名前を変更します。そのため、このルーチンは個々のストライプでのみ使用し、ストライプ名でストライプを参照します。
RETURN-CODE を調べることで、呼び出しが成功したかどうかをチェックできます。詳細については、「ファイル状態コードとしての戻りコードの解釈」を参照してください。