<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en_US" lang="en_US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qfileinfo.cpp -->
<title>Qt 4.8: QFileInfo Class Reference</title>
<link rel="stylesheet" type="text/css" href="style/style.css" />
<script src="scripts/jquery.js" type="text/javascript"></script>
<script src="scripts/functions.js" type="text/javascript"></script>
<link rel="stylesheet" type="text/css" href="style/superfish.css" />
<link rel="stylesheet" type="text/css" href="style/narrow.css" />
<!--[if IE]>
<meta name="MSSmartTagsPreventParsing" content="true">
<meta http-equiv="imagetoolbar" content="no">
<![endif]-->
<!--[if lt IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie6.css">
<![endif]-->
<!--[if IE 7]>
<link rel="stylesheet" type="text/css" href="style/style_ie7.css">
<![endif]-->
<!--[if IE 8]>
<link rel="stylesheet" type="text/css" href="style/style_ie8.css">
<![endif]-->
<script src="scripts/superfish.js" type="text/javascript"></script>
<script src="scripts/narrow.js" type="text/javascript"></script>
</head>
<body class="" onload="CheckEmptyAndLoadList();">
<div class="header" id="qtdocheader">
<div class="content">
<div id="nav-logo">
<a href="index.html">Home</a></div>
<a href="index.html" class="qtref"><span>Qt Reference Documentation</span></a>
<div id="narrowsearch"></div>
<div id="nav-topright">
<ul>
<li class="nav-topright-home"><a href="http://qt.digia.com/">Qt HOME</a></li>
<li class="nav-topright-dev"><a href="http://qt-project.org/">DEV</a></li>
<li class="nav-topright-doc nav-topright-doc-active"><a href="http://qt-project.org/doc/">
DOC</a></li>
<li class="nav-topright-blog"><a href="http://blog.qt.digia.com/">BLOG</a></li>
</ul>
</div>
<div id="shortCut">
<ul>
<li class="shortCut-topleft-inactive"><span><a href="index.html">Qt 4.8</a></span></li>
<li class="shortCut-topleft-active"><a href="http://qt-project.org/doc/">ALL VERSIONS </a></li>
</ul>
</div>
<ul class="sf-menu" id="narrowmenu">
<li><a href="#">API Lookup</a>
<ul>
<li><a href="classes.html">Class index</a></li>
<li><a href="functions.html">Function index</a></li>
<li><a href="modules.html">Modules</a></li>
<li><a href="namespaces.html">Namespaces</a></li>
<li><a href="qtglobal.html">Global Declarations</a></li>
<li><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</li>
<li><a href="#">Qt Topics</a>
<ul>
<li><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li><a href="supported-platforms.html">Supported Platforms</a></li>
<li><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</li>
<li><a href="#">Examples</a>
<ul>
<li><a href="all-examples.html">Examples</a></li>
<li><a href="tutorials.html">Tutorials</a></li>
<li><a href="demos.html">Demos</a></li>
<li><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div class="wrapper">
<div class="hd">
<span></span>
</div>
<div class="bd group">
<div class="sidebar">
<div class="searchlabel">
Search index:</div>
<div class="search" id="sidebarsearch">
<form id="qtdocsearch" action="" onsubmit="return false;">
<fieldset>
<input type="text" name="searchstring" id="pageType" value="" />
<div id="resultdialog">
<a href="#" id="resultclose">Close</a>
<p id="resultlinks" class="all"><a href="#" id="showallresults">All</a> | <a href="#" id="showapiresults">API</a> | <a href="#" id="showarticleresults">Articles</a> | <a href="#" id="showexampleresults">Examples</a></p>
<p id="searchcount" class="all"><span id="resultcount"></span><span id="apicount"></span><span id="articlecount"></span><span id="examplecount"></span> results:</p>
<ul id="resultlist" class="all">
</ul>
</div>
</fieldset>
</form>
</div>
<div class="box first bottombar" id="lookup">
<h2 title="API Lookup"><span></span>
API Lookup</h2>
<div id="list001" class="list">
<ul id="ul001" >
<li class="defaultLink"><a href="classes.html">Class index</a></li>
<li class="defaultLink"><a href="functions.html">Function index</a></li>
<li class="defaultLink"><a href="modules.html">Modules</a></li>
<li class="defaultLink"><a href="namespaces.html">Namespaces</a></li>
<li class="defaultLink"><a href="qtglobal.html">Global Declarations</a></li>
<li class="defaultLink"><a href="qdeclarativeelements.html">QML elements</a></li>
</ul>
</div>
</div>
<div class="box bottombar" id="topics">
<h2 title="Qt Topics"><span></span>
Qt Topics</h2>
<div id="list002" class="list">
<ul id="ul002" >
<li class="defaultLink"><a href="qt-basic-concepts.html">Programming with Qt</a></li>
<li class="defaultLink"><a href="qtquick.html">Device UIs & Qt Quick</a></li>
<li class="defaultLink"><a href="qt-gui-concepts.html">UI Design with Qt</a></li>
<li class="defaultLink"><a href="supported-platforms.html">Supported Platforms</a></li>
<li class="defaultLink"><a href="technology-apis.html">Qt and Key Technologies</a></li>
<li class="defaultLink"><a href="best-practices.html">How-To's and Best Practices</a></li>
</ul>
</div>
</div>
<div class="box" id="examples">
<h2 title="Examples"><span></span>
Examples</h2>
<div id="list003" class="list">
<ul id="ul003">
<li class="defaultLink"><a href="all-examples.html">Examples</a></li>
<li class="defaultLink"><a href="tutorials.html">Tutorials</a></li>
<li class="defaultLink"><a href="demos.html">Demos</a></li>
<li class="defaultLink"><a href="qdeclarativeexamples.html">QML Examples</a></li>
</ul>
</div>
</div>
</div>
<div class="wrap">
<div class="toolbar">
<div class="breadcrumb toolblock">
<ul>
<li class="first"><a href="index.html">Home</a></li>
<!-- Breadcrumbs go here -->
<li><a href="modules.html">Modules</a></li>
<li><a href="qtcore.html">QtCore</a></li>
<li>QFileInfo</li>
</ul>
</div>
<div class="toolbuttons toolblock">
<ul>
<li id="smallA" class="t_button">A</li>
<li id="medA" class="t_button active">A</li>
<li id="bigA" class="t_button">A</li>
<li id="print" class="t_button"><a href="javascript:this.print();">
<span>Print</span></a></li>
</ul>
</div>
</div>
<div class="content mainContent">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#public-types">Public Types</a></li>
<li class="level1"><a href="#public-functions">Public Functions</a></li>
<li class="level1"><a href="#related-non-members">Related Non-Members</a></li>
<li class="level1"><a href="#details">Detailed Description</a></li>
<li class="level2"><a href="#performance-issues">Performance Issues</a></li>
</ul>
</div>
<h1 class="title">QFileInfo Class Reference</h1>
<!-- $$$QFileInfo-brief -->
<p>The QFileInfo class provides system-independent file information. <a href="#details">More...</a></p>
<!-- @@@QFileInfo -->
<pre class="cpp"> <span class="preprocessor">#include <QFileInfo></span></pre><p><b>Note:</b> All functions in this class are <a href="threads-reentrancy.html#reentrant">reentrant</a>.</p>
<ul>
<li><a href="qfileinfo-members.html">List of all members, including inherited members</a></li>
<li><a href="qfileinfo-obsolete.html">Obsolete members</a></li>
<li><a href="qfileinfo-qt3.html">Qt 3 support members</a></li>
</ul>
<a name="public-types"></a>
<h2>Public Types</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> flags </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#Permission-enum">PermissionSpec</a></b></td></tr>
</table>
<a name="public-functions"></a>
<h2>Public Functions</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#QFileInfo">QFileInfo</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#QFileInfo-3">QFileInfo</a></b> ( const QString & <i>file</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#QFileInfo-4">QFileInfo</a></b> ( const QFile & <i>file</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#QFileInfo-5">QFileInfo</a></b> ( const QDir & <i>dir</i>, const QString & <i>file</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#QFileInfo-6">QFileInfo</a></b> ( const QFileInfo & <i>fileinfo</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#dtor.QFileInfo">~QFileInfo</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QDir </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#absoluteDir">absoluteDir</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#absoluteFilePath">absoluteFilePath</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#absolutePath">absolutePath</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#baseName">baseName</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#bundleName">bundleName</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#caching">caching</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#canonicalFilePath">canonicalFilePath</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#canonicalPath">canonicalPath</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#completeBaseName">completeBaseName</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#completeSuffix">completeSuffix</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QDateTime </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#created">created</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QDir </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#dir">dir</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#exists">exists</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#fileName">fileName</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#filePath">filePath</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#group">group</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> uint </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#groupId">groupId</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#isAbsolute">isAbsolute</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#isBundle">isBundle</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#isDir">isDir</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#isExecutable">isExecutable</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#isFile">isFile</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#isHidden">isHidden</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#isReadable">isReadable</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#isRelative">isRelative</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#isRoot">isRoot</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#isSymLink">isSymLink</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#isWritable">isWritable</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QDateTime </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#lastModified">lastModified</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QDateTime </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#lastRead">lastRead</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#makeAbsolute">makeAbsolute</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#owner">owner</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> uint </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#ownerId">ownerId</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#path">path</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#permission">permission</a></b> ( QFile::Permissions <i>permissions</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QFile::Permissions </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#permissions">permissions</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#refresh">refresh</a></b> ()</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#setCaching">setCaching</a></b> ( bool <i>enable</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#setFile">setFile</a></b> ( const QString & <i>file</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#setFile-2">setFile</a></b> ( const QFile & <i>file</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> void </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#setFile-3">setFile</a></b> ( const QDir & <i>dir</i>, const QString & <i>file</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> qint64 </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#size">size</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#suffix">suffix</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QString </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#symLinkTarget">symLinkTarget</a></b> () const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#operator-not-eq">operator!=</a></b> ( const QFileInfo & <i>fileinfo</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#operator-not-eq-2">operator!=</a></b> ( const QFileInfo & <i>fileinfo</i> ) const</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> QFileInfo & </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#operator-eq">operator=</a></b> ( const QFileInfo & <i>fileinfo</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#operator-eq-eq">operator==</a></b> ( const QFileInfo & <i>fileinfo</i> )</td></tr>
<tr><td class="memItemLeft rightAlign topAlign"> bool </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#operator-eq-eq-2">operator==</a></b> ( const QFileInfo & <i>fileinfo</i> ) const</td></tr>
</table>
<a name="related-non-members"></a>
<h2>Related Non-Members</h2>
<table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> typedef </td><td class="memItemRight bottomAlign"><b><a href="qfileinfo.html#QFileInfoList-typedef">QFileInfoList</a></b></td></tr>
</table>
<a name="details"></a>
<!-- $$$QFileInfo-description -->
<div class="descr">
<h2>Detailed Description</h2>
<p>The QFileInfo class provides system-independent file information.</p>
<p>QFileInfo provides information about a file's name and position (path) in the file system, its access rights and whether it is a directory or symbolic link, etc. The file's size and last modified/read times are also available. QFileInfo can also be used to obtain information about a Qt <a href="resources.html#resource-system">resource</a>.</p>
<p>A QFileInfo can point to a file with either a relative or an absolute file path. Absolute file paths begin with the directory separator "/" (or with a drive specification on Windows). Relative file names begin with a directory name or a file name and specify a path relative to the current working directory. An example of an absolute path is the string "/tmp/quartz". A relative path might look like "src/fatlib". You can use the function <a href="qfileinfo.html#isRelative">isRelative</a>() to check whether a QFileInfo is using a relative or an absolute file path. You can call the function <a href="qfileinfo.html#makeAbsolute">makeAbsolute</a>() to convert a relative QFileInfo's path to an absolute path.</p>
<p>The file that the QFileInfo works on is set in the constructor or later with <a href="qfileinfo.html#setFile">setFile</a>(). Use <a href="qfileinfo.html#exists">exists</a>() to see if the file exists and <a href="qfileinfo.html#size">size</a>() to get its size.</p>
<p>The file's type is obtained with <a href="qfileinfo.html#isFile">isFile</a>(), <a href="qfileinfo.html#isDir">isDir</a>() and <a href="qfileinfo.html#isSymLink">isSymLink</a>(). The <a href="qfileinfo.html#symLinkTarget">symLinkTarget</a>() function provides the name of the file the symlink points to.</p>
<p>On Unix (including Mac OS X), the symlink has the same <a href="qfileinfo.html#size">size</a>() has the file it points to, because Unix handles symlinks transparently; similarly, opening a symlink using <a href="qfile.html">QFile</a> effectively opens the link's target. For example:</p>
<pre class="cpp"> <span class="preprocessor">#ifdef Q_OS_UNIX</span>
<span class="type">QFileInfo</span> info1(<span class="string">"/home/bob/bin/untabify"</span>);
info1<span class="operator">.</span><a href="qfileinfo.html#isSymLink">isSymLink</a>(); <span class="comment">// returns true</span>
info1<span class="operator">.</span><a href="qfileinfo.html#absoluteFilePath">absoluteFilePath</a>(); <span class="comment">// returns "/home/bob/bin/untabify"</span>
info1<span class="operator">.</span><a href="qfileinfo.html#size">size</a>(); <span class="comment">// returns 56201</span>
info1<span class="operator">.</span><a href="qfileinfo.html#symLinkTarget">symLinkTarget</a>(); <span class="comment">// returns "/opt/pretty++/bin/untabify"</span>
<span class="type">QFileInfo</span> info2(info1<span class="operator">.</span>symLinkTarget());
info2<span class="operator">.</span><a href="qfileinfo.html#isSymLink">isSymLink</a>(); <span class="comment">// returns false</span>
info2<span class="operator">.</span><a href="qfileinfo.html#absoluteFilePath">absoluteFilePath</a>(); <span class="comment">// returns "/opt/pretty++/bin/untabify"</span>
info2<span class="operator">.</span><a href="qfileinfo.html#size">size</a>(); <span class="comment">// returns 56201</span>
<span class="preprocessor">#endif</span></pre>
<p>On Windows, symlinks (shortcuts) are <tt>.lnk</tt> files. The reported <a href="qfileinfo.html#size">size</a>() is that of the symlink (not the link's target), and opening a symlink using <a href="qfile.html">QFile</a> opens the <tt>.lnk</tt> file. For example:</p>
<pre class="cpp"> <span class="preprocessor">#ifdef Q_OS_WIN</span>
<span class="type">QFileInfo</span> info1(<span class="string">"C:\\Documents and Settings\\Bob\\untabify.lnk"</span>);
info1<span class="operator">.</span><a href="qfileinfo.html#isSymLink">isSymLink</a>(); <span class="comment">// returns true</span>
info1<span class="operator">.</span><a href="qfileinfo.html#absoluteFilePath">absoluteFilePath</a>(); <span class="comment">// returns "C:/Documents and Settings/Bob/untabify.lnk"</span>
info1<span class="operator">.</span><a href="qfileinfo.html#size">size</a>(); <span class="comment">// returns 743</span>
info1<span class="operator">.</span><a href="qfileinfo.html#symLinkTarget">symLinkTarget</a>(); <span class="comment">// returns "C:/Pretty++/untabify"</span>
<span class="type">QFileInfo</span> info2(info1<span class="operator">.</span>symLinkTarget());
info2<span class="operator">.</span><a href="qfileinfo.html#isSymLink">isSymLink</a>(); <span class="comment">// returns false</span>
info2<span class="operator">.</span><a href="qfileinfo.html#absoluteFilePath">absoluteFilePath</a>(); <span class="comment">// returns "C:/Pretty++/untabify"</span>
info2<span class="operator">.</span><a href="qfileinfo.html#size">size</a>(); <span class="comment">// returns 63942</span>
<span class="preprocessor">#endif</span></pre>
<p>Elements of the file's name can be extracted with <a href="qfileinfo.html#path">path</a>() and <a href="qfileinfo.html#fileName">fileName</a>(). The <a href="qfileinfo.html#fileName">fileName</a>()'s parts can be extracted with <a href="qfileinfo.html#baseName">baseName</a>(), <a href="qfileinfo.html#suffix">suffix</a>() or <a href="qfileinfo.html#completeSuffix">completeSuffix</a>(). QFileInfo objects to directories created by Qt classes will not have a trailing file separator. If you wish to use trailing separators in your own file info objects, just append one to the file name given to the constructors or <a href="qfileinfo.html#setFile">setFile</a>().</p>
<p>The file's dates are returned by <a href="qfileinfo.html#created">created</a>(), <a href="qfileinfo.html#lastModified">lastModified</a>() and <a href="qfileinfo.html#lastRead">lastRead</a>(). Information about the file's access permissions is obtained with <a href="qfileinfo.html#isReadable">isReadable</a>(), <a href="qfileinfo.html#isWritable">isWritable</a>() and <a href="qfileinfo.html#isExecutable">isExecutable</a>(). The file's ownership is available from <a href="qfileinfo.html#owner">owner</a>(), <a href="qfileinfo.html#ownerId">ownerId</a>(), <a href="qfileinfo.html#group">group</a>() and <a href="qfileinfo.html#groupId">groupId</a>(). You can examine a file's permissions and ownership in a single statement using the <a href="qfileinfo.html#permission">permission</a>() function.</p>
<a name="performance-issues"></a>
<h3>Performance Issues</h3>
<p>Some of QFileInfo's functions query the file system, but for performance reasons, some functions only operate on the file name itself. For example: To return the absolute path of a relative file name, <a href="qfileinfo.html#absolutePath">absolutePath</a>() has to query the file system. The <a href="qfileinfo.html#path">path</a>() function, however, can work on the file name directly, and so it is faster.</p>
<p><b>Note:</b> To speed up performance, QFileInfo caches information about the file.</p>
<p>To speed up performance, QFileInfo caches information about the file. Because files can be changed by other users or programs, or even by other parts of the same program, there is a function that refreshes the file information: <a href="qfileinfo.html#refresh">refresh</a>(). If you want to switch off a QFileInfo's caching and force it to access the file system every time you request information from it call setCaching(false).</p>
</div>
<p><b>See also </b><a href="qdir.html">QDir</a> and <a href="qfile.html">QFile</a>.</p>
<!-- @@@QFileInfo -->
<div class="func">
<h2>Member Function Documentation</h2>
<!-- $$$QFileInfo[overload1]$$$QFileInfo -->
<h3 class="fn"><a name="QFileInfo"></a>QFileInfo::<span class="name">QFileInfo</span> ()</h3>
<p>Constructs an empty <a href="qfileinfo.html">QFileInfo</a> object.</p>
<p>Note that an empty <a href="qfileinfo.html">QFileInfo</a> object contain no file reference.</p>
<p><b>See also </b><a href="qfileinfo.html#setFile">setFile</a>().</p>
<!-- @@@QFileInfo -->
<!-- $$$QFileInfo$$$QFileInfoconstQString& -->
<h3 class="fn"><a name="QFileInfo-3"></a>QFileInfo::<span class="name">QFileInfo</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>file</i> )</h3>
<p>Constructs a new <a href="qfileinfo.html">QFileInfo</a> that gives information about the given file. The <i>file</i> can also include an absolute or relative path.</p>
<p><b>See also </b><a href="qfileinfo.html#setFile">setFile</a>(), <a href="qfileinfo.html#isRelative">isRelative</a>(), <a href="qdir.html#setCurrent">QDir::setCurrent</a>(), and <a href="qdir.html#isRelativePath">QDir::isRelativePath</a>().</p>
<!-- @@@QFileInfo -->
<!-- $$$QFileInfo$$$QFileInfoconstQFile& -->
<h3 class="fn"><a name="QFileInfo-4"></a>QFileInfo::<span class="name">QFileInfo</span> ( const <span class="type"><a href="qfile.html">QFile</a></span> & <i>file</i> )</h3>
<p>Constructs a new <a href="qfileinfo.html">QFileInfo</a> that gives information about file <i>file</i>.</p>
<p>If the <i>file</i> has a relative path, the <a href="qfileinfo.html">QFileInfo</a> will also have a relative path.</p>
<p><b>See also </b><a href="qfileinfo.html#isRelative">isRelative</a>().</p>
<!-- @@@QFileInfo -->
<!-- $$$QFileInfo$$$QFileInfoconstQDir&constQString& -->
<h3 class="fn"><a name="QFileInfo-5"></a>QFileInfo::<span class="name">QFileInfo</span> ( const <span class="type"><a href="qdir.html">QDir</a></span> & <i>dir</i>, const <span class="type"><a href="qstring.html">QString</a></span> & <i>file</i> )</h3>
<p>Constructs a new <a href="qfileinfo.html">QFileInfo</a> that gives information about the given <i>file</i> in the directory <i>dir</i>.</p>
<p>If <i>dir</i> has a relative path, the <a href="qfileinfo.html">QFileInfo</a> will also have a relative path.</p>
<p>If <i>file</i> is an absolute path, then the directory specified by <i>dir</i> will be disregarded.</p>
<p><b>See also </b><a href="qfileinfo.html#isRelative">isRelative</a>().</p>
<!-- @@@QFileInfo -->
<!-- $$$QFileInfo$$$QFileInfoconstQFileInfo& -->
<h3 class="fn"><a name="QFileInfo-6"></a>QFileInfo::<span class="name">QFileInfo</span> ( const <span class="type">QFileInfo</span> & <i>fileinfo</i> )</h3>
<p>Constructs a new <a href="qfileinfo.html">QFileInfo</a> that is a copy of the given <i>fileinfo</i>.</p>
<!-- @@@QFileInfo -->
<!-- $$$~QFileInfo[overload1]$$$~QFileInfo -->
<h3 class="fn"><a name="dtor.QFileInfo"></a>QFileInfo::<span class="name">~QFileInfo</span> ()</h3>
<p>Destroys the <a href="qfileinfo.html">QFileInfo</a> and frees its resources.</p>
<!-- @@@~QFileInfo -->
<!-- $$$absoluteDir[overload1]$$$absoluteDir -->
<h3 class="fn"><a name="absoluteDir"></a><span class="type"><a href="qdir.html">QDir</a></span> QFileInfo::<span class="name">absoluteDir</span> () const</h3>
<p>Returns the file's absolute path as a <a href="qdir.html">QDir</a> object.</p>
<p><b>See also </b><a href="qfileinfo.html#dir">dir</a>(), <a href="qfileinfo.html#filePath">filePath</a>(), <a href="qfileinfo.html#fileName">fileName</a>(), and <a href="qfileinfo.html#isRelative">isRelative</a>().</p>
<!-- @@@absoluteDir -->
<!-- $$$absoluteFilePath[overload1]$$$absoluteFilePath -->
<h3 class="fn"><a name="absoluteFilePath"></a><span class="type"><a href="qstring.html">QString</a></span> QFileInfo::<span class="name">absoluteFilePath</span> () const</h3>
<p>Returns an absolute path including the file name.</p>
<p>The absolute path name consists of the full path and the file name. On Unix this will always begin with the root, '/', directory. On Windows this will always begin 'D:/' where D is a drive letter, except for network shares that are not mapped to a drive letter, in which case the path will begin '//sharename/'. <a href="qfileinfo.html">QFileInfo</a> will uppercase drive letters. Note that <a href="qdir.html">QDir</a> does not do this. The code snippet below shows this.</p>
<pre class="cpp"> <span class="type"><a href="qfileinfo.html">QFileInfo</a></span> fi(<span class="string">"c:/temp/foo"</span>); <span class="operator">=</span><span class="operator">></span> fi<span class="operator">.</span>absoluteFilePath() <span class="operator">=</span><span class="operator">></span> <span class="string">"C:/temp/foo"</span></pre>
<p>This function returns the same as <a href="qfileinfo.html#filePath">filePath</a>(), unless <a href="qfileinfo.html#isRelative">isRelative</a>() is true. In contrast to <a href="qfileinfo.html#canonicalFilePath">canonicalFilePath</a>(), symbolic links or redundant "." or ".." elements are not necessarily removed.</p>
<p>If the <a href="qfileinfo.html">QFileInfo</a> is empty it returns <a href="qdir.html#currentPath">QDir::currentPath</a>().</p>
<p><b>See also </b><a href="qfileinfo.html#filePath">filePath</a>(), <a href="qfileinfo.html#canonicalFilePath">canonicalFilePath</a>(), and <a href="qfileinfo.html#isRelative">isRelative</a>().</p>
<!-- @@@absoluteFilePath -->
<!-- $$$absolutePath[overload1]$$$absolutePath -->
<h3 class="fn"><a name="absolutePath"></a><span class="type"><a href="qstring.html">QString</a></span> QFileInfo::<span class="name">absolutePath</span> () const</h3>
<p>Returns a file's path absolute path. This doesn't include the file name.</p>
<p>On Unix the absolute path will always begin with the root, '/', directory. On Windows this will always begin 'D:/' where D is a drive letter, except for network shares that are not mapped to a drive letter, in which case the path will begin '//sharename/'.</p>
<p>In contrast to <a href="qfileinfo.html#canonicalPath">canonicalPath</a>() symbolic links or redundant "." or ".." elements are not necessarily removed.</p>
<p><b>Warning:</b> If the <a href="qfileinfo.html">QFileInfo</a> object was created with an empty <a href="qstring.html">QString</a>, the behavior of this function is undefined.</p>
<p><b>See also </b><a href="qfileinfo.html#absoluteFilePath">absoluteFilePath</a>(), <a href="qfileinfo.html#path">path</a>(), <a href="qfileinfo.html#canonicalPath">canonicalPath</a>(), <a href="qfileinfo.html#fileName">fileName</a>(), and <a href="qfileinfo.html#isRelative">isRelative</a>().</p>
<!-- @@@absolutePath -->
<!-- $$$baseName[overload1]$$$baseName -->
<h3 class="fn"><a name="baseName"></a><span class="type"><a href="qstring.html">QString</a></span> QFileInfo::<span class="name">baseName</span> () const</h3>
<p>Returns the base name of the file without the path.</p>
<p>The base name consists of all characters in the file up to (but not including) the <i>first</i> '.' character.</p>
<p>Example:</p>
<pre class="cpp"> <span class="type"><a href="qfileinfo.html">QFileInfo</a></span> fi(<span class="string">"/tmp/archive.tar.gz"</span>);
<span class="type"><a href="qstring.html">QString</a></span> base <span class="operator">=</span> fi<span class="operator">.</span>baseName(); <span class="comment">// base = "archive"</span></pre>
<p>The base name of a file is computed equally on all platforms, independent of file naming conventions (e.g., ".bashrc" on Unix has an empty base name, and the suffix is "bashrc").</p>
<p><b>See also </b><a href="qfileinfo.html#fileName">fileName</a>(), <a href="qfileinfo.html#suffix">suffix</a>(), <a href="qfileinfo.html#completeSuffix">completeSuffix</a>(), and <a href="qfileinfo.html#completeBaseName">completeBaseName</a>().</p>
<!-- @@@baseName -->
<!-- $$$bundleName[overload1]$$$bundleName -->
<h3 class="fn"><a name="bundleName"></a><span class="type"><a href="qstring.html">QString</a></span> QFileInfo::<span class="name">bundleName</span> () const</h3>
<p>Returns the name of the bundle.</p>
<p>On Mac OS X this returns the proper localized name for a bundle if the path <a href="qfileinfo.html#isBundle">isBundle</a>(). On all other platforms an empty <a href="qstring.html">QString</a> is returned.</p>
<p>Example:</p>
<pre class="cpp"> <span class="type"><a href="qfileinfo.html">QFileInfo</a></span> fi(<span class="string">"/Applications/Safari.app"</span>);
<span class="type"><a href="qstring.html">QString</a></span> bundle <span class="operator">=</span> fi<span class="operator">.</span>bundleName(); <span class="comment">// name = "Safari"</span></pre>
<p>This function was introduced in Qt 4.3.</p>
<p><b>See also </b><a href="qfileinfo.html#isBundle">isBundle</a>(), <a href="qfileinfo.html#filePath">filePath</a>(), <a href="qfileinfo.html#baseName">baseName</a>(), and <a href="qfileinfo-qt3.html#extension" class="compat">extension</a>().</p>
<!-- @@@bundleName -->
<!-- $$$caching[overload1]$$$caching -->
<h3 class="fn"><a name="caching"></a><span class="type">bool</span> QFileInfo::<span class="name">caching</span> () const</h3>
<p>Returns true if caching is enabled; otherwise returns false.</p>
<p><b>See also </b><a href="qfileinfo.html#setCaching">setCaching</a>() and <a href="qfileinfo.html#refresh">refresh</a>().</p>
<!-- @@@caching -->
<!-- $$$canonicalFilePath[overload1]$$$canonicalFilePath -->
<h3 class="fn"><a name="canonicalFilePath"></a><span class="type"><a href="qstring.html">QString</a></span> QFileInfo::<span class="name">canonicalFilePath</span> () const</h3>
<p>Returns the canonical path including the file name, i.e. an absolute path without symbolic links or redundant "." or ".." elements.</p>
<p>If the file does not exist, canonicalFilePath() returns an empty string.</p>
<p><b>See also </b><a href="qfileinfo.html#filePath">filePath</a>(), <a href="qfileinfo.html#absoluteFilePath">absoluteFilePath</a>(), and <a href="qfileinfo.html#dir">dir</a>().</p>
<!-- @@@canonicalFilePath -->
<!-- $$$canonicalPath[overload1]$$$canonicalPath -->
<h3 class="fn"><a name="canonicalPath"></a><span class="type"><a href="qstring.html">QString</a></span> QFileInfo::<span class="name">canonicalPath</span> () const</h3>
<p>Returns the file's path canonical path (excluding the file name), i.e. an absolute path without symbolic links or redundant "." or ".." elements.</p>
<p>If the file does not exist, canonicalPath() returns an empty string.</p>
<p><b>See also </b><a href="qfileinfo.html#path">path</a>() and <a href="qfileinfo.html#absolutePath">absolutePath</a>().</p>
<!-- @@@canonicalPath -->
<!-- $$$completeBaseName[overload1]$$$completeBaseName -->
<h3 class="fn"><a name="completeBaseName"></a><span class="type"><a href="qstring.html">QString</a></span> QFileInfo::<span class="name">completeBaseName</span> () const</h3>
<p>Returns the complete base name of the file without the path.</p>
<p>The complete base name consists of all characters in the file up to (but not including) the <i>last</i> '.' character.</p>
<p>Example:</p>
<pre class="cpp"> <span class="type"><a href="qfileinfo.html">QFileInfo</a></span> fi(<span class="string">"/tmp/archive.tar.gz"</span>);
<span class="type"><a href="qstring.html">QString</a></span> base <span class="operator">=</span> fi<span class="operator">.</span>completeBaseName(); <span class="comment">// base = "archive.tar"</span></pre>
<p><b>See also </b><a href="qfileinfo.html#fileName">fileName</a>(), <a href="qfileinfo.html#suffix">suffix</a>(), <a href="qfileinfo.html#completeSuffix">completeSuffix</a>(), and <a href="qfileinfo.html#baseName">baseName</a>().</p>
<!-- @@@completeBaseName -->
<!-- $$$completeSuffix[overload1]$$$completeSuffix -->
<h3 class="fn"><a name="completeSuffix"></a><span class="type"><a href="qstring.html">QString</a></span> QFileInfo::<span class="name">completeSuffix</span> () const</h3>
<p>Returns the complete suffix of the file.</p>
<p>The complete suffix consists of all characters in the file after (but not including) the first '.'.</p>
<p>Example:</p>
<pre class="cpp"> <span class="type"><a href="qfileinfo.html">QFileInfo</a></span> fi(<span class="string">"/tmp/archive.tar.gz"</span>);
<span class="type"><a href="qstring.html">QString</a></span> ext <span class="operator">=</span> fi<span class="operator">.</span>completeSuffix(); <span class="comment">// ext = "tar.gz"</span></pre>
<p><b>See also </b><a href="qfileinfo.html#fileName">fileName</a>(), <a href="qfileinfo.html#suffix">suffix</a>(), <a href="qfileinfo.html#baseName">baseName</a>(), and <a href="qfileinfo.html#completeBaseName">completeBaseName</a>().</p>
<!-- @@@completeSuffix -->
<!-- $$$created[overload1]$$$created -->
<h3 class="fn"><a name="created"></a><span class="type"><a href="qdatetime.html">QDateTime</a></span> QFileInfo::<span class="name">created</span> () const</h3>
<p>Returns the date and time when the file was created.</p>
<p>On most Unix systems, this function returns the time of the last status change. A status change occurs when the file is created, but it also occurs whenever the user writes or sets inode information (for example, changing the file permissions).</p>
<p>If neither creation time nor "last status change" time are not available, returns the same as <a href="qfileinfo.html#lastModified">lastModified</a>().</p>
<p><b>See also </b><a href="qfileinfo.html#lastModified">lastModified</a>() and <a href="qfileinfo.html#lastRead">lastRead</a>().</p>
<!-- @@@created -->
<!-- $$$dir[overload1]$$$dir -->
<h3 class="fn"><a name="dir"></a><span class="type"><a href="qdir.html">QDir</a></span> QFileInfo::<span class="name">dir</span> () const</h3>
<p>Returns the path of the object's parent directory as a <a href="qdir.html">QDir</a> object.</p>
<p><b>Note:</b> The <a href="qdir.html">QDir</a> returned always corresponds to the object's parent directory, even if the <a href="qfileinfo.html">QFileInfo</a> represents a directory.</p>
<p>For each of the following, dir() returns a <a href="qdir.html">QDir</a> for <tt>"~/examples/191697"</tt>.</p>
<pre class="cpp"> <span class="type"><a href="qfileinfo.html">QFileInfo</a></span> fileInfo1(<span class="string">"~/examples/191697/."</span>);
<span class="type"><a href="qfileinfo.html">QFileInfo</a></span> fileInfo2(<span class="string">"~/examples/191697/.."</span>);
<span class="type"><a href="qfileinfo.html">QFileInfo</a></span> fileInfo3(<span class="string">"~/examples/191697/main.cpp"</span>);</pre>
<p>For each of the following, dir() returns a <a href="qdir.html">QDir</a> for <tt>"."</tt>.</p>
<pre class="cpp"> <span class="type"><a href="qfileinfo.html">QFileInfo</a></span> fileInfo4(<span class="string">"."</span>);
<span class="type"><a href="qfileinfo.html">QFileInfo</a></span> fileInfo5(<span class="string">".."</span>);
<span class="type"><a href="qfileinfo.html">QFileInfo</a></span> fileInfo6(<span class="string">"main.cpp"</span>);</pre>
<p><b>See also </b><a href="qfileinfo.html#absolutePath">absolutePath</a>(), <a href="qfileinfo.html#filePath">filePath</a>(), <a href="qfileinfo.html#fileName">fileName</a>(), <a href="qfileinfo.html#isRelative">isRelative</a>(), and <a href="qfileinfo.html#absoluteDir">absoluteDir</a>().</p>
<!-- @@@dir -->
<!-- $$$exists[overload1]$$$exists -->
<h3 class="fn"><a name="exists"></a><span class="type">bool</span> QFileInfo::<span class="name">exists</span> () const</h3>
<p>Returns true if the file exists; otherwise returns false.</p>
<p><b>Note:</b> If the file is a symlink that points to a non existing file, false is returned.</p>
<!-- @@@exists -->
<!-- $$$fileName[overload1]$$$fileName -->
<h3 class="fn"><a name="fileName"></a><span class="type"><a href="qstring.html">QString</a></span> QFileInfo::<span class="name">fileName</span> () const</h3>
<p>Returns the name of the file, excluding the path.</p>
<p>Example:</p>
<pre class="cpp"> <span class="type"><a href="qfileinfo.html">QFileInfo</a></span> fi(<span class="string">"/tmp/archive.tar.gz"</span>);
<span class="type"><a href="qstring.html">QString</a></span> name <span class="operator">=</span> fi<span class="operator">.</span>fileName(); <span class="comment">// name = "archive.tar.gz"</span></pre>
<p>Note that, if this <a href="qfileinfo.html">QFileInfo</a> object is given a path ending in a slash, the name of the file is considered empty.</p>
<p><b>See also </b><a href="qfileinfo.html#isRelative">isRelative</a>(), <a href="qfileinfo.html#filePath">filePath</a>(), <a href="qfileinfo.html#baseName">baseName</a>(), and <a href="qfileinfo-qt3.html#extension" class="compat">extension</a>().</p>
<!-- @@@fileName -->
<!-- $$$filePath[overload1]$$$filePath -->
<h3 class="fn"><a name="filePath"></a><span class="type"><a href="qstring.html">QString</a></span> QFileInfo::<span class="name">filePath</span> () const</h3>
<p>Returns the file name, including the path (which may be absolute or relative).</p>
<p><b>See also </b><a href="qfileinfo.html#absoluteFilePath">absoluteFilePath</a>(), <a href="qfileinfo.html#canonicalFilePath">canonicalFilePath</a>(), and <a href="qfileinfo.html#isRelative">isRelative</a>().</p>
<!-- @@@filePath -->
<!-- $$$group[overload1]$$$group -->
<h3 class="fn"><a name="group"></a><span class="type"><a href="qstring.html">QString</a></span> QFileInfo::<span class="name">group</span> () const</h3>
<p>Returns the group of the file. On Windows, on systems where files do not have groups, or if an error occurs, an empty string is returned.</p>
<p>This function can be time consuming under Unix (in the order of milliseconds).</p>
<p><b>See also </b><a href="qfileinfo.html#groupId">groupId</a>(), <a href="qfileinfo.html#owner">owner</a>(), and <a href="qfileinfo.html#ownerId">ownerId</a>().</p>
<!-- @@@group -->
<!-- $$$groupId[overload1]$$$groupId -->
<h3 class="fn"><a name="groupId"></a><span class="type"><a href="qtglobal.html#uint-typedef">uint</a></span> QFileInfo::<span class="name">groupId</span> () const</h3>
<p>Returns the id of the group the file belongs to.</p>
<p>On Windows and on systems where files do not have groups this function always returns (uint) -2.</p>
<p><b>See also </b><a href="qfileinfo.html#group">group</a>(), <a href="qfileinfo.html#owner">owner</a>(), and <a href="qfileinfo.html#ownerId">ownerId</a>().</p>
<!-- @@@groupId -->
<!-- $$$isAbsolute[overload1]$$$isAbsolute -->
<h3 class="fn"><a name="isAbsolute"></a><span class="type">bool</span> QFileInfo::<span class="name">isAbsolute</span> () const</h3>
<p>Returns true if the file path name is absolute, otherwise returns false if the path is relative.</p>
<p><b>See also </b><a href="qfileinfo.html#isRelative">isRelative</a>().</p>
<!-- @@@isAbsolute -->
<!-- $$$isBundle[overload1]$$$isBundle -->
<h3 class="fn"><a name="isBundle"></a><span class="type">bool</span> QFileInfo::<span class="name">isBundle</span> () const</h3>
<p>Returns true if this object points to a bundle or to a symbolic link to a bundle on Mac OS X; otherwise returns false.</p>
<p>This function was introduced in Qt 4.3.</p>
<p><b>See also </b><a href="qfileinfo.html#isDir">isDir</a>(), <a href="qfileinfo.html#isSymLink">isSymLink</a>(), and <a href="qfileinfo.html#isFile">isFile</a>().</p>
<!-- @@@isBundle -->
<!-- $$$isDir[overload1]$$$isDir -->
<h3 class="fn"><a name="isDir"></a><span class="type">bool</span> QFileInfo::<span class="name">isDir</span> () const</h3>
<p>Returns true if this object points to a directory or to a symbolic link to a directory; otherwise returns false.</p>
<p><b>See also </b><a href="qfileinfo.html#isFile">isFile</a>(), <a href="qfileinfo.html#isSymLink">isSymLink</a>(), and <a href="qfileinfo.html#isBundle">isBundle</a>().</p>
<!-- @@@isDir -->
<!-- $$$isExecutable[overload1]$$$isExecutable -->
<h3 class="fn"><a name="isExecutable"></a><span class="type">bool</span> QFileInfo::<span class="name">isExecutable</span> () const</h3>
<p>Returns true if the file is executable; otherwise returns false.</p>
<p><b>See also </b><a href="qfileinfo.html#isReadable">isReadable</a>(), <a href="qfileinfo.html#isWritable">isWritable</a>(), and <a href="qfileinfo.html#permission">permission</a>().</p>
<!-- @@@isExecutable -->
<!-- $$$isFile[overload1]$$$isFile -->
<h3 class="fn"><a name="isFile"></a><span class="type">bool</span> QFileInfo::<span class="name">isFile</span> () const</h3>
<p>Returns true if this object points to a file or to a symbolic link to a file. Returns false if the object points to something which isn't a file, such as a directory.</p>
<p><b>See also </b><a href="qfileinfo.html#isDir">isDir</a>(), <a href="qfileinfo.html#isSymLink">isSymLink</a>(), and <a href="qfileinfo.html#isBundle">isBundle</a>().</p>
<!-- @@@isFile -->
<!-- $$$isHidden[overload1]$$$isHidden -->
<h3 class="fn"><a name="isHidden"></a><span class="type">bool</span> QFileInfo::<span class="name">isHidden</span> () const</h3>
<p>Returns true if this is a `hidden' file; otherwise returns false.</p>
<p><b>Note:</b> This function returns true for the special entries "." and ".." on Unix, even though QDir::entryList threats them as shown.</p>
<!-- @@@isHidden -->
<!-- $$$isReadable[overload1]$$$isReadable -->
<h3 class="fn"><a name="isReadable"></a><span class="type">bool</span> QFileInfo::<span class="name">isReadable</span> () const</h3>
<p>Returns true if the user can read the file; otherwise returns false.</p>
<p><b>See also </b><a href="qfileinfo.html#isWritable">isWritable</a>(), <a href="qfileinfo.html#isExecutable">isExecutable</a>(), and <a href="qfileinfo.html#permission">permission</a>().</p>
<!-- @@@isReadable -->
<!-- $$$isRelative[overload1]$$$isRelative -->
<h3 class="fn"><a name="isRelative"></a><span class="type">bool</span> QFileInfo::<span class="name">isRelative</span> () const</h3>
<p>Returns true if the file path name is relative, otherwise returns false if the path is absolute (e.g. under Unix a path is absolute if it begins with a "/").</p>
<p><b>See also </b><a href="qfileinfo.html#isAbsolute">isAbsolute</a>().</p>
<!-- @@@isRelative -->
<!-- $$$isRoot[overload1]$$$isRoot -->
<h3 class="fn"><a name="isRoot"></a><span class="type">bool</span> QFileInfo::<span class="name">isRoot</span> () const</h3>
<p>Returns true if the object points to a directory or to a symbolic link to a directory, and that directory is the root directory; otherwise returns false.</p>
<!-- @@@isRoot -->
<!-- $$$isSymLink[overload1]$$$isSymLink -->
<h3 class="fn"><a name="isSymLink"></a><span class="type">bool</span> QFileInfo::<span class="name">isSymLink</span> () const</h3>
<p>Returns true if this object points to a symbolic link (or to a shortcut on Windows); otherwise returns false.</p>
<p>On Unix (including Mac OS X), opening a symlink effectively opens the <a href="qfileinfo.html#symLinkTarget">link's target</a>. On Windows, it opens the <tt>.lnk</tt> file itself.</p>
<p>Example:</p>
<pre class="cpp"> <span class="type"><a href="qfileinfo.html">QFileInfo</a></span> info(fileName);
<span class="keyword">if</span> (info<span class="operator">.</span>isSymLink())
fileName <span class="operator">=</span> info<span class="operator">.</span><a href="qfileinfo.html#symLinkTarget">symLinkTarget</a>();</pre>
<p><b>Note:</b> If the symlink points to a non existing file, <a href="qfileinfo.html#exists">exists</a>() returns false.</p>
<p><b>See also </b><a href="qfileinfo.html#isFile">isFile</a>(), <a href="qfileinfo.html#isDir">isDir</a>(), and <a href="qfileinfo.html#symLinkTarget">symLinkTarget</a>().</p>
<!-- @@@isSymLink -->
<!-- $$$isWritable[overload1]$$$isWritable -->
<h3 class="fn"><a name="isWritable"></a><span class="type">bool</span> QFileInfo::<span class="name">isWritable</span> () const</h3>
<p>Returns true if the user can write to the file; otherwise returns false.</p>
<p><b>See also </b><a href="qfileinfo.html#isReadable">isReadable</a>(), <a href="qfileinfo.html#isExecutable">isExecutable</a>(), and <a href="qfileinfo.html#permission">permission</a>().</p>
<!-- @@@isWritable -->
<!-- $$$lastModified[overload1]$$$lastModified -->
<h3 class="fn"><a name="lastModified"></a><span class="type"><a href="qdatetime.html">QDateTime</a></span> QFileInfo::<span class="name">lastModified</span> () const</h3>
<p>Returns the date and time when the file was last modified.</p>
<p><b>See also </b><a href="qfileinfo.html#created">created</a>() and <a href="qfileinfo.html#lastRead">lastRead</a>().</p>
<!-- @@@lastModified -->
<!-- $$$lastRead[overload1]$$$lastRead -->
<h3 class="fn"><a name="lastRead"></a><span class="type"><a href="qdatetime.html">QDateTime</a></span> QFileInfo::<span class="name">lastRead</span> () const</h3>
<p>Returns the date and time when the file was last read (accessed).</p>
<p>On platforms where this information is not available, returns the same as <a href="qfileinfo.html#lastModified">lastModified</a>().</p>
<p><b>See also </b><a href="qfileinfo.html#created">created</a>() and <a href="qfileinfo.html#lastModified">lastModified</a>().</p>
<!-- @@@lastRead -->
<!-- $$$makeAbsolute[overload1]$$$makeAbsolute -->
<h3 class="fn"><a name="makeAbsolute"></a><span class="type">bool</span> QFileInfo::<span class="name">makeAbsolute</span> ()</h3>
<p>Converts the file's path to an absolute path if it is not already in that form. Returns true to indicate that the path was converted; otherwise returns false to indicate that the path was already absolute.</p>
<p><b>See also </b><a href="qfileinfo.html#filePath">filePath</a>() and <a href="qfileinfo.html#isRelative">isRelative</a>().</p>
<!-- @@@makeAbsolute -->
<!-- $$$owner[overload1]$$$owner -->
<h3 class="fn"><a name="owner"></a><span class="type"><a href="qstring.html">QString</a></span> QFileInfo::<span class="name">owner</span> () const</h3>
<p>Returns the owner of the file. On systems where files do not have owners, or if an error occurs, an empty string is returned.</p>
<p>This function can be time consuming under Unix (in the order of milliseconds).</p>
<p><b>See also </b><a href="qfileinfo.html#ownerId">ownerId</a>(), <a href="qfileinfo.html#group">group</a>(), and <a href="qfileinfo.html#groupId">groupId</a>().</p>
<!-- @@@owner -->
<!-- $$$ownerId[overload1]$$$ownerId -->
<h3 class="fn"><a name="ownerId"></a><span class="type"><a href="qtglobal.html#uint-typedef">uint</a></span> QFileInfo::<span class="name">ownerId</span> () const</h3>
<p>Returns the id of the owner of the file.</p>
<p>On Windows and on systems where files do not have owners this function returns ((uint) -2).</p>
<p><b>See also </b><a href="qfileinfo.html#owner">owner</a>(), <a href="qfileinfo.html#group">group</a>(), and <a href="qfileinfo.html#groupId">groupId</a>().</p>
<!-- @@@ownerId -->
<!-- $$$path[overload1]$$$path -->
<h3 class="fn"><a name="path"></a><span class="type"><a href="qstring.html">QString</a></span> QFileInfo::<span class="name">path</span> () const</h3>
<p>Returns the file's path. This doesn't include the file name.</p>
<p>Note that, if this <a href="qfileinfo.html">QFileInfo</a> object is given a path ending in a slash, the name of the file is considered empty and this function will return the entire path.</p>
<p><b>See also </b><a href="qfileinfo.html#filePath">filePath</a>(), <a href="qfileinfo.html#absolutePath">absolutePath</a>(), <a href="qfileinfo.html#canonicalPath">canonicalPath</a>(), <a href="qfileinfo.html#dir">dir</a>(), <a href="qfileinfo.html#fileName">fileName</a>(), and <a href="qfileinfo.html#isRelative">isRelative</a>().</p>
<!-- @@@path -->
<!-- $$$permission[overload1]$$$permissionQFile::Permissions -->
<h3 class="fn"><a name="permission"></a><span class="type">bool</span> QFileInfo::<span class="name">permission</span> ( <span class="type"><a href="qfile.html#Permission-enum">QFile::Permissions</a></span> <i>permissions</i> ) const</h3>
<p>Tests for file permissions. The <i>permissions</i> argument can be several flags of type <a href="qfile.html#Permission-enum">QFile::Permissions</a> OR-ed together to check for permission combinations.</p>
<p>On systems where files do not have permissions this function always returns true.</p>
<p>Example:</p>
<pre class="cpp"> <span class="type"><a href="qfileinfo.html">QFileInfo</a></span> fi(<span class="string">"/tmp/archive.tar.gz"</span>);
<span class="keyword">if</span> (fi<span class="operator">.</span>permission(<span class="type"><a href="qfile.html">QFile</a></span><span class="operator">::</span>WriteUser <span class="operator">|</span> <span class="type"><a href="qfile.html">QFile</a></span><span class="operator">::</span>ReadGroup))
<a href="qtglobal.html#qWarning">qWarning</a>(<span class="string">"I can change the file; my group can read the file"</span>);
<span class="keyword">if</span> (fi<span class="operator">.</span>permission(<span class="type"><a href="qfile.html">QFile</a></span><span class="operator">::</span>WriteGroup <span class="operator">|</span> <span class="type"><a href="qfile.html">QFile</a></span><span class="operator">::</span>WriteOther))
<a href="qtglobal.html#qWarning">qWarning</a>(<span class="string">"The group or others can change the file"</span>);</pre>
<p><b>See also </b><a href="qfileinfo.html#isReadable">isReadable</a>(), <a href="qfileinfo.html#isWritable">isWritable</a>(), and <a href="qfileinfo.html#isExecutable">isExecutable</a>().</p>
<!-- @@@permission -->
<!-- $$$permissions[overload1]$$$permissions -->
<h3 class="fn"><a name="permissions"></a><span class="type"><a href="qfile.html#Permission-enum">QFile::Permissions</a></span> QFileInfo::<span class="name">permissions</span> () const</h3>
<p>Returns the complete OR-ed together combination of <a href="qfile.html#Permission-enum">QFile::Permissions</a> for the file.</p>
<!-- @@@permissions -->
<!-- $$$refresh[overload1]$$$refresh -->
<h3 class="fn"><a name="refresh"></a><span class="type">void</span> QFileInfo::<span class="name">refresh</span> ()</h3>
<p>Refreshes the information about the file, i.e. reads in information from the file system the next time a cached property is fetched.</p>
<p><b>Note:</b> On Windows CE, there might be a delay for the file system driver to detect changes on the file.</p>
<!-- @@@refresh -->
<!-- $$$setCaching[overload1]$$$setCachingbool -->
<h3 class="fn"><a name="setCaching"></a><span class="type">void</span> QFileInfo::<span class="name">setCaching</span> ( <span class="type">bool</span> <i>enable</i> )</h3>
<p>If <i>enable</i> is true, enables caching of file information. If <i>enable</i> is false caching is disabled.</p>
<p>When caching is enabled, <a href="qfileinfo.html">QFileInfo</a> reads the file information from the file system the first time it's needed, but generally not later.</p>
<p>Caching is enabled by default.</p>
<p><b>See also </b><a href="qfileinfo.html#refresh">refresh</a>() and <a href="qfileinfo.html#caching">caching</a>().</p>
<!-- @@@setCaching -->
<!-- $$$setFile[overload1]$$$setFileconstQString& -->
<h3 class="fn"><a name="setFile"></a><span class="type">void</span> QFileInfo::<span class="name">setFile</span> ( const <span class="type"><a href="qstring.html">QString</a></span> & <i>file</i> )</h3>
<p>Sets the file that the <a href="qfileinfo.html">QFileInfo</a> provides information about to <i>file</i>.</p>
<p>The <i>file</i> can also include an absolute or relative file path. Absolute paths begin with the directory separator (e.g. "/" under Unix) or 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.</p>
<p>Example:</p>
<pre class="cpp"> <span class="type"><a href="qstring.html">QString</a></span> absolute <span class="operator">=</span> <span class="string">"/local/bin"</span>;
<span class="type"><a href="qstring.html">QString</a></span> relative <span class="operator">=</span> <span class="string">"local/bin"</span>;
<span class="type"><a href="qfileinfo.html">QFileInfo</a></span> absFile(absolute);
<span class="type"><a href="qfileinfo.html">QFileInfo</a></span> relFile(relative);
<span class="type"><a href="qdir.html">QDir</a></span><span class="operator">::</span>setCurrent(<span class="type"><a href="qdir.html">QDir</a></span><span class="operator">::</span>rootPath());
<span class="comment">// absFile and relFile now point to the same file</span>
<span class="type"><a href="qdir.html">QDir</a></span><span class="operator">::</span>setCurrent(<span class="string">"/tmp"</span>);
<span class="comment">// absFile now points to "/local/bin",</span>
<span class="comment">// while relFile points to "/tmp/local/bin"</span></pre>
<p><b>See also </b><a href="qfileinfo.html#isFile">isFile</a>(), <a href="qfileinfo.html#isRelative">isRelative</a>(), <a href="qdir.html#setCurrent">QDir::setCurrent</a>(), and <a href="qdir.html#isRelativePath">QDir::isRelativePath</a>().</p>
<!-- @@@setFile -->
<!-- $$$setFile$$$setFileconstQFile& -->
<h3 class="fn"><a name="setFile-2"></a><span class="type">void</span> QFileInfo::<span class="name">setFile</span> ( const <span class="type"><a href="qfile.html">QFile</a></span> & <i>file</i> )</h3>
<p>This is an overloaded function.</p>
<p>Sets the file that the <a href="qfileinfo.html">QFileInfo</a> provides information about to <i>file</i>.</p>
<p>If <i>file</i> includes a relative path, the <a href="qfileinfo.html">QFileInfo</a> will also have a relative path.</p>
<p><b>See also </b><a href="qfileinfo.html#isRelative">isRelative</a>().</p>
<!-- @@@setFile -->
<!-- $$$setFile$$$setFileconstQDir&constQString& -->
<h3 class="fn"><a name="setFile-3"></a><span class="type">void</span> QFileInfo::<span class="name">setFile</span> ( const <span class="type"><a href="qdir.html">QDir</a></span> & <i>dir</i>, const <span class="type"><a href="qstring.html">QString</a></span> & <i>file</i> )</h3>
<p>This is an overloaded function.</p>
<p>Sets the file that the <a href="qfileinfo.html">QFileInfo</a> provides information about to <i>file</i> in directory <i>dir</i>.</p>
<p>If <i>file</i> includes a relative path, the <a href="qfileinfo.html">QFileInfo</a> will also have a relative path.</p>
<p><b>See also </b><a href="qfileinfo.html#isRelative">isRelative</a>().</p>
<!-- @@@setFile -->
<!-- $$$size[overload1]$$$size -->
<h3 class="fn"><a name="size"></a><span class="type"><a href="qtglobal.html#qint64-typedef">qint64</a></span> QFileInfo::<span class="name">size</span> () const</h3>
<p>Returns the file size in bytes. If the file does not exist or cannot be fetched, 0 is returned.</p>
<p><b>See also </b><a href="qfileinfo.html#exists">exists</a>().</p>
<!-- @@@size -->
<!-- $$$suffix[overload1]$$$suffix -->
<h3 class="fn"><a name="suffix"></a><span class="type"><a href="qstring.html">QString</a></span> QFileInfo::<span class="name">suffix</span> () const</h3>
<p>Returns the suffix of the file.</p>
<p>The suffix consists of all characters in the file after (but not including) the last '.'.</p>
<p>Example:</p>
<pre class="cpp"> <span class="type"><a href="qfileinfo.html">QFileInfo</a></span> fi(<span class="string">"/tmp/archive.tar.gz"</span>);
<span class="type"><a href="qstring.html">QString</a></span> ext <span class="operator">=</span> fi<span class="operator">.</span>suffix(); <span class="comment">// ext = "gz"</span></pre>
<p>The suffix of a file is computed equally on all platforms, independent of file naming conventions (e.g., ".bashrc" on Unix has an empty base name, and the suffix is "bashrc").</p>
<p><b>See also </b><a href="qfileinfo.html#fileName">fileName</a>(), <a href="qfileinfo.html#completeSuffix">completeSuffix</a>(), <a href="qfileinfo.html#baseName">baseName</a>(), and <a href="qfileinfo.html#completeBaseName">completeBaseName</a>().</p>
<!-- @@@suffix -->
<!-- $$$symLinkTarget[overload1]$$$symLinkTarget -->
<h3 class="fn"><a name="symLinkTarget"></a><span class="type"><a href="qstring.html">QString</a></span> QFileInfo::<span class="name">symLinkTarget</span> () const</h3>
<p>Returns the absolute path to the file or directory a symlink (or shortcut on Windows) points to, or a an empty string if the object isn't a symbolic link.</p>
<p>This name may not represent an existing file; it is only a string. <a href="qfileinfo.html#exists">QFileInfo::exists</a>() returns true if the symlink points to an existing file.</p>
<p>This function was introduced in Qt 4.2.</p>
<p><b>See also </b><a href="qfileinfo.html#exists">exists</a>(), <a href="qfileinfo.html#isSymLink">isSymLink</a>(), <a href="qfileinfo.html#isDir">isDir</a>(), and <a href="qfileinfo.html#isFile">isFile</a>().</p>
<!-- @@@symLinkTarget -->
<!-- $$$operator!=[overload1]$$$operator!=constQFileInfo& -->
<h3 class="fn"><a name="operator-not-eq"></a><span class="type">bool</span> QFileInfo::<span class="name">operator!=</span> ( const <span class="type">QFileInfo</span> & <i>fileinfo</i> )</h3>
<p>Returns true if this <a href="qfileinfo.html">QFileInfo</a> object refers to a different file than the one specified by <i>fileinfo</i>; otherwise returns false.</p>
<p><b>See also </b><a href="qfileinfo.html#operator-eq-eq">operator==</a>().</p>
<!-- @@@operator!= -->
<!-- $$$operator!=$$$operator!=constQFileInfo& -->
<h3 class="fn"><a name="operator-not-eq-2"></a><span class="type">bool</span> QFileInfo::<span class="name">operator!=</span> ( const <span class="type">QFileInfo</span> & <i>fileinfo</i> ) const</h3>
<p>This is an overloaded function.</p>
<!-- @@@operator!= -->
<!-- $$$operator=[overload1]$$$operator=constQFileInfo& -->
<h3 class="fn"><a name="operator-eq"></a><span class="type">QFileInfo</span> & QFileInfo::<span class="name">operator=</span> ( const <span class="type">QFileInfo</span> & <i>fileinfo</i> )</h3>
<p>Makes a copy of the given <i>fileinfo</i> and assigns it to this <a href="qfileinfo.html">QFileInfo</a>.</p>
<!-- @@@operator= -->
<!-- $$$operator==[overload1]$$$operator==constQFileInfo& -->
<h3 class="fn"><a name="operator-eq-eq"></a><span class="type">bool</span> QFileInfo::<span class="name">operator==</span> ( const <span class="type">QFileInfo</span> & <i>fileinfo</i> )</h3>
<p>Returns true if this <a href="qfileinfo.html">QFileInfo</a> object refers to a file in the same location as <i>fileinfo</i>; otherwise returns false.</p>
<p>Note that the result of comparing two empty <a href="qfileinfo.html">QFileInfo</a> objects, containing no file references, is undefined.</p>
<p><b>Warning:</b> This will not compare two different symbolic links pointing to the same file.</p>
<p><b>Warning:</b> Long and short file names that refer to the same file on Windows are treated as if they referred to different files.</p>
<p><b>See also </b><a href="qfileinfo.html#operator-not-eq">operator!=</a>().</p>
<!-- @@@operator== -->
<!-- $$$operator==$$$operator==constQFileInfo& -->
<h3 class="fn"><a name="operator-eq-eq-2"></a><span class="type">bool</span> QFileInfo::<span class="name">operator==</span> ( const <span class="type">QFileInfo</span> & <i>fileinfo</i> ) const</h3>
<p>This is an overloaded function.</p>
<!-- @@@operator== -->
</div>
<div class="relnonmem">
<h2>Related Non-Members</h2>
<!-- $$$QFileInfoList -->
<h3 class="fn"><a name="QFileInfoList-typedef"></a>typedef <span class="name">QFileInfoList</span></h3>
<p>Synonym for <a href="qlist.html">QList</a><<a href="qfileinfo.html">QFileInfo</a>>.</p>
<!-- @@@QFileInfoList -->
</div>
</div>
</div>
</div>
<div class="ft">
<span></span>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2015 The Qt Company Ltd.
Documentation contributions included herein are the copyrights of
their respective owners.</p>
<br />
<p>
The documentation provided herein is licensed under the terms of the
<a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation
License version 1.3</a> as published by the Free Software Foundation.</p>
<p>
Documentation sources may be obtained from <a href="http://www.qt-project.org">
www.qt-project.org</a>.</p>
<br />
<p>
Qt and respective logos are trademarks of The Qt Company Ltd
in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. <a title="Privacy Policy"
href="http://en.gitorious.org/privacy_policy/">Privacy Policy</a></p>
</div>
<script src="scripts/functions.js" type="text/javascript"></script>
</body>
</html>
