C Language and Libraries Help (clang.hlp) (Table of Contents; Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
_fstat, _stat
 Summary Example                         Up Contents Index Back
─────Run-Time Library───────────────────────────────────────────────────────
 
     The _fstat and _stat functions obtain information about an open
     file and store the information in the structure pointed to by
     <buffer>. The _fstat function specifies the file with a file
     handle and provides information about files and devices, but not
     directories. The _stat function specifies the file, which can
     include a path, and provides information about files but not
     drives or directories.
 
     The structure, whose type _stat is defined in SYS\STAT.H,
     contains the following fields:
 
     Field        Value
 
     st_atime     Time of last access of file.
 
     st_ctime     Time of creation of file.
 
     st_dev       For both _fstat and _stat, either the drive number of
                  the disk containing the file. For _fstat only,
                  <handle> in the case of a device (same as st_rdev).
 
     st_mode      Bit mask for file-mode information. The _S_IFDIR
                  bit is set if <pathname> specifies a directory; the
                  _S_IFREG bit is set if <pathname> specifies an
                  ordinary file. User read/write bits are set
                  according to the file's permission mode; user
                  execute bits are set according to the filename
                  extension.
 
     st_mtime     Time of last modification of file.
 
     st_nlink     Always 1.
 
     st_rdev      Either the drive number of the disk containing the
                  file, or <handle> in the case of a device (same as
                  st_dev).
 
     st_size      Size of the file in bytes.
 
     In the File Allocation Table (FAT) file system supported by DOS,
     the creation and last access times of a file are not kept
     separately. Therefore st_atime, st_ctime, and st_mtime are always
     the same. These fields have different values under UNIX.
 
     Note that if <handle> refers to a device, the size and time fields
     in the _stat structure are not meaningful. Also, as STAT.H uses
     the _dev_t type, which is defined in TYPES.H, you must include
     TYPES.H before STAT.H in your code.
 
     Return Value
 
     The _fstat and _stat functions return the value 0 if the file-
     status information is obtained. A return value of -1 indicates an
     error. In the case of error, _fstat sets errno to EBADF,
     indicating an invalid file handle. In the case of an error with
     _stat, errno is set to ENOENT, indicating that the filename or
     path name cannot be found.
                                    -♦-