logo top
Main Page   Widgets   Namespaces   Book  

File Utilities

Various file-related classes and functions. More...

Compounds

class  Dir
 Utility class representing an open directory. More...

class  DirIterator
 The iterator type of Glib::Dir. More...

class  FileError
 Exception class for file-related errors. More...


Functions

bool file_test (const std::string& filename, FileTest test)
 Returns true if any of the tests in the bitfield test are true.

int mkstemp (std::string& filename_template)
 Opens a temporary file.


Detailed Description

Various file-related classes and functions.


Function Documentation

bool file_test ( const std::string&    filename,
FileTest    test
 

Returns true if any of the tests in the bitfield test are true.

For example, (Glib::FILE_TEST_EXISTS | Glib::FILE_TEST_IS_DIR) will return true if the file exists; the check whether it's a directory doesn't matter since the existence test is true. With the current set of available tests, there's no point passing in more than one test at a time.

Apart from Glib::FILE_TEST_IS_SYMLINK all tests follow symbolic links, so for a symbolic link to a regular file file_test() will return true for both Glib::FILE_TEST_IS_SYMLINK and Glib::FILE_TEST_IS_REGULAR.

Note:
For a dangling symbolic link file_test() will return true for Glib::FILE_TEST_IS_SYMLINK and false for all other flags.
Parameters:
filename A filename to test.
test Bitfield of Glib::FileTest flags.
Returns:
Whether a test was true.

int mkstemp ( std::string&    filename_template
 

Opens a temporary file.

See the mkstemp() documentation on most UNIX-like systems. This is a portability wrapper, which simply calls mkstemp() on systems that have it, and implements it in GLib otherwise.

Parameters:
filename_template A string that should match the rules for mkstemp(), i.e. end in "XXXXXX". The X string will be modified to form the name of a file that didn't exist.
Returns:
A file handle (as from open()) to the file opened for reading and writing. The file is opened in binary mode on platforms where there is a difference. The file handle should be closed with close(). In case of errors, -1 is returned.


Generated for gtkmm by Doxygen 1.3-rc1 © 1997-2001