Atari ST series - Page 295

Fsnext
Find Next File in Directory Chain
Fsnext() Opcode = 79 ($4F)
T h is fu n ctio n is u se d to find a dd ition al files in a d irec to ry ch ain th a t m e et
th e crite ria se t fo rth in a pre vio u s F s fir s t() call. T his fun ctio n w ill on ly
w o rk if th e file sp ecificatio n u se d fo r F s f ir s t() in clu d ed a w ild ca rd ch a ra c
ter.
C macro format
in t statu s;
s ta tu s = F sn e x t( );
Machine language format
m o v e .w # $ 4 F , - (sp)
trap # 1
ad d q .l # 2 ,s p
Inputs
N o n e— se arch crite ria a re se t by p re v io u s F s fi rs t( ) call.
Results
DO s ta tu s w o rd If a m a tch is fo un d , a v alu e of 0 is retu rn e d h ere ,
an d a 44 -b yte d ata stru ctu re is w ritten to th e ad d re ss
p oin ted to b y th e D T A . If n o m atc h is fo un d , th e
ap p ro p ria te n eg ativ e G EM D O S e rro r n u m b er is re 
tu rn ed .
In fo rm atio n in d ata stru ctu re re tu rn e d if m atc h is su cce ssfu l:
Byte Number Contents
0 - 2 0 R ese rv ed fo r in tern al u se (m u st n o t b e alte red )
21 File attrib utes
2 2 - 2 3 T im e stam p
2 4 -2 5 D ate sta m p
2 6 - 2 9 File size
3 0 - 4 3 F ile n am e an d ex ten sio n
See also
F s fir s t()
287