home *** CD-ROM | disk | FTP | other *** search
/ PC Extra Super CD 1998 January / PCPLUS131.iso / DJGPP / V2 / DJLSR201.ZIP / src / libc / dos / compat / d_getdf.txh < prev    next >
Encoding:
Text File  |  1995-10-09  |  903 b   |  36 lines
  1. @node _dos_getdiskfree, dos
  2. @heading @code{_dos_getdiskfree}
  3. @subheading Syntax
  4.  
  5. @example
  6. #include <dos.h>
  7.  
  8. unsigned int _dos_getdiskfree(unsigned int drive, struct diskfree_t *diskspace);
  9. @end example
  10.  
  11. @subheading Description
  12.  
  13. This function determines the free space on @var{drive} drive
  14. (0=default, 1=A:, 2=B:, etc.) and fills @var{diskspace} structure.
  15.  
  16. @subheading Return Value
  17.  
  18. Returns with 0 if successful and non-zero on error (sets @var{errno}=EINVAL).
  19.  
  20. @subheading Example
  21.  
  22. @example
  23. struct diskfree_t df;
  24. unsigned long freebytes;
  25.  
  26. if ( !_dos_getdiskfree(0, &df) )
  27. @{
  28.   freebytes = (unsigned long)df.avail_clusters *
  29.               (unsigned long)df.bytes_per_sector *
  30.               (unsigned long)df.sectors_per_cluster;
  31.   printf("There is %lu free bytes on the current drive.\n", freebytes);
  32. @}
  33. else
  34.   printf("Unable to get free disk space.\n");
  35. @end example
  36.