docs/doxygen/overviews/file.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        file.h
   3 // Purpose:     topic overview
   4 // Author:      wxWidgets team
   5 // RCS-ID:      $Id$
   6 // Licence:     wxWindows licence
   7 /////////////////////////////////////////////////////////////////////////////
   8
   9 /**
  10
  11 @page overview_file File Classes and Functions
  12
  13 @tableofcontents
  14
  15 wxWidgets provides some functions and classes to facilitate working with files.
  16 As usual, the accent is put on cross-platform features which explains, for
  17 example, the wxTextFile class which may be used to convert
  18 between different types of text files (DOS/Unix/Mac).
  19
  20 wxFile may be used for low-level IO. It contains all the usual functions to work
  21 with files (opening/closing, reading/writing, seeking, and so on) but compared with
  22 using standard C functions, has error checking (in case of an error a message
  23 is logged using wxLog facilities) and closes the file
  24 automatically in the destructor which may be quite convenient.
  25
  26 wxTempFile is a very small file designed to make replacing the files contents
  27 safer - see its documentation for more details.
  28
  29 wxTextFile is a general purpose class for working with small text files on line
  30 by line basis. It is especially well suited for working with configuration files
  31 and program source files. It can be also used to work with files with "non
  32 native" line termination characters and write them as "native" files if needed
  33 (in fact, the files may be written in any format).
  34
  35 wxDir is a helper class for enumerating the files or subdirectories of a
  36 directory. It may be used to enumerate all files, only files satisfying the
  37 given template mask or only non-hidden files.
  38
  39 @see wxFile, wxDir, wxTempFile,  wxTextFile, @ref group_funcmacro_file
  40
  41 */