Atari ST series - Page 296

Frename
Rename File
Frename() Opcode = 86 ($56)
C h a n g e s th e n am e o f a file.
C macro format
in t sta tu s;
c h a r *old na m e ;
c h a r *n ew n a m e ;
sta tu s = F re n am e (0, o ld n am e, n ew n am e);
Machine language format
m o v e .l n e w n am e , - (sp )
m o v e .l o ld n am e, - (sp)
clr.w - (sp )
m o v e .w # $ 5 6 , - (sp )
trap # 1
a d d .l # 1 2 , sp
Inputs
n e w n am e
o ld n am e
N o te th at a
Results
DO sta tu s w o rd If su cce ssfu l, a 0 is retu rn e d . If n o t, a n eg ativ e
G E M D O S erro r co d e.
lo n g A p oin ter to th e strin g co ntain in g th e fi
le n am e to ch a n g e to . T his filen am e m ay
b e in a n ew d ire cto ry p a th ,
lo n g A p oin ter to a strin g c on tain in g th e n am e
o f th e file to b e ch an g ed .
ze ro w o rd m u st also be p as se d as a p lace h o ld er.
288