findnext.gml

开放源码的编译器open watcom 1.6.0版的源代码

.func _findnext _findnexti64 _wfindnext _wfindnexti64
#include <&iohdr>
int _findnext( long handle,
               struct _finddata_t *fileinfo );
.ixfunc2 '&DosFunc' _findnext
int _findnexti64( long handle,
                  struct _finddatai64_t *fileinfo );
.ixfunc2 '&DosFunc' _findnexti64
.if &'length(&wfunc.) ne 0 .do begin
int _wfindnext( long handle,
                struct _wfinddata_t *fileinfo );
.ixfunc2 '&DosFunc' _wfindnext
.ixfunc2 '&Wide' _wfindnext
int _wfindnexti64( long handle,
                   struct _wfinddatai64_t *fileinfo );
.ixfunc2 '&DosFunc' _wfindnexti64
.ixfunc2 '&Wide' _wfindnexti64
.do end
.funcend
.desc begin
The &func function returns information on the next file whose name
matches the
.arg filespec
argument that was specified in a call to the
.kw _findfirst
function.
The
.arg handle
argument was returned by the
.kw _findfirst
function.
The information is returned in a
.kw _finddata_t
structure pointed to by
.arg fileinfo.
.millust begin
struct _finddata_t {
  unsigned  attrib;
  time_t    time_create;  /* -1 for FAT file systems */
  time_t    time_access;  /* -1 for FAT file systems */
  time_t    time_write;
  _fsize_t  size;
  char      name[_MAX_PATH];
};
.millust end
.np
The &func.i64 function returns information on the next file whose name
matches the
.arg filespec
argument that was specified in a call to the
.kw _findfirsti64
function.
It differs from the &func function in that it returns a 64-bit file
size.
The
.arg handle
argument was returned by the
.kw _findfirsti64
function.
The information is returned in a
.kw _finddatai64_t
structure pointed to by
.arg fileinfo.
.millust begin
struct _finddatai64_t {
  unsigned  attrib;
  time_t    time_create;  /* -1 for FAT file systems */
  time_t    time_access;  /* -1 for FAT file systems */
  time_t    time_write;
  __int64   size;         /* 64-bit size info */
  char      name[_MAX_PATH];
};
.millust end
.if &'length(&wfunc.) ne 0 .do begin
.np
The wide-character &wfunc function is similar to the &func function
but operates on wide-character strings.
.millust begin
struct _wfinddata_t {
  unsigned  attrib;
  time_t    time_create;  /* -1 for FAT file systems */
  time_t    time_access;  /* -1 for FAT file systems */
  time_t    time_write;
  _fsize_t  size;
  wchar_t   name[_MAX_PATH];
};
.millust end
.np
The wide-character &wfunc.i64 function is similar to the &func.i64
function but operates on wide-character strings.
It differs from the &wfunc function in that it returns a 64-bit file
size.
.millust begin
struct _wfinddatai64_t {
  unsigned  attrib;
  time_t    time_create;  /* -1 for FAT file systems */
  time_t    time_access;  /* -1 for FAT file systems */
  time_t    time_write;
  __int64   size;         /* 64-bit size info */
  wchar_t   name[_MAX_PATH];
};
.millust end
.do end
.desc end
.return begin
If successful, &func returns 0; otherwise, &func and returns &minus.1
and sets
.kw errno
to one of the following values:
.begterm
.termhd1 Constant
.termhd2 Meaning
.term ENOENT
No matching files
.endterm
.return end
.see begin
.seelist &function. _dos_find Functions
.seelist &function. _findclose _findfirst _findnext closedir opendir readdir
.see end
.exmp begin
#include <stdio.h>
#include <&iohdr>

void main()
  {
    struct _finddata_t  fileinfo;
    long                handle;
    int                 rc;
.exmp break
    /* Display name and size of "*.c" files */
    handle = _findfirst( "*.c", &fileinfo );
    rc = handle;
    while( rc != -1 ) {
      printf( "%14s %10ld\n", fileinfo.name,
                              fileinfo.size );
      rc = _findnext( handle, &fileinfo );
    }
    _findclose( handle );
  }
.exmp end
.class DOS
.system