该函数的调用方式如下所示:
INTEGER*4 rename status = rename( from, to ) |
|||
from |
character*n |
输入 |
现有文件的路径名 |
to |
character*n |
输入 |
文件的新路径名称 |
返回值 |
INTEGER*4 |
输出 |
status=0:OK status>0:系统错误代码 |
如果 to 指定的文件已存在,则 from 和 to 必须属于相同的文件类型,并且必须位于相同的文件系统中。如果 to 已存在,应先将其删除。
示例:rename()-将文件 trename.old 重命名为 trename.new
demo% cat trename.f INTEGER*4 rename, status character*18 from/’trename.old’/, to/’trename.new’/ status = rename( from, to ) if ( status .ne. 0 ) stop ’rename: error’ end demo% f95 trename.f demo% ls trename* trename.f trename.old demo% a.out demo% ls trename* trename.f trename.new demo% |
另请参见 rename(2) 和 perror(3F)。
注意:路径名长度不能超过 <sys/param.h> 中定义的 MAXPATHLEN 值。