MSX-DOS2 FCS 03 63

From Z80 Machines Wiki
Jump to: navigation, search

3.63ファイルハンドルの名前変更(53H)

パラメータ:C = 53H(_HRENAME)

B =ファイルハンドル

HL =新しいファイル名ASCIIZ文字列

結果:A =エラー


この関数は、指定されたファイルハンドルに関連付けられているファイルの名前を、HLが指す文字列内の新しい名前に変更します。ファイルがASCIIZ文字列やfileinfoブロックではなくファイルハンドルで指定されていることを除けば、この関数は "ファイルまたはサブディレクトリの名前変更"関数(関数4Eh)と同じであり、同じエラー条件があります。

このファイルハンドルが他に開かれている場合( ".FOPEN"エラー)、ファイルハンドルの名前を変更することはできません。ただし、このファイルハンドルのコピーがある場合はファイルハンドルの名前を変更できます。ファイルハンドルの名前を変更してもファイルポインタは変更されませんが、暗黙の「確保」操作は行われます。