From bd0f3345a938b35ce6a12f6150373b0955b8dd12 Mon Sep 17 00:00:00 2001 From: Timothy Pearson Date: Sun, 10 Jul 2011 15:24:15 -0500 Subject: Add Qt3 development HEAD version --- doc/html/qdir.html | 818 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 818 insertions(+) create mode 100644 doc/html/qdir.html (limited to 'doc/html/qdir.html') diff --git a/doc/html/qdir.html b/doc/html/qdir.html new file mode 100644 index 0000000..c453145 --- /dev/null +++ b/doc/html/qdir.html @@ -0,0 +1,818 @@ + + + + + +QDir Class + + + + + + + +
+ +Home + | +All Classes + | +Main Classes + | +Annotated + | +Grouped Classes + | +Functions +

QDir Class Reference

+ +

The QDir class provides access to directory structures and their contents in a platform-independent way. +More... +

All the functions in this class are reentrant when Qt is built with thread support.

+

#include <qdir.h> +

List of all member functions. +

Public Members

+ +

Static Public Members

+ +

Detailed Description

+ + + +The QDir class provides access to directory structures and their contents in a platform-independent way. +

+ +

A QDir is used to manipulate path names, access information +regarding paths and files, and manipulate the underlying file +system. +

A QDir can point to a file using either a relative or an absolute +path. Absolute paths begin with the directory separator "/" +(optionally preceded by a drive specification under Windows). If +you always use "/" as a directory separator, Qt will translate +your paths to conform to the underlying operating system. Relative +file names begin with a directory name or a file name and specify +a path relative to the current directory. +

The "current" path refers to the application's working directory. +A QDir's own path is set and retrieved with setPath() and path(). +

An example of an absolute path is the string "/tmp/quartz", a +relative path might look like "src/fatlib". You can use the +function isRelative() to check if a QDir is using a relative or an +absolute file path. Call convertToAbs() to convert a relative QDir +to an absolute one. For a simplified path use cleanDirPath(). To +obtain a path which has no symbolic links or redundant ".." +elements use canonicalPath(). The path can be set with setPath(), +and changed with cd() and cdUp(). +

QDir provides several static functions, for example, setCurrent() +to set the application's working directory and currentDirPath() to +retrieve the application's working directory. Access to some +common paths is provided with the static functions, current(), +home() and root() which return QDir objects or currentDirPath(), +homeDirPath() and rootDirPath() which return the path as a string. +If you want to know about your application's path use +QApplication::applicationDirPath(). +

The number of entries in a directory is returned by count(). +Obtain a string list of the names of all the files and directories +in a directory with entryList(). If you prefer a list of QFileInfo +pointers use entryInfoList(). Both these functions can apply a +name filter, an attributes filter (e.g. read-only, files not +directories, etc.), and a sort order. The filters and sort may be +set with calls to setNameFilter(), setFilter() and setSorting(). +They may also be specified in the entryList() and +entryInfoList()'s arguments. +

Create a new directory with mkdir(), rename a directory with +rename() and remove an existing directory with rmdir(). Remove a +file with remove(). You can interrogate a directory with exists(), +isReadable() and isRoot(). +

To get a path with a filename use filePath(), and to get a +directory name use dirName(); neither of these functions checks +for the existence of the file or directory. +

The list of root directories is provided by drives(); on Unix +systems this returns a list containing one root directory, "/"; on +Windows the list will usually contain "C:/", and possibly "D:/", +etc. +

It is easiest to work with "/" separators in Qt code. If you need +to present a path to the user or need a path in a form suitable +for a function in the underlying operating system use +convertSeparators(). +

Examples: +

See if a directory exists. +

+    QDir d( "example" );                        // "./example"
+    if ( !d.exists() )
+        qWarning( "Cannot find the example directory" );
+
+ +

Traversing directories and reading a file. +

+    QDir d = QDir::root();                      // "/"
+    if ( !d.cd("tmp") ) {                       // "/tmp"
+        qWarning( "Cannot find the \"/tmp\" directory" );
+    } else {
+        QFile f( d.filePath("ex1.txt") );       // "/tmp/ex1.txt"
+        if ( !f.open(IO_ReadWrite) )
+            qWarning( "Cannot create the file %s", f.name() );
+    }
+
+ +

A program that lists all the files in the current directory +(excluding symbolic links), sorted by size, smallest first: +

+    #include <stdio.h>
+    #include <qdir.h>
+
+    int main( int argc, char **argv )
+    {
+        QDir d;
+        d.setFilter( QDir::Files | QDir::Hidden | QDir::NoSymLinks );
+        d.setSorting( QDir::Size | QDir::Reversed );
+
+        const QFileInfoList *list = d.entryInfoList();
+        QFileInfoListIterator it( *list );
+        QFileInfo *fi;
+
+        printf( "     Bytes Filename\n" );
+        while ( (fi = it.current()) != 0 ) {
+            printf( "%10li %s\n", fi->size(), fi->fileName().latin1() );
+            ++it;
+        }
+        return 0;
+    }
+
+ +

See also QApplication::applicationDirPath() and Input/Output and Networking. + +

Member Type Documentation

+

QDir::FilterSpec

+ +

This enum describes the filtering options available to QDir, e.g. +for entryList() and entryInfoList(). The filter value is specified +by OR-ing together values from the following list: +

If you do not set any of Readable, Writable or Executable, QDir will set all three of them. This makes the +default easy to write and at the same time useful. +

Examples: Readable|Writable means list all files for which the +application has read access, write access or both. Dirs|Drives +means list drives, directories, all files that the application can +read, write or execute, and also symlinks to such +files/directories. + +

QDir::SortSpec

+ +

This enum describes the sort options available to QDir, e.g. for +entryList() and entryInfoList(). The sort value is specified by +OR-ing together values from the following list: +

You can only specify one of the first four. +

If you specify both DirsFirst and Reversed, directories are +still put first, but in reverse order; the files will be listed +after the directories, again in reverse order. + +

Member Function Documentation

+

QDir::QDir () +

+Constructs a QDir pointing to the current directory ("."). +

See also currentDirPath(). + +

QDir::QDir ( const QString & path, const QString & nameFilter = QString::null, int sortSpec = Name | IgnoreCase, int filterSpec = All ) +

+Constructs a QDir with path path, that filters its entries by +name using nameFilter and by attributes using filterSpec. It +also sorts the names using sortSpec. +

The default nameFilter is an empty string, which excludes +nothing; the default filterSpec is All, which also means +exclude nothing. The default sortSpec is Name|IgnoreCase, +i.e. sort by name case-insensitively. +

Example that lists all the files in "/tmp": +

+    QDir d( "/tmp" );
+    for ( int i = 0; i < d.count(); i++ )
+        printf( "%s\n", d[i] );
+
+ +

If path is "" or QString::null, QDir uses "." (the current +directory). If nameFilter is "" or QString::null, QDir uses the +name filter "*" (all files). +

Note that path need not exist. +

See also exists(), setPath(), setNameFilter(), setFilter(), and setSorting(). + +

QDir::QDir ( const QDir & d ) +

+Constructs a QDir that is a copy of the directory d. +

See also operator=(). + +

QDir::~QDir () [virtual] +

+Destroys the QDir frees up its resources. + +

QString QDir::absFilePath ( const QString & fileName, bool acceptAbsPath = TRUE ) const [virtual] +

+Returns the absolute path name of a file in the directory. Does not check if the file actually exists in the directory. Redundant +multiple separators or "." and ".." directories in fileName +will not be removed (see cleanDirPath()). +

If acceptAbsPath is TRUE a fileName starting with a +separator "/" will be returned without change. If acceptAbsPath +is FALSE an absolute path will be prepended to the fileName and +the resultant string returned. +

See also filePath(). + +

QString QDir::absPath () const [virtual] +

+Returns the absolute path (a path that starts with "/" or with a +drive specification), which may contain symbolic links, but never +contains redundant ".", ".." or multiple separators. +

See also setPath(), canonicalPath(), exists(), cleanDirPath(), dirName(), and absFilePath(). + +

Example: fileiconview/qfileiconview.cpp. +

QString QDir::canonicalPath () const [virtual] +

+Returns the canonical path, i.e. a path without symbolic links or +redundant "." or ".." elements. +

On systems that do not have symbolic links this function will +always return the same string that absPath() returns. If the +canonical path does not exist (normally due to dangling symbolic +links) canonicalPath() returns QString::null. +

See also path(), absPath(), exists(), cleanDirPath(), dirName(), absFilePath(), and QString::isNull(). + +

bool QDir::cd ( const QString & dirName, bool acceptAbsPath = TRUE ) [virtual] +

+Changes the QDir's directory to dirName. +

If acceptAbsPath is TRUE a path starting with separator "/" +will cause the function to change to the absolute directory. If acceptAbsPath is FALSE any number of separators at the beginning +of dirName will be removed and the function will descend into +dirName. +

Returns TRUE if the new directory exists and is readable; +otherwise returns FALSE. Note that the logical cd() operation is +not performed if the new directory does not exist. +

Calling cd( ".." ) is equivalent to calling cdUp(). +

See also cdUp(), isReadable(), exists(), and path(). + +

Example: fileiconview/mainwindow.cpp. +

bool QDir::cdUp () [virtual] +

+Changes directory by moving one directory up from the QDir's +current directory. +

Returns TRUE if the new directory exists and is readable; +otherwise returns FALSE. Note that the logical cdUp() operation is +not performed if the new directory does not exist. +

See also cd(), isReadable(), exists(), and path(). + +

QString QDir::cleanDirPath ( const QString & filePath ) [static] +

+Removes all multiple directory separators "/" and resolves any +"."s or ".."s found in the path, filePath. +

Symbolic links are kept. This function does not return the +canonical path, but rather the simplest version of the input. +For example, "./local" becomes "local", "local/../bin" becomes +"bin" and "/local/usr/../bin" becomes "/local/bin". +

See also absPath() and canonicalPath(). + +

QString QDir::convertSeparators ( const QString & pathName ) [static] +

+Returns pathName with the '/' separators converted to +separators that are appropriate for the underlying operating +system. +

On Windows, convertSeparators("c:/winnt/system32") returns +"c:\winnt\system32". +

The returned string may be the same as the argument on some +operating systems, for example on Unix. + +

Examples: dirview/dirview.cpp and fileiconview/qfileiconview.cpp. +

void QDir::convertToAbs () [virtual] +

+Converts the directory path to an absolute path. If it is already +absolute nothing is done. +

See also isRelative(). + +

uint QDir::count () const +

+Returns the total number of directories and files that were found. +

Equivalent to entryList().count(). +

See also operator[]() and entryList(). + +

QDir QDir::current () [static] +

+Returns the application's current directory. +

Use path() to access a QDir object's path. +

See also currentDirPath() and QDir::QDir(). + +

QString QDir::currentDirPath () [static] +

+Returns the absolute path of the application's current directory. +

See also current(). + +

Examples: dirview/dirview.cpp, helpviewer/helpwindow.cpp, and qdir/qdir.cpp. +

QString QDir::dirName () const [virtual] +

+Returns the name of the directory; this is not the same as the +path, e.g. a directory with the name "mail", might have the path +"/var/spool/mail". If the directory has no name (e.g. it is the +root directory) QString::null is returned. +

No check is made to ensure that a directory with this name +actually exists. +

See also path(), absPath(), absFilePath(), exists(), and QString::isNull(). + +

const QFileInfoList * QDir::drives () [static] +

+Returns a list of the root directories on this system. On Windows +this returns a number of QFileInfo objects containing "C:/", "D:/" +etc. On other operating systems, it returns a list containing just +one root directory (e.g. "/"). +

The returned pointer is owned by Qt. Callers should not delete +or modify it. + +

Example: dirview/main.cpp. +

QStrList QDir::encodedEntryList ( int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const [virtual] +

+This function is obsolete. It is provided to keep old source working. We strongly advise against using it in new code. +

This function is included to easy porting from Qt 1.x to Qt 2.0, +it is the same as entryList(), but encodes the filenames as 8-bit +strings using QFile::encodedName(). +

It is more efficient to use entryList(). + +

QStrList QDir::encodedEntryList ( const QString & nameFilter, int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const [virtual] +

+This function is obsolete. It is provided to keep old source working. We strongly advise against using it in new code. +

This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +

This function is included to easy porting from Qt 1.x to Qt 2.0, +it is the same as entryList(), but encodes the filenames as 8-bit +strings using QFile::encodedName(). +

It is more efficient to use entryList(). + +

const QFileInfoList * QDir::entryInfoList ( const QString & nameFilter, int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const [virtual] +

+Returns a list of QFileInfo objects for all the files and +directories in the directory, ordered in accordance with +setSorting() and filtered in accordance with setFilter() and +setNameFilter(). +

The filter and sorting specifications can be overridden using the +nameFilter, filterSpec and sortSpec arguments. +

Returns 0 if the directory is unreadable or does not exist. +

The returned pointer is a const pointer to a QFileInfoList. The +list is owned by the QDir object and will be reused on the next +call to entryInfoList() for the same QDir instance. If you want to +keep the entries of the list after a subsequent call to this +function you must copy them. +

Note: QFileInfoList is really a QPtrList. +

See also entryList(), setNameFilter(), setSorting(), and setFilter(). + +

Examples: dirview/dirview.cpp and fileiconview/qfileiconview.cpp. +

const QFileInfoList * QDir::entryInfoList ( int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const [virtual] +

+This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +

Returns a list of QFileInfo objects for all the files and +directories in the directory, ordered in accordance with +setSorting() and filtered in accordance with setFilter() and +setNameFilter(). +

The filter and sorting specifications can be overridden using the +filterSpec and sortSpec arguments. +

Returns 0 if the directory is unreadable or does not exist. +

The returned pointer is a const pointer to a QFileInfoList. The +list is owned by the QDir object and will be reused on the next +call to entryInfoList() for the same QDir instance. If you want to +keep the entries of the list after a subsequent call to this +function you must copy them. +

Note: QFileInfoList is really a QPtrList. +

See also entryList(), setNameFilter(), setSorting(), and setFilter(). + +

QStringList QDir::entryList ( const QString & nameFilter, int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const [virtual] +

+Returns a list of the names of all the files and directories in +the directory, ordered in accordance with setSorting() and +filtered in accordance with setFilter() and setNameFilter(). +

The filter and sorting specifications can be overridden using the +nameFilter, filterSpec and sortSpec arguments. +

Returns an empty list if the directory is unreadable or does not +exist. +

See also entryInfoList(), setNameFilter(), setSorting(), and setFilter(). + +

Example: table/statistics/statistics.cpp. +

QStringList QDir::entryList ( int filterSpec = DefaultFilter, int sortSpec = DefaultSort ) const [virtual] +

+This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +

Returns a list of the names of all the files and directories in +the directory, ordered in accordance with setSorting() and +filtered in accordance with setFilter() and setNameFilter(). +

The filter and sorting specifications can be overridden using the +filterSpec and sortSpec arguments. +

Returns an empty list if the directory is unreadable or does not +exist. +

See also entryInfoList(), setNameFilter(), setSorting(), and setFilter(). + +

bool QDir::exists ( const QString & name, bool acceptAbsPath = TRUE ) [virtual] +

+Checks for the existence of the file name. +

If acceptAbsPath is TRUE a path starting with separator "/" +will check the file with the absolute path. If acceptAbsPath is +FALSE any number of separators at the beginning of name will be +removed and the resultant file name will be checked. +

Returns TRUE if the file exists; otherwise returns FALSE. +

See also QFileInfo::exists() and QFile::exists(). + +

bool QDir::exists () const [virtual] +

+This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +

Returns TRUE if the directory exists; otherwise returns FALSE. +(If a file with the same name is found this function will return +FALSE). +

See also QFileInfo::exists() and QFile::exists(). + +

QString QDir::filePath ( const QString & fileName, bool acceptAbsPath = TRUE ) const [virtual] +

+Returns the path name of a file in the directory. Does not +check if the file actually exists in the directory. If the QDir is +relative the returned path name will also be relative. Redundant +multiple separators or "." and ".." directories in fileName +will not be removed (see cleanDirPath()). +

If acceptAbsPath is TRUE a fileName starting with a +separator "/" will be returned without change. If acceptAbsPath +is FALSE an absolute path will be prepended to the fileName and +the resultant string returned. +

See also absFilePath(), isRelative(), and canonicalPath(). + +

FilterSpec QDir::filter () const +

+ +

Returns the value set by setFilter() + +

QDir QDir::home () [static] +

+Returns the home directory. +

Under Windows the HOME environment variable is used. If this +does not exist the USERPROFILE environment variable is used. If +that does not exist the path is formed by concatenating the HOMEDRIVE and HOMEPATH environment variables. If they don't +exist the rootDirPath() is used (this uses the SystemDrive +environment variable). If none of these exist "C:\" is used. +

Under non-Windows operating systems the HOME environment +variable is used if it exists, otherwise rootDirPath() is used. +

See also homeDirPath(). + +

QString QDir::homeDirPath () [static] +

+ +

Returns the absolute path of the user's home directory. +

See also home(). + +

bool QDir::isReadable () const [virtual] +

+Returns TRUE if the directory is readable and we can open files +by name; otherwise returns FALSE. +

Warning: A FALSE value from this function is not a guarantee that +files in the directory are not accessible. +

See also QFileInfo::isReadable(). + +

Examples: dirview/dirview.cpp and fileiconview/qfileiconview.cpp. +

bool QDir::isRelative () const [virtual] +

+Returns TRUE if the directory path is relative to the current +directory and returns FALSE if the path is absolute (e.g. under +UNIX a path is relative if it does not start with a "/"). +

See also convertToAbs(). + +

bool QDir::isRelativePath ( const QString & path ) [static] +

+Returns TRUE if path is relative; returns FALSE if it is +absolute. +

See also isRelative(). + +

bool QDir::isRoot () const [virtual] +

+Returns TRUE if the directory is the root directory; otherwise +returns FALSE. +

Note: If the directory is a symbolic link to the root directory +this function returns FALSE. If you want to test for this use +canonicalPath(), e.g. +

+    QDir d( "/tmp/root_link" );
+    d = d.canonicalPath();
+    if ( d.isRoot() )
+        qWarning( "It is a root link" );
+
+ +

See also root() and rootDirPath(). + +

bool QDir::match ( const QString & filter, const QString & fileName ) [static] +

+Returns TRUE if the fileName matches the wildcard (glob) +pattern filter; otherwise returns FALSE. The filter may +contain multiple patterns separated by spaces or semicolons. +

(See QRegExp wildcard + matching.) +

See also QRegExp::match(). + +

bool QDir::match ( const QStringList & filters, const QString & fileName ) [static] +

+This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +

Returns TRUE if the fileName matches any of the wildcard (glob) +patterns in the list of filters; otherwise returns FALSE. +

(See QRegExp wildcard + matching.) +

See also QRegExp::match(). + +

bool QDir::matchAllDirs () const +

+ +

Returns the value set by setMatchAllDirs() +

See also setMatchAllDirs(). + +

bool QDir::mkdir ( const QString & dirName, bool acceptAbsPath = TRUE ) const [virtual] +

+Creates a directory. +

If acceptAbsPath is TRUE a path starting with a separator ('/') +will create the absolute directory; if acceptAbsPath is FALSE +any number of separators at the beginning of dirName will be +removed. +

Returns TRUE if successful; otherwise returns FALSE. +

See also rmdir(). + +

QString QDir::nameFilter () const +

+ +

Returns the string set by setNameFilter() + +

bool QDir::operator!= ( const QDir & d ) const [virtual] +

+ +

Returns TRUE if directory d and this directory have different +paths or different sort or filter settings; otherwise returns +FALSE. +

Example: +

+    // The current directory is "/usr/local"
+    QDir d1( "/usr/local/bin" );
+    QDir d2( "bin" );
+    if ( d1 != d2 )
+        qDebug( "They differ" );
+
+ + +

QDir & QDir::operator= ( const QDir & d ) +

+Makes a copy of QDir d and assigns it to this QDir. + +

QDir & QDir::operator= ( const QString & path ) +

+This is an overloaded member function, provided for convenience. It behaves essentially like the above function. +

Sets the directory path to be the given path. + +

bool QDir::operator== ( const QDir & d ) const [virtual] +

+Returns TRUE if directory d and this directory have the same +path and their sort and filter settings are the same; otherwise +returns FALSE. +

Example: +

+    // The current directory is "/usr/local"
+    QDir d1( "/usr/local/bin" );
+    QDir d2( "bin" );
+    d2.convertToAbs();
+    if ( d1 == d2 )
+        qDebug( "They're the same" );
+
+ + +

QString QDir::operator[] ( int index ) const +

+Returns the file name at position index in the list of file +names. Equivalent to entryList().at(index). +

Returns a QString::null if the index is out of range or if the +entryList() function failed. +

See also count() and entryList(). + +

QString QDir::path () const [virtual] +

+ +

Returns the path, this may contain symbolic links, but never +contains redundant ".", ".." or multiple separators. +

The returned path can be either absolute or relative (see +setPath()). +

See also setPath(), absPath(), exists(), cleanDirPath(), dirName(), absFilePath(), and convertSeparators(). + +

void QDir::refresh () const +

+Refreshes the directory information. + +

bool QDir::remove ( const QString & fileName, bool acceptAbsPath = TRUE ) [virtual] +

+Removes the file, fileName. +

If acceptAbsPath is TRUE a path starting with separator "/" +will remove the file with the absolute path. If acceptAbsPath +is FALSE any number of separators at the beginning of fileName +will be removed and the resultant file name will be removed. +

Returns TRUE if the file is removed successfully; otherwise +returns FALSE. + +

bool QDir::rename ( const QString & oldName, const QString & newName, bool acceptAbsPaths = TRUE ) [virtual] +

+Renames a file or directory. +

If acceptAbsPaths is TRUE a path starting with a separator +('/') will rename the file with the absolute path; if acceptAbsPaths is FALSE any number of separators at the beginning +of the names will be removed. +

Returns TRUE if successful; otherwise returns FALSE. +

On most file systems, rename() fails only if oldName does not +exist or if newName and oldName are not on the same +partition. On Windows, rename() will fail if newName already +exists. However, there are also other reasons why rename() can +fail. For example, on at least one file system rename() fails if +newName points to an open file. + +

Example: fileiconview/qfileiconview.cpp. +

bool QDir::rmdir ( const QString & dirName, bool acceptAbsPath = TRUE ) const [virtual] +

+Removes a directory. +

If acceptAbsPath is TRUE a path starting with a separator ('/') +will remove the absolute directory; if acceptAbsPath is FALSE +any number of separators at the beginning of dirName will be +removed. +

The directory must be empty for rmdir() to succeed. +

Returns TRUE if successful; otherwise returns FALSE. +

See also mkdir(). + +

QDir QDir::root () [static] +

+Returns the root directory. +

See also rootDirPath() and drives(). + +

QString QDir::rootDirPath () [static] +

+Returns the absolute path for the root directory. +

For UNIX operating systems this returns "/". For Windows file +systems this normally returns "c:/". +

See also root() and drives(). + +

char QDir::separator () [static] +

+Returns the native directory separator; "/" under UNIX (including +Mac OS X) and "\" under Windows. +

You do not need to use this function to build file paths. If you +always use "/", Qt will translate your paths to conform to the +underlying operating system. + +

bool QDir::setCurrent ( const QString & path ) [static] +

+Sets the application's current working directory to path. +Returns TRUE if the directory was successfully changed; otherwise +returns FALSE. + +

void QDir::setFilter ( int filterSpec ) [virtual] +

+Sets the filter used by entryList() and entryInfoList() to filterSpec. The filter is used to specify the kind of files that +should be returned by entryList() and entryInfoList(). See +QDir::FilterSpec. +

See also filter() and setNameFilter(). + +

void QDir::setMatchAllDirs ( bool enable ) [virtual] +

+If enable is TRUE then all directories are included (e.g. in +entryList()), and the nameFilter() is only applied to the files. +If enable is FALSE then the nameFilter() is applied to both +directories and files. +

See also matchAllDirs(). + +

void QDir::setNameFilter ( const QString & nameFilter ) [virtual] +

+Sets the name filter used by entryList() and entryInfoList() to nameFilter. +

The nameFilter is a wildcard (globbing) filter that understands +"*" and "?" wildcards. (See QRegExp wildcard matching.) You may specify several filter +entries all separated by a single space " " or by a semi-colon +";". +

For example, if you want entryList() and entryInfoList() to list +all files ending with either ".cpp" or ".h", you would use either +dir.setNameFilter("*.cpp *.h") or dir.setNameFilter("*.cpp;*.h"). +

See also nameFilter() and setFilter(). + +

void QDir::setPath ( const QString & path ) [virtual] +

+Sets the path of the directory to path. The path is cleaned of +redundant ".", ".." and of multiple separators. No check is made +to ensure that a directory with this path exists. +

The path can be either absolute or relative. Absolute paths begin +with the directory separator "/" (optionally preceded by a drive +specification under Windows). Relative file names begin with a +directory name or a file name and specify a path relative to the +current directory. An example of an absolute path is the string +"/tmp/quartz", a relative path might look like "src/fatlib". +

See also path(), absPath(), exists(), cleanDirPath(), dirName(), absFilePath(), isRelative(), and convertToAbs(). + +

void QDir::setSorting ( int sortSpec ) [virtual] +

+Sets the sort order used by entryList() and entryInfoList(). +

The sortSpec is specified by OR-ing values from the enum +QDir::SortSpec. +

See also sorting() and SortSpec. + +

SortSpec QDir::sorting () const +

+ +

Returns the value set by setSorting() +

See also setSorting() and SortSpec. + + +

+This file is part of the Qt toolkit. +Copyright © 1995-2007 +Trolltech. All Rights Reserved.

+ +
Copyright © 2007 +TrolltechTrademarks +
Qt 3.3.8
+
+ -- cgit v1.2.1