Revised October 2021; see History

xcall MIAMEX, MX_FINDNEXT, status, filename, size, attrib {,cdate, ctime, udate, utime {, adate, atime}}

MX_FINDNEXT must be preceded by a call to MX_FIND_FIRST. It returns the next file or subdirectory in the path specified in the original call to MX_FIND_FIRST. On exiting, the floating-point status variable, status, contains zero, in which case the remaining parameters are set as for the return from MX_FIND_FIRST, or non-zero to indicate an error (most likely no more files or sub-directories in the path).

Note that the parameter list for this call is identical to that for the MX_FIND_FIRST call, except that the PATH parameter is omitted. The starting path is set by the MX_FIND_FIRST call and maintained internally after that.

See MX_FINDEND for additional information and a program example, and the History note in MX_FINDFIRST.

History

2021 October, A-Shell 6.5.1708:  MX_FINDFIRST refinement: Overflowing the directory processing stack now generates BASIC error 33, stack overflow. Previously it only returned a non-zero status, making it too easy for the calling program to continue running without recognizing the error, leading to incorrect or inconsistent directory scan results. Furthermore, after such an error, the stack was not getting reset, leading to more errors on subsequent multi-level directory scans.

2021 October, A-Shell 6.5.1708:  Extend the maximum number of nesting levels from 3 to 20. This was done years ago for the Windows version but somehow overlooked for the UNIX version.

2020 October, A-Shell 6.5.1690:  Expand the limit on the maximum length of a filename from 123 to 255 characters.