Version: 3.0.2
filename.h File Reference

Classes

class  wxFileName
 wxFileName encapsulates a file name. More...
 

Enumerations

enum  wxPathFormat {
  wxPATH_NATIVE = 0,
  wxPATH_UNIX,
  wxPATH_BEOS = wxPATH_UNIX,
  wxPATH_MAC,
  wxPATH_DOS,
  wxPATH_WIN = wxPATH_DOS,
  wxPATH_OS2 = wxPATH_DOS,
  wxPATH_VMS,
  wxPATH_MAX
}
 The various values for the path format: this mainly affects the path separator but also whether or not the path has the drive part (as under Windows). More...
 
enum  wxSizeConvention {
  wxSIZE_CONV_TRADITIONAL,
  wxSIZE_CONV_IEC,
  wxSIZE_CONV_SI
}
 Different conventions for human readable sizes. More...
 
enum  wxPathNormalize {
  wxPATH_NORM_ENV_VARS = 0x0001,
  wxPATH_NORM_DOTS = 0x0002,
  wxPATH_NORM_TILDE = 0x0004,
  wxPATH_NORM_CASE = 0x0008,
  wxPATH_NORM_ABSOLUTE = 0x0010,
  wxPATH_NORM_LONG = 0x0020,
  wxPATH_NORM_SHORTCUT = 0x0040,
  wxPATH_NORM_ALL = 0x00ff & ~wxPATH_NORM_CASE
}
 The kind of normalization to do with the file name: these values can be or'd together to perform several operations at once. More...
 
enum  {
  wxPATH_RMDIR_FULL = 1,
  wxPATH_RMDIR_RECURSIVE = 2
}
 Flags for wxFileName::Rmdir(). More...
 
enum  {
  wxFILE_EXISTS_REGULAR = 0x0001,
  wxFILE_EXISTS_DIR = 0x0002,
  wxFILE_EXISTS_SYMLINK = 0x1004,
  wxFILE_EXISTS_DEVICE = 0x0008,
  wxFILE_EXISTS_FIFO = 0x0016,
  wxFILE_EXISTS_SOCKET = 0x0032,
  wxFILE_EXISTS_NO_FOLLOW
}
 Flags for wxFileName::Exists(). More...
 

Variables

wxULongLong wxInvalidSize
 The return value of wxFileName::GetSize() in case of error.
 

Enumeration Type Documentation

anonymous enum

Flags for wxFileName::Rmdir().

Enumerator:
wxPATH_RMDIR_FULL 

Delete the specified directory and its subdirectories if they are empty.

wxPATH_RMDIR_RECURSIVE 

Delete the specified directory and all the files and subdirectories in it recursively.

This flag is obviously dangerous and should be used with care and after asking the user for confirmation.

anonymous enum

Flags for wxFileName::Exists().

Since
2.9.5
Enumerator:
wxFILE_EXISTS_REGULAR 

Check for existence of a regular file.

wxFILE_EXISTS_DIR 

Check for existence of a directory.

wxFILE_EXISTS_SYMLINK 

Check for existence of a symlink.

Notice that this flag also sets wxFILE_EXISTS_NO_FOLLOW, otherwise it would never be satisfied as wxFileName::Exists() would be checking for the existence of the symlink target and not the symlink itself.

wxFILE_EXISTS_DEVICE 

Check for existence of a device.

wxFILE_EXISTS_FIFO 

Check for existence of a FIFO.

wxFILE_EXISTS_SOCKET 

Check for existence of a socket.

wxFILE_EXISTS_NO_FOLLOW 

Don't dereference a contained symbolic link.

Check for existence of anything

The various values for the path format: this mainly affects the path separator but also whether or not the path has the drive part (as under Windows).

See wxFileName for more info.

Enumerator:
wxPATH_NATIVE 

the path format for the current platform.

wxPATH_UNIX 
wxPATH_BEOS 
wxPATH_MAC 
wxPATH_DOS 
wxPATH_WIN 
wxPATH_OS2 
wxPATH_VMS 
wxPATH_MAX 

Not a valid value for specifying path format.

The kind of normalization to do with the file name: these values can be or'd together to perform several operations at once.

See wxFileName::Normalize() for more info.

Enumerator:
wxPATH_NORM_ENV_VARS 

Replace environment variables with their values.

wxFileName understands both Unix and Windows (but only under Windows) environment variables expansion: i.e. "$var", "$(var)" and "${var}" are always understood and in addition under Windows "%var%" is also.

wxPATH_NORM_DOTS 

Squeeze all ".." and ".".

wxPATH_NORM_TILDE 

Replace "~" and "~user" (Unix only).

wxPATH_NORM_CASE 

If the platform is case insensitive, make lowercase the path.

wxPATH_NORM_ABSOLUTE 

Make the path absolute.

wxPATH_NORM_LONG 

Expand the path to the "long" form (Windows only).

wxPATH_NORM_SHORTCUT 

Resolve the shortcut, if it is a shortcut (Windows only).

wxPATH_NORM_ALL 

A value indicating all normalization flags except for wxPATH_NORM_CASE.

Different conventions for human readable sizes.

See Also
wxFileName::GetHumanReadableSize().
Since
2.9.1
Enumerator:
wxSIZE_CONV_TRADITIONAL 

1024 bytes = 1KB.

wxSIZE_CONV_IEC 

1024 bytes = 1KiB.

wxSIZE_CONV_SI 

1000 bytes = 1KB.

Variable Documentation

wxULongLong wxInvalidSize

The return value of wxFileName::GetSize() in case of error.