<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <!--NewPage--> <HTML> <HEAD> <!-- Generated by javadoc (build 1.5.0_09) on Tue Aug 07 16:57:38 CEST 2007 --> <TITLE> QFileInfo </TITLE> <META NAME="keywords" CONTENT="com.trolltech.qt.core.QFileInfo class"> <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../../stylesheet.css" TITLE="Style"> <SCRIPT type="text/javascript"> function windowTitle() { parent.document.title="QFileInfo"; } </SCRIPT> <NOSCRIPT> </NOSCRIPT> </HEAD> <BODY BGCOLOR="white" onload="windowTitle();"> <!-- ========= START OF TOP NAVBAR ======= --> <A NAME="navbar_top"><!-- --></A> <A HREF="#skip-navbar_top" title="Skip navigation links"></A> <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""> <TR> <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A NAME="navbar_top_firstrow"><!-- --></A> <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> <TR ALIGN="center" VALIGN="top"> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> </TR> </TABLE> </TD> <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> </EM> </TD> </TR> <TR> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../../com/trolltech/qt/core/QFile.Permissions.html" title="class in com.trolltech.qt.core"><B>PREV CLASS</B></A> <A HREF="../../../../com/trolltech/qt/core/QFileSystemWatcher.html" title="class in com.trolltech.qt.core"><B>NEXT CLASS</B></A></FONT></TD> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../../index.html?com/trolltech/qt/core/QFileInfo.html" target="_top"><B>FRAMES</B></A> <A HREF="QFileInfo.html" target="_top"><B>NO FRAMES</B></A> <SCRIPT type="text/javascript"> <!-- if(window==top) { document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>'); } //--> </SCRIPT> <NOSCRIPT> <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A> </NOSCRIPT> </FONT></TD> </TR> <TR> <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> SUMMARY: <A HREF="#nested_classes_inherited_from_class_com.trolltech.qt.QSignalEmitter">NESTED</A> | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD> <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD> </TR> </TABLE> <A NAME="skip-navbar_top"></A> <!-- ========= END OF TOP NAVBAR ========= --> <HR> <!-- ======== START OF CLASS DATA ======== --> <H2> <FONT SIZE="-1"> com.trolltech.qt.core</FONT> <BR> Class QFileInfo</H2> <PRE> java.lang.Object <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A HREF="../../../../com/trolltech/qt/QSignalEmitter.html" title="class in com.trolltech.qt">com.trolltech.qt.QSignalEmitter</A> <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><A HREF="../../../../com/trolltech/qt/QtJambiObject.html" title="class in com.trolltech.qt">com.trolltech.qt.QtJambiObject</A> <IMG SRC="../../../../resources/inherit.gif" ALT="extended by "><B>com.trolltech.qt.core.QFileInfo</B> </PRE> <DL> <DT><B>All Implemented Interfaces:</B> <DD><A HREF="../../../../com/trolltech/qt/QtJambiInterface.html" title="interface in com.trolltech.qt">QtJambiInterface</A></DD> </DL> <HR> <DL> <DT><PRE>public class <B>QFileInfo</B><DT>extends <A HREF="../../../../com/trolltech/qt/QtJambiObject.html" title="class in com.trolltech.qt">QtJambiObject</A></DL> </PRE> <P> <p>The <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> class provides system-independent file information.</p> <p><a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> 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. <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> can also be used to obtain information about a Qt <a href="%2E%2E/resources.html#resource-system">resource</tt></a>.</p> <p>A <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> 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()"><tt>isRelative</tt></a> to check whether a <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> is using a relative or an absolute file path. You can call the function <a href="QFileInfo.html#makeAbsolute()"><tt>makeAbsolute</tt></a> to convert a relative <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a>'s path to an absolute path.</p> <p>The file that the <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> works on is set in the constructor or later with <a href="QFileInfo.html#setFile(com.trolltech.qt.core.QFile)"><tt>setFile</tt></a>. Use <a href="QFileInfo.html#exists()"><tt>exists</tt></a> to see if the file exists and <a href="QFileInfo.html#size()"><tt>size</tt></a> to get its size.</p> <p>Some of <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a>'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()"><tt>absolutePath</tt></a> has to query the file system. The <a href="QFileInfo.html#path()"><tt>path</tt></a> function, however, can work on the file name directly, and so it is faster. By convention, <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> interprets any path that ends with a slash '/' as a directory (e.g., "C:/WINDOWS/"), and those without a trailing slash (e.g., "C:/WINDOWS/hosts.txt") are treated as files.</p> <p>To speed up performance, <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> 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()"><tt>refresh</tt></a>. If you want to switch off a <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a>'s caching and force it to access the file system every time you request information from it call <a href="QFileInfo.html#setCaching(boolean)"><tt>setCaching</tt></a>(false).</p> <p>The file's type is obtained with <a href="QFileInfo.html#isFile()"><tt>isFile</tt></a>, <a href="QFileInfo.html#isDir()"><tt>isDir</tt></a> and <a href="QFileInfo.html#isSymLink()"><tt>isSymLink</tt></a>. The <a href="QFileInfo.html#symLinkTarget()"><tt>symLinkTarget</tt></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()"><tt>size</tt></a> has the file it points to, because Unix handles symlinks transparently; similarly, opening a symlink using <a href="QFile.html"><tt>QFile</tt></a> effectively opens the link's target. For example:</p> <pre> #ifdef Q_OS_UNIX QFileInfo info1("/home/bob/bin/untabify"); info1.isSymLink(); <span class="comment">// returns true</span> info1.absoluteFilePath(); <span class="comment">// returns "/home/bob/bin/untabify"</span> info1.size(); <span class="comment">// returns 56201</span> info1.symLinkTarget(); <span class="comment">// returns "/opt/pretty++/bin/untabify"</span> QFileInfo info2(info1.symLinkTarget()); info1.isSymLink(); <span class="comment">// returns false</span> info1.absoluteFilePath(); <span class="comment">// returns "/opt/pretty++/bin/untabify"</span> info1.size(); <span class="comment">// returns 56201</span> #endif</pre> <p>On Windows, symlinks (shortcuts) are <tt>.lnk</tt> files. The reported <a href="QFileInfo.html#size()"><tt>size</tt></a> is that of the symlink (not the link's target), and opening a symlink using <a href="QFile.html"><tt>QFile</tt></a> opens the <tt>.lnk</tt> file. For example:</p> <pre> #ifdef Q_OS_WIN QFileInfo info1("C:\\Documents and Settings\\Bob\\untabify.lnk"); info1.isSymLink(); <span class="comment">// returns true</span> info1.absoluteFilePath(); <span class="comment">// returns "C:/Documents and Settings/Bob/untabify.lnk"</span> info1.size(); <span class="comment">// returns 743</span> info1.symLinkTarget(); <span class="comment">// returns "C:/Pretty++/untabify"</span> QFileInfo info2(info1.symLinkTarget()); info1.isSymLink(); <span class="comment">// returns false</span> info1.absoluteFilePath(); <span class="comment">// returns "C:/Pretty++/untabify"</span> info1.size(); <span class="comment">// returns 63942</span> #endif</pre> <p>Elements of the file's name can be extracted with <a href="QFileInfo.html#path()"><tt>path</tt></a> and <a href="QFileInfo.html#fileName()"><tt>fileName</tt></a>. The <a href="QFileInfo.html#fileName()"><tt>fileName</tt></a>'s parts can be extracted with <a href="QFileInfo.html#baseName()"><tt>baseName</tt></a> and extension().</p> <p>The file's dates are returned by <a href="QFileInfo.html#created()"><tt>created</tt></a>, <a href="QFileInfo.html#lastModified()"><tt>lastModified</tt></a> and <a href="QFileInfo.html#lastRead()"><tt>lastRead</tt></a>. Information about the file's access permissions is obtained with <a href="QFileInfo.html#isReadable()"><tt>isReadable</tt></a>, <a href="QFileInfo.html#isWritable()"><tt>isWritable</tt></a> and <a href="QFileInfo.html#isExecutable()"><tt>isExecutable</tt></a>. The file's ownership is available from <a href="QFileInfo.html#owner()"><tt>owner</tt></a>, <a href="QFileInfo.html#ownerId()"><tt>ownerId</tt></a>, <a href="QFileInfo.html#group()"><tt>group</tt></a> and <a href="QFileInfo.html#groupId()"><tt>groupId</tt></a>. You can examine a file's permissions and ownership in a single statement using the <a href="QFileInfo.html#permission(com.trolltech.qt.core.QFile.Permissions)"><tt>permission</tt></a> function.</p> <P> <P> <DL> <DT><B>See Also:</B><DD><a href="QDir.html"><tt>QDir</tt></a>, <a href="QFile.html"><tt>QFile</tt></a></DL> <HR> <P> <!-- ======== NESTED CLASS SUMMARY ======== --> <A NAME="nested_class_summary"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> <B>Nested Class Summary</B></FONT></TH> </TR> </TABLE> <A NAME="nested_classes_inherited_from_class_com.trolltech.qt.QSignalEmitter"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> <TH ALIGN="left"><B>Nested classes/interfaces inherited from class com.trolltech.qt.<A HREF="../../../../com/trolltech/qt/QSignalEmitter.html" title="class in com.trolltech.qt">QSignalEmitter</A></B></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal0.html" title="class in com.trolltech.qt">QSignalEmitter.Signal0</A>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal1.html" title="class in com.trolltech.qt">QSignalEmitter.Signal1</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal1.html" title="type parameter in QSignalEmitter.Signal1">A</A>>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal2.html" title="class in com.trolltech.qt">QSignalEmitter.Signal2</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal2.html" title="type parameter in QSignalEmitter.Signal2">A</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal2.html" title="type parameter in QSignalEmitter.Signal2">B</A>>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal3.html" title="class in com.trolltech.qt">QSignalEmitter.Signal3</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal3.html" title="type parameter in QSignalEmitter.Signal3">A</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal3.html" title="type parameter in QSignalEmitter.Signal3">B</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal3.html" title="type parameter in QSignalEmitter.Signal3">C</A>>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal4.html" title="class in com.trolltech.qt">QSignalEmitter.Signal4</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal4.html" title="type parameter in QSignalEmitter.Signal4">A</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal4.html" title="type parameter in QSignalEmitter.Signal4">B</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal4.html" title="type parameter in QSignalEmitter.Signal4">C</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal4.html" title="type parameter in QSignalEmitter.Signal4">D</A>>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal5.html" title="class in com.trolltech.qt">QSignalEmitter.Signal5</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal5.html" title="type parameter in QSignalEmitter.Signal5">A</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal5.html" title="type parameter in QSignalEmitter.Signal5">B</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal5.html" title="type parameter in QSignalEmitter.Signal5">C</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal5.html" title="type parameter in QSignalEmitter.Signal5">D</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal5.html" title="type parameter in QSignalEmitter.Signal5">E</A>>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal6.html" title="class in com.trolltech.qt">QSignalEmitter.Signal6</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal6.html" title="type parameter in QSignalEmitter.Signal6">A</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal6.html" title="type parameter in QSignalEmitter.Signal6">B</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal6.html" title="type parameter in QSignalEmitter.Signal6">C</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal6.html" title="type parameter in QSignalEmitter.Signal6">D</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal6.html" title="type parameter in QSignalEmitter.Signal6">E</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal6.html" title="type parameter in QSignalEmitter.Signal6">F</A>>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal7.html" title="class in com.trolltech.qt">QSignalEmitter.Signal7</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal7.html" title="type parameter in QSignalEmitter.Signal7">A</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal7.html" title="type parameter in QSignalEmitter.Signal7">B</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal7.html" title="type parameter in QSignalEmitter.Signal7">C</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal7.html" title="type parameter in QSignalEmitter.Signal7">D</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal7.html" title="type parameter in QSignalEmitter.Signal7">E</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal7.html" title="type parameter in QSignalEmitter.Signal7">F</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal7.html" title="type parameter in QSignalEmitter.Signal7">G</A>>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="class in com.trolltech.qt">QSignalEmitter.Signal8</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="type parameter in QSignalEmitter.Signal8">A</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="type parameter in QSignalEmitter.Signal8">B</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="type parameter in QSignalEmitter.Signal8">C</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="type parameter in QSignalEmitter.Signal8">D</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="type parameter in QSignalEmitter.Signal8">E</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="type parameter in QSignalEmitter.Signal8">F</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="type parameter in QSignalEmitter.Signal8">G</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal8.html" title="type parameter in QSignalEmitter.Signal8">H</A>>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="class in com.trolltech.qt">QSignalEmitter.Signal9</A><<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">A</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">B</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">C</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">D</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">E</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">F</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">G</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">H</A>,<A HREF="../../../../com/trolltech/qt/QSignalEmitter.Signal9.html" title="type parameter in QSignalEmitter.Signal9">I</A>></CODE></TD> </TR> </TABLE> <!-- ======== CONSTRUCTOR SUMMARY ======== --> <A NAME="constructor_summary"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> <B>Constructor Summary</B></FONT></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#QFileInfo()">QFileInfo</A></B>()</CODE> <BR> Constructs an empty <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> object.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#QFileInfo(com.trolltech.qt.core.QDir, java.lang.String)">QFileInfo</A></B>(<A HREF="../../../../com/trolltech/qt/core/QDir.html" title="class in com.trolltech.qt.core">QDir</A> dir, java.lang.String file)</CODE> <BR> Constructs a new <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> that gives information about the given <tt>file</tt> in the directory <tt>dir</tt>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#QFileInfo(com.trolltech.qt.core.QFile)">QFileInfo</A></B>(<A HREF="../../../../com/trolltech/qt/core/QFile.html" title="class in com.trolltech.qt.core">QFile</A> file)</CODE> <BR> Constructs a new <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> that gives information about file <tt>file</tt>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#QFileInfo(com.trolltech.qt.core.QFileInfo)">QFileInfo</A></B>(<A HREF="../../../../com/trolltech/qt/core/QFileInfo.html" title="class in com.trolltech.qt.core">QFileInfo</A> fileinfo)</CODE> <BR> Constructs a new <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> that is a copy of the given <tt>fileinfo</tt>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#QFileInfo(java.lang.String)">QFileInfo</A></B>(java.lang.String file)</CODE> <BR> Constructs a new <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> that gives information about the given file.</TD> </TR> </TABLE> <!-- ========== METHOD SUMMARY =========== --> <A NAME="method_summary"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"> <B>Method Summary</B></FONT></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../../com/trolltech/qt/core/QDir.html" title="class in com.trolltech.qt.core">QDir</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#absoluteDir()">absoluteDir</A></B>()</CODE> <BR> Returns the file's absolute path as a <a href="QDir.html"><tt>QDir</tt></a> object.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.lang.String</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#absoluteFilePath()">absoluteFilePath</A></B>()</CODE> <BR> Returns the absolute path including the file name.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.lang.String</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#absolutePath()">absolutePath</A></B>()</CODE> <BR> Returns the file's path absolute path.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.lang.String</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#baseName()">baseName</A></B>()</CODE> <BR> Returns the base name of the file without the path.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.lang.String</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#bundleName()">bundleName</A></B>()</CODE> <BR> Returns the name of the bundle.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#caching()">caching</A></B>()</CODE> <BR> Returns true if caching is enabled; otherwise returns false.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.lang.String</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#canonicalFilePath()">canonicalFilePath</A></B>()</CODE> <BR> Returns the canonical path, i.e. a path without symbolic links or redundant "." or ".." elements.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.lang.String</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#canonicalPath()">canonicalPath</A></B>()</CODE> <BR> Returns the canonical path, i.e. a path without symbolic links or redundant "." or ".." elements.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.lang.String</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#completeBaseName()">completeBaseName</A></B>()</CODE> <BR> Returns the complete base name of the file without the path.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.lang.String</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#completeSuffix()">completeSuffix</A></B>()</CODE> <BR> Returns the complete suffix of the file.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../../com/trolltech/qt/core/QDateTime.html" title="class in com.trolltech.qt.core">QDateTime</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#created()">created</A></B>()</CODE> <BR> Returns the date and time when the file was created.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../../com/trolltech/qt/core/QDir.html" title="class in com.trolltech.qt.core">QDir</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#dir()">dir</A></B>()</CODE> <BR> Returns the path of the object's parent directory as a <a href="QDir.html"><tt>QDir</tt></a> object.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#equals(java.lang.Object)">equals</A></B>(java.lang.Object other)</CODE> <BR> </TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#exists()">exists</A></B>()</CODE> <BR> Returns true if the file exists; otherwise returns false.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.lang.String</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#fileName()">fileName</A></B>()</CODE> <BR> Returns the name of the file, excluding the path.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.lang.String</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#filePath()">filePath</A></B>()</CODE> <BR> Returns the file name, including the path (which may be absolute or relative).</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE>static <A HREF="../../../../com/trolltech/qt/core/QFileInfo.html" title="class in com.trolltech.qt.core">QFileInfo</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#fromNativePointer(com.trolltech.qt.QNativePointer)">fromNativePointer</A></B>(<A HREF="../../../../com/trolltech/qt/QNativePointer.html" title="class in com.trolltech.qt">QNativePointer</A> nativePointer)</CODE> <BR> This function returns the QFileInfo instance pointed to by nativePointer</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.lang.String</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#group()">group</A></B>()</CODE> <BR> Returns the group of the file.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#groupId()">groupId</A></B>()</CODE> <BR> Returns the id of the group the file belongs to.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#isAbsolute()">isAbsolute</A></B>()</CODE> <BR> Returns true if the file path name is absolute, otherwise returns false if the path is relative.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#isBundle()">isBundle</A></B>()</CODE> <BR> Returns true if this object points to a bundle or to a symbolic link to a bundle on Mac OS X; otherwise returns false.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#isDir()">isDir</A></B>()</CODE> <BR> Returns true if this object points to a directory or to a symbolic link to a directory; otherwise returns false.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#isExecutable()">isExecutable</A></B>()</CODE> <BR> Returns true if the file is executable; otherwise returns false.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#isFile()">isFile</A></B>()</CODE> <BR> Returns true if this object points to a file or to a symbolic link to a file.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#isHidden()">isHidden</A></B>()</CODE> <BR> Returns true if this is a `hidden' file; otherwise returns false.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#isReadable()">isReadable</A></B>()</CODE> <BR> Returns true if the user can read the file; otherwise returns false.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#isRelative()">isRelative</A></B>()</CODE> <BR> 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 "/").</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#isRoot()">isRoot</A></B>()</CODE> <BR> 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.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#isSymLink()">isSymLink</A></B>()</CODE> <BR> Returns true if this object points to a symbolic link (or to a shortcut on Windows); otherwise returns false.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#isWritable()">isWritable</A></B>()</CODE> <BR> Returns true if the user can write to the file; otherwise returns false.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../../com/trolltech/qt/core/QDateTime.html" title="class in com.trolltech.qt.core">QDateTime</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#lastModified()">lastModified</A></B>()</CODE> <BR> Returns the date and time when the file was last modified.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../../com/trolltech/qt/core/QDateTime.html" title="class in com.trolltech.qt.core">QDateTime</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#lastRead()">lastRead</A></B>()</CODE> <BR> Returns the date and time when the file was last read (accessed).</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#makeAbsolute()">makeAbsolute</A></B>()</CODE> <BR> Converts the file's path to an absolute path if it is not already in that form.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE>static <A HREF="../../../../com/trolltech/qt/QNativePointer.html" title="class in com.trolltech.qt">QNativePointer</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#nativePointerArray(com.trolltech.qt.core.QFileInfo[])">nativePointerArray</A></B>(<A HREF="../../../../com/trolltech/qt/core/QFileInfo.html" title="class in com.trolltech.qt.core">QFileInfo</A>[] array)</CODE> <BR> This function returns a QNativePointer that is pointing to the specified QFileInfo array.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.lang.String</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#owner()">owner</A></B>()</CODE> <BR> Returns the owner of the file.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#ownerId()">ownerId</A></B>()</CODE> <BR> Returns the id of the owner of the file.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.lang.String</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#path()">path</A></B>()</CODE> <BR> Returns the file's path.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#permission(com.trolltech.qt.core.QFile.Permission...)">permission</A></B>(<A HREF="../../../../com/trolltech/qt/core/QFile.Permission.html" title="enum in com.trolltech.qt.core">QFile.Permission</A>... permissions)</CODE> <BR> Tests for file permissions.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#permission(com.trolltech.qt.core.QFile.Permissions)">permission</A></B>(<A HREF="../../../../com/trolltech/qt/core/QFile.Permissions.html" title="class in com.trolltech.qt.core">QFile.Permissions</A> permissions)</CODE> <BR> Tests for file permissions.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="../../../../com/trolltech/qt/core/QFile.Permissions.html" title="class in com.trolltech.qt.core">QFile.Permissions</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#permissions()">permissions</A></B>()</CODE> <BR> Returns the complete OR-ed together combination of QFile::Permissions for the file.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#refresh()">refresh</A></B>()</CODE> <BR> Refreshes the information about the file, i.e. reads in information from the file system the next time a cached property is fetched.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#setCaching(boolean)">setCaching</A></B>(boolean on)</CODE> <BR> If <tt>on</tt> is true, enables caching of file information.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#setFile(com.trolltech.qt.core.QDir, java.lang.String)">setFile</A></B>(<A HREF="../../../../com/trolltech/qt/core/QDir.html" title="class in com.trolltech.qt.core">QDir</A> dir, java.lang.String file)</CODE> <BR> Sets the file that the <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> provides information about to <tt>file</tt> in directory <tt>dir</tt>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#setFile(com.trolltech.qt.core.QFile)">setFile</A></B>(<A HREF="../../../../com/trolltech/qt/core/QFile.html" title="class in com.trolltech.qt.core">QFile</A> file)</CODE> <BR> Sets the file that the <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> provides information about to <tt>file</tt>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#setFile(java.lang.String)">setFile</A></B>(java.lang.String file)</CODE> <BR> Sets the file that the <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> provides information about to <tt>file</tt>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> long</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#size()">size</A></B>()</CODE> <BR> Returns the file size in bytes.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.lang.String</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#suffix()">suffix</A></B>()</CODE> <BR> Returns the suffix of the file.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> java.lang.String</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../../com/trolltech/qt/core/QFileInfo.html#symLinkTarget()">symLinkTarget</A></B>()</CODE> <BR> 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.</TD> </TR> </TABLE> <A NAME="methods_inherited_from_class_com.trolltech.qt.QtJambiObject"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> <TH ALIGN="left"><B>Methods inherited from class com.trolltech.qt.<A HREF="../../../../com/trolltech/qt/QtJambiObject.html" title="class in com.trolltech.qt">QtJambiObject</A></B></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><A HREF="../../../../com/trolltech/qt/QtJambiObject.html#dispose()">dispose</A>, <A HREF="../../../../com/trolltech/qt/QtJambiObject.html#disposed()">disposed</A>, <A HREF="../../../../com/trolltech/qt/QtJambiObject.html#finalize()">finalize</A>, <A HREF="../../../../com/trolltech/qt/QtJambiObject.html#reassignNativeResources(com.trolltech.qt.QtJambiObject, java.lang.Class)">reassignNativeResources</A>, <A HREF="../../../../com/trolltech/qt/QtJambiObject.html#tr(java.lang.String)">tr</A>, <A HREF="../../../../com/trolltech/qt/QtJambiObject.html#tr(java.lang.String, java.lang.String)">tr</A>, <A HREF="../../../../com/trolltech/qt/QtJambiObject.html#tr(java.lang.String, java.lang.String, int)">tr</A></CODE></TD> </TR> </TABLE> <A NAME="methods_inherited_from_class_com.trolltech.qt.QSignalEmitter"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> <TH ALIGN="left"><B>Methods inherited from class com.trolltech.qt.<A HREF="../../../../com/trolltech/qt/QSignalEmitter.html" title="class in com.trolltech.qt">QSignalEmitter</A></B></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><A HREF="../../../../com/trolltech/qt/QSignalEmitter.html#blockSignals(boolean)">blockSignals</A>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.html#disconnect()">disconnect</A>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.html#disconnect(java.lang.Object)">disconnect</A>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.html#signalsBlocked()">signalsBlocked</A>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.html#signalSender()">signalSender</A>, <A HREF="../../../../com/trolltech/qt/QSignalEmitter.html#thread()">thread</A></CODE></TD> </TR> </TABLE> <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> <TH ALIGN="left"><B>Methods inherited from class java.lang.Object</B></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE>clone, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD> </TR> </TABLE> <A NAME="methods_inherited_from_class_com.trolltech.qt.QtJambiInterface"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> <TH ALIGN="left"><B>Methods inherited from interface com.trolltech.qt.<A HREF="../../../../com/trolltech/qt/QtJambiInterface.html" title="interface in com.trolltech.qt">QtJambiInterface</A></B></TH> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><A HREF="../../../../com/trolltech/qt/QtJambiInterface.html#disableGarbageCollection()">disableGarbageCollection</A>, <A HREF="../../../../com/trolltech/qt/QtJambiInterface.html#nativeId()">nativeId</A>, <A HREF="../../../../com/trolltech/qt/QtJambiInterface.html#nativePointer()">nativePointer</A>, <A HREF="../../../../com/trolltech/qt/QtJambiInterface.html#reenableGarbageCollection()">reenableGarbageCollection</A>, <A HREF="../../../../com/trolltech/qt/QtJambiInterface.html#setJavaOwnership()">setJavaOwnership</A></CODE></TD> </TR> </TABLE> <P> <!-- ========= CONSTRUCTOR DETAIL ======== --> <A NAME="constructor_detail"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"> <B>Constructor Detail</B></FONT></TH> </TR> </TABLE> <A NAME="QFileInfo(com.trolltech.qt.core.QDir, java.lang.String)"><!-- --></A><H3> QFileInfo</H3> <PRE> public <B>QFileInfo</B>(<A HREF="../../../../com/trolltech/qt/core/QDir.html" title="class in com.trolltech.qt.core">QDir</A> dir, java.lang.String file)</PRE> <DL> <DD><p>Constructs a new <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> that gives information about the given <tt>file</tt> in the directory <tt>dir</tt>.</p> <p>If <tt>dir</tt> has a relative path, the <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> will also have a relative path.</p> <P> <DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#isRelative()"><tt>isRelative</tt></a></DL> </DL> <HR> <A NAME="QFileInfo(com.trolltech.qt.core.QFile)"><!-- --></A><H3> QFileInfo</H3> <PRE> public <B>QFileInfo</B>(<A HREF="../../../../com/trolltech/qt/core/QFile.html" title="class in com.trolltech.qt.core">QFile</A> file)</PRE> <DL> <DD><p>Constructs a new <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> that gives information about file <tt>file</tt>.</p> <p>If the <tt>file</tt> has a relative path, the <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> will also have a relative path.</p> <P> <DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#isRelative()"><tt>isRelative</tt></a></DL> </DL> <HR> <A NAME="QFileInfo(com.trolltech.qt.core.QFileInfo)"><!-- --></A><H3> QFileInfo</H3> <PRE> public <B>QFileInfo</B>(<A HREF="../../../../com/trolltech/qt/core/QFileInfo.html" title="class in com.trolltech.qt.core">QFileInfo</A> fileinfo)</PRE> <DL> <DD><p>Constructs a new <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> that is a copy of the given <tt>fileinfo</tt>.</p> <P> </DL> <HR> <A NAME="QFileInfo(java.lang.String)"><!-- --></A><H3> QFileInfo</H3> <PRE> public <B>QFileInfo</B>(java.lang.String file)</PRE> <DL> <DD><p>Constructs a new <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> that gives information about the given file. The <tt>file</tt> can also include an absolute or relative path.</p> <P> <DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#setFile(com.trolltech.qt.core.QFile)"><tt>setFile</tt></a>, <a href="QFileInfo.html#isRelative()"><tt>isRelative</tt></a>, <tt>QDir::setCurrent</tt>, <tt>QDir::isRelativePath</tt></DL> </DL> <HR> <A NAME="QFileInfo()"><!-- --></A><H3> QFileInfo</H3> <PRE> public <B>QFileInfo</B>()</PRE> <DL> <DD><p>Constructs an empty <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> object.</p> <p>Note that an empty <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> object contain no file reference.</p> <P> <DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#setFile(com.trolltech.qt.core.QFile)"><tt>setFile</tt></a></DL> </DL> <!-- ============ METHOD DETAIL ========== --> <A NAME="method_detail"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2"> <B>Method Detail</B></FONT></TH> </TR> </TABLE> <A NAME="absoluteDir()"><!-- --></A><H3> absoluteDir</H3> <PRE> public final <A HREF="../../../../com/trolltech/qt/core/QDir.html" title="class in com.trolltech.qt.core">QDir</A> <B>absoluteDir</B>()</PRE> <DL> <DD><p>Returns the file's absolute path as a <a href="QDir.html"><tt>QDir</tt></a> object.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#filePath()"><tt>filePath</tt></a>, <a href="QFileInfo.html#fileName()"><tt>fileName</tt></a>, <a href="QFileInfo.html#isRelative()"><tt>isRelative</tt></a>, <a href="QFileInfo.html#dir()"><tt>dir</tt></a></DL> </DD> </DL> <HR> <A NAME="absoluteFilePath()"><!-- --></A><H3> absoluteFilePath</H3> <PRE> public final java.lang.String <B>absoluteFilePath</B>()</PRE> <DL> <DD><p>Returns the 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/'.</p> <p>This function returns the same as <a href="QFileInfo.html#filePath()"><tt>filePath</tt></a>, unless <a href="QFileInfo.html#isRelative()"><tt>isRelative</tt></a> is true.</p> <p>If the <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> is empty it returns QDir::currentPath().</p> <p>This function can be time consuming under Unix (in the order of milliseconds).</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#isRelative()"><tt>isRelative</tt></a>, <a href="QFileInfo.html#filePath()"><tt>filePath</tt></a></DL> </DD> </DL> <HR> <A NAME="absolutePath()"><!-- --></A><H3> absolutePath</H3> <PRE> public final java.lang.String <B>absolutePath</B>()</PRE> <DL> <DD><p>Returns the file's path absolute path. This doesn't include the file name.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#dir()"><tt>dir</tt></a>, <a href="QFileInfo.html#filePath()"><tt>filePath</tt></a>, <a href="QFileInfo.html#fileName()"><tt>fileName</tt></a>, <a href="QFileInfo.html#isRelative()"><tt>isRelative</tt></a>, <a href="QFileInfo.html#path()"><tt>path</tt></a></DL> </DD> </DL> <HR> <A NAME="baseName()"><!-- --></A><H3> baseName</H3> <PRE> public final java.lang.String <B>baseName</B>()</PRE> <DL> <DD><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> QFileInfo fi("/tmp/archive.tar.gz"); QString base = fi.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> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#fileName()"><tt>fileName</tt></a>, <a href="QFileInfo.html#suffix()"><tt>suffix</tt></a>, <a href="QFileInfo.html#completeSuffix()"><tt>completeSuffix</tt></a>, <a href="QFileInfo.html#completeBaseName()"><tt>completeBaseName</tt></a></DL> </DD> </DL> <HR> <A NAME="bundleName()"><!-- --></A><H3> bundleName</H3> <PRE> public final java.lang.String <B>bundleName</B>()</PRE> <DL> <DD><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()"><tt>isBundle</tt></a>. On all other platforms an empty <a href="%2E%2E/porting4.html#qstring"><tt>QString</tt></a> is returned.</p> <p>Example:</p> <pre> QFileInfo fi("/Applications/Safari.app"); QString bundle = fi.bundleName(); <span class="comment">// name = "Safari"</span></pre> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#isBundle()"><tt>isBundle</tt></a>, <a href="QFileInfo.html#filePath()"><tt>filePath</tt></a>, <a href="QFileInfo.html#baseName()"><tt>baseName</tt></a>, <tt>extension</tt></DL> </DD> </DL> <HR> <A NAME="caching()"><!-- --></A><H3> caching</H3> <PRE> public final boolean <B>caching</B>()</PRE> <DL> <DD><p>Returns true if caching is enabled; otherwise returns false.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#setCaching(boolean)"><tt>setCaching</tt></a>, <a href="QFileInfo.html#refresh()"><tt>refresh</tt></a></DL> </DD> </DL> <HR> <A NAME="canonicalFilePath()"><!-- --></A><H3> canonicalFilePath</H3> <PRE> public final java.lang.String <B>canonicalFilePath</B>()</PRE> <DL> <DD><p>Returns the canonical path, i.e. a path without symbolic links or redundant "." or ".." elements.</p> <p>On systems that do not have symbolic links this function will always return the same string that <a href="QFileInfo.html#absoluteFilePath()"><tt>absoluteFilePath</tt></a> returns. If the canonical path does not exist (normally due to dangling symbolic links) <a href="QFileInfo.html#canonicalFilePath()"><tt>canonicalFilePath</tt></a> returns an empty string.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#filePath()"><tt>filePath</tt></a>, <a href="QFileInfo.html#absoluteFilePath()"><tt>absoluteFilePath</tt></a></DL> </DD> </DL> <HR> <A NAME="canonicalPath()"><!-- --></A><H3> canonicalPath</H3> <PRE> public final java.lang.String <B>canonicalPath</B>()</PRE> <DL> <DD><p>Returns the canonical path, i.e. a path without symbolic links or redundant "." or ".." elements.</p> <p>On systems that do not have symbolic links this function will always return the same string that <a href="QFileInfo.html#absolutePath()"><tt>absolutePath</tt></a> returns. If the canonical path does not exist (normally due to dangling symbolic links) <a href="QFileInfo.html#canonicalPath()"><tt>canonicalPath</tt></a> returns an empty string.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#absolutePath()"><tt>absolutePath</tt></a></DL> </DD> </DL> <HR> <A NAME="completeBaseName()"><!-- --></A><H3> completeBaseName</H3> <PRE> public final java.lang.String <B>completeBaseName</B>()</PRE> <DL> <DD><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> QFileInfo fi("/tmp/archive.tar.gz"); QString base = fi.completeBaseName(); <span class="comment">// base = "archive.tar"</span></pre> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#fileName()"><tt>fileName</tt></a>, <a href="QFileInfo.html#suffix()"><tt>suffix</tt></a>, <a href="QFileInfo.html#completeSuffix()"><tt>completeSuffix</tt></a>, <a href="QFileInfo.html#baseName()"><tt>baseName</tt></a></DL> </DD> </DL> <HR> <A NAME="completeSuffix()"><!-- --></A><H3> completeSuffix</H3> <PRE> public final java.lang.String <B>completeSuffix</B>()</PRE> <DL> <DD><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> QFileInfo fi("/tmp/archive.tar.gz"); QString ext = fi.completeSuffix(); <span class="comment">// ext = "tar.gz"</span></pre> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#fileName()"><tt>fileName</tt></a>, <a href="QFileInfo.html#suffix()"><tt>suffix</tt></a>, <a href="QFileInfo.html#baseName()"><tt>baseName</tt></a>, <a href="QFileInfo.html#completeBaseName()"><tt>completeBaseName</tt></a></DL> </DD> </DL> <HR> <A NAME="created()"><!-- --></A><H3> created</H3> <PRE> public final <A HREF="../../../../com/trolltech/qt/core/QDateTime.html" title="class in com.trolltech.qt.core">QDateTime</A> <B>created</B>()</PRE> <DL> <DD><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()"><tt>lastModified</tt></a>.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#lastModified()"><tt>lastModified</tt></a>, <a href="QFileInfo.html#lastRead()"><tt>lastRead</tt></a></DL> </DD> </DL> <HR> <A NAME="dir()"><!-- --></A><H3> dir</H3> <PRE> public final <A HREF="../../../../com/trolltech/qt/core/QDir.html" title="class in com.trolltech.qt.core">QDir</A> <B>dir</B>()</PRE> <DL> <DD><p>Returns the path of the object's parent directory as a <a href="QDir.html"><tt>QDir</tt></a> object.</p> <p><b>Note:</b> The <a href="QDir.html"><tt>QDir</tt></a> returned always corresponds to the object's parent directory, even if the <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> represents a directory.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><tt>dirPath</tt>, <a href="QFileInfo.html#filePath()"><tt>filePath</tt></a>, <a href="QFileInfo.html#fileName()"><tt>fileName</tt></a>, <a href="QFileInfo.html#isRelative()"><tt>isRelative</tt></a>, <a href="QFileInfo.html#absoluteDir()"><tt>absoluteDir</tt></a></DL> </DD> </DL> <HR> <A NAME="exists()"><!-- --></A><H3> exists</H3> <PRE> public final boolean <B>exists</B>()</PRE> <DL> <DD><p>Returns true if the file exists; otherwise returns false.</p> <P> <DD><DL> </DL> </DD> </DL> <HR> <A NAME="fileName()"><!-- --></A><H3> fileName</H3> <PRE> public final java.lang.String <B>fileName</B>()</PRE> <DL> <DD><p>Returns the name of the file, excluding the path.</p> <p>Example:</p> <pre> QFileInfo fi("/tmp/archive.tar.gz"); QString name = fi.fileName(); <span class="comment">// name = "archive.tar.gz"</span></pre> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#isRelative()"><tt>isRelative</tt></a>, <a href="QFileInfo.html#filePath()"><tt>filePath</tt></a>, <a href="QFileInfo.html#baseName()"><tt>baseName</tt></a>, <tt>extension</tt></DL> </DD> </DL> <HR> <A NAME="filePath()"><!-- --></A><H3> filePath</H3> <PRE> public final java.lang.String <B>filePath</B>()</PRE> <DL> <DD><p>Returns the file name, including the path (which may be absolute or relative).</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#isRelative()"><tt>isRelative</tt></a>, <a href="QFileInfo.html#absoluteFilePath()"><tt>absoluteFilePath</tt></a></DL> </DD> </DL> <HR> <A NAME="group()"><!-- --></A><H3> group</H3> <PRE> public final java.lang.String <B>group</B>()</PRE> <DL> <DD><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> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#groupId()"><tt>groupId</tt></a>, <a href="QFileInfo.html#owner()"><tt>owner</tt></a>, <a href="QFileInfo.html#ownerId()"><tt>ownerId</tt></a></DL> </DD> </DL> <HR> <A NAME="groupId()"><!-- --></A><H3> groupId</H3> <PRE> public final int <B>groupId</B>()</PRE> <DL> <DD><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> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#group()"><tt>group</tt></a>, <a href="QFileInfo.html#owner()"><tt>owner</tt></a>, <a href="QFileInfo.html#ownerId()"><tt>ownerId</tt></a></DL> </DD> </DL> <HR> <A NAME="isAbsolute()"><!-- --></A><H3> isAbsolute</H3> <PRE> public final boolean <B>isAbsolute</B>()</PRE> <DL> <DD><p>Returns true if the file path name is absolute, otherwise returns false if the path is relative.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#isRelative()"><tt>isRelative</tt></a></DL> </DD> </DL> <HR> <A NAME="isBundle()"><!-- --></A><H3> isBundle</H3> <PRE> public final boolean <B>isBundle</B>()</PRE> <DL> <DD><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> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#isDir()"><tt>isDir</tt></a>, <a href="QFileInfo.html#isSymLink()"><tt>isSymLink</tt></a>, <a href="QFileInfo.html#isFile()"><tt>isFile</tt></a></DL> </DD> </DL> <HR> <A NAME="isDir()"><!-- --></A><H3> isDir</H3> <PRE> public final boolean <B>isDir</B>()</PRE> <DL> <DD><p>Returns true if this object points to a directory or to a symbolic link to a directory; otherwise returns false.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#isFile()"><tt>isFile</tt></a>, <a href="QFileInfo.html#isSymLink()"><tt>isSymLink</tt></a>, <a href="QFileInfo.html#isBundle()"><tt>isBundle</tt></a></DL> </DD> </DL> <HR> <A NAME="isExecutable()"><!-- --></A><H3> isExecutable</H3> <PRE> public final boolean <B>isExecutable</B>()</PRE> <DL> <DD><p>Returns true if the file is executable; otherwise returns false.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#isReadable()"><tt>isReadable</tt></a>, <a href="QFileInfo.html#isWritable()"><tt>isWritable</tt></a>, <a href="QFileInfo.html#permission(com.trolltech.qt.core.QFile.Permissions)"><tt>permission</tt></a></DL> </DD> </DL> <HR> <A NAME="isFile()"><!-- --></A><H3> isFile</H3> <PRE> public final boolean <B>isFile</B>()</PRE> <DL> <DD><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> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#isDir()"><tt>isDir</tt></a>, <a href="QFileInfo.html#isSymLink()"><tt>isSymLink</tt></a>, <a href="QFileInfo.html#isBundle()"><tt>isBundle</tt></a></DL> </DD> </DL> <HR> <A NAME="isHidden()"><!-- --></A><H3> isHidden</H3> <PRE> public final boolean <B>isHidden</B>()</PRE> <DL> <DD><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> <P> <DD><DL> </DL> </DD> </DL> <HR> <A NAME="isReadable()"><!-- --></A><H3> isReadable</H3> <PRE> public final boolean <B>isReadable</B>()</PRE> <DL> <DD><p>Returns true if the user can read the file; otherwise returns false.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#isWritable()"><tt>isWritable</tt></a>, <a href="QFileInfo.html#isExecutable()"><tt>isExecutable</tt></a>, <a href="QFileInfo.html#permission(com.trolltech.qt.core.QFile.Permissions)"><tt>permission</tt></a></DL> </DD> </DL> <HR> <A NAME="isRelative()"><!-- --></A><H3> isRelative</H3> <PRE> public final boolean <B>isRelative</B>()</PRE> <DL> <DD><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> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#isAbsolute()"><tt>isAbsolute</tt></a></DL> </DD> </DL> <HR> <A NAME="isRoot()"><!-- --></A><H3> isRoot</H3> <PRE> public final boolean <B>isRoot</B>()</PRE> <DL> <DD><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> <P> <DD><DL> </DL> </DD> </DL> <HR> <A NAME="isSymLink()"><!-- --></A><H3> isSymLink</H3> <PRE> public final boolean <B>isSymLink</B>()</PRE> <DL> <DD><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</tt></a>. On Windows, it opens the <tt>.lnk</tt> file itself.</p> <p>Example:</p> <pre> QFileInfo info(fileName); if (info.isSymLink()) fileName = info.symLinkTarget();</pre> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#isFile()"><tt>isFile</tt></a>, <a href="QFileInfo.html#isDir()"><tt>isDir</tt></a>, <a href="QFileInfo.html#symLinkTarget()"><tt>symLinkTarget</tt></a></DL> </DD> </DL> <HR> <A NAME="isWritable()"><!-- --></A><H3> isWritable</H3> <PRE> public final boolean <B>isWritable</B>()</PRE> <DL> <DD><p>Returns true if the user can write to the file; otherwise returns false.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#isReadable()"><tt>isReadable</tt></a>, <a href="QFileInfo.html#isExecutable()"><tt>isExecutable</tt></a>, <a href="QFileInfo.html#permission(com.trolltech.qt.core.QFile.Permissions)"><tt>permission</tt></a></DL> </DD> </DL> <HR> <A NAME="lastModified()"><!-- --></A><H3> lastModified</H3> <PRE> public final <A HREF="../../../../com/trolltech/qt/core/QDateTime.html" title="class in com.trolltech.qt.core">QDateTime</A> <B>lastModified</B>()</PRE> <DL> <DD><p>Returns the date and time when the file was last modified.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#created()"><tt>created</tt></a>, <a href="QFileInfo.html#lastRead()"><tt>lastRead</tt></a></DL> </DD> </DL> <HR> <A NAME="lastRead()"><!-- --></A><H3> lastRead</H3> <PRE> public final <A HREF="../../../../com/trolltech/qt/core/QDateTime.html" title="class in com.trolltech.qt.core">QDateTime</A> <B>lastRead</B>()</PRE> <DL> <DD><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()"><tt>lastModified</tt></a>.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#created()"><tt>created</tt></a>, <a href="QFileInfo.html#lastModified()"><tt>lastModified</tt></a></DL> </DD> </DL> <HR> <A NAME="makeAbsolute()"><!-- --></A><H3> makeAbsolute</H3> <PRE> public final boolean <B>makeAbsolute</B>()</PRE> <DL> <DD><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> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#filePath()"><tt>filePath</tt></a>, <a href="QFileInfo.html#isRelative()"><tt>isRelative</tt></a></DL> </DD> </DL> <HR> <A NAME="owner()"><!-- --></A><H3> owner</H3> <PRE> public final java.lang.String <B>owner</B>()</PRE> <DL> <DD><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> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#ownerId()"><tt>ownerId</tt></a>, <a href="QFileInfo.html#group()"><tt>group</tt></a>, <a href="QFileInfo.html#groupId()"><tt>groupId</tt></a></DL> </DD> </DL> <HR> <A NAME="ownerId()"><!-- --></A><H3> ownerId</H3> <PRE> public final int <B>ownerId</B>()</PRE> <DL> <DD><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> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#owner()"><tt>owner</tt></a>, <a href="QFileInfo.html#group()"><tt>group</tt></a>, <a href="QFileInfo.html#groupId()"><tt>groupId</tt></a></DL> </DD> </DL> <HR> <A NAME="path()"><!-- --></A><H3> path</H3> <PRE> public final java.lang.String <B>path</B>()</PRE> <DL> <DD><p>Returns the file's path. This doesn't include the file name.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#dir()"><tt>dir</tt></a>, <a href="QFileInfo.html#filePath()"><tt>filePath</tt></a>, <a href="QFileInfo.html#fileName()"><tt>fileName</tt></a>, <a href="QFileInfo.html#isRelative()"><tt>isRelative</tt></a>, <a href="QFileInfo.html#absolutePath()"><tt>absolutePath</tt></a></DL> </DD> </DL> <HR> <A NAME="permission(com.trolltech.qt.core.QFile.Permission...)"><!-- --></A><H3> permission</H3> <PRE> public final boolean <B>permission</B>(<A HREF="../../../../com/trolltech/qt/core/QFile.Permission.html" title="enum in com.trolltech.qt.core">QFile.Permission</A>... permissions)</PRE> <DL> <DD><p>Tests for file permissions. The <tt>permissions</tt> argument can be several flags of type QFile::Permissions 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> QFileInfo fi("/tmp/archive.tar.gz"); if (fi.permission(QFile::WriteUser | QFile::ReadGroup)) qWarning("I can change the file; my group can read the file"); if (fi.permission(QFile::WriteGroup | QFile::WriteOther)) qWarning("The group or others can change the file");</pre> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#isReadable()"><tt>isReadable</tt></a>, <a href="QFileInfo.html#isWritable()"><tt>isWritable</tt></a>, <a href="QFileInfo.html#isExecutable()"><tt>isExecutable</tt></a></DL> </DD> </DL> <HR> <A NAME="permission(com.trolltech.qt.core.QFile.Permissions)"><!-- --></A><H3> permission</H3> <PRE> public final boolean <B>permission</B>(<A HREF="../../../../com/trolltech/qt/core/QFile.Permissions.html" title="class in com.trolltech.qt.core">QFile.Permissions</A> permissions)</PRE> <DL> <DD><p>Tests for file permissions. The <tt>permissions</tt> argument can be several flags of type QFile::Permissions 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> QFileInfo fi("/tmp/archive.tar.gz"); if (fi.permission(QFile::WriteUser | QFile::ReadGroup)) qWarning("I can change the file; my group can read the file"); if (fi.permission(QFile::WriteGroup | QFile::WriteOther)) qWarning("The group or others can change the file");</pre> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#isReadable()"><tt>isReadable</tt></a>, <a href="QFileInfo.html#isWritable()"><tt>isWritable</tt></a>, <a href="QFileInfo.html#isExecutable()"><tt>isExecutable</tt></a></DL> </DD> </DL> <HR> <A NAME="permissions()"><!-- --></A><H3> permissions</H3> <PRE> public final <A HREF="../../../../com/trolltech/qt/core/QFile.Permissions.html" title="class in com.trolltech.qt.core">QFile.Permissions</A> <B>permissions</B>()</PRE> <DL> <DD><p>Returns the complete OR-ed together combination of QFile::Permissions for the file.</p> <P> <DD><DL> </DL> </DD> </DL> <HR> <A NAME="refresh()"><!-- --></A><H3> refresh</H3> <PRE> public final void <B>refresh</B>()</PRE> <DL> <DD><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> <DD><DL> </DL> </DD> </DL> <HR> <A NAME="setCaching(boolean)"><!-- --></A><H3> setCaching</H3> <PRE> public final void <B>setCaching</B>(boolean on)</PRE> <DL> <DD><p>If <tt>on</tt> is true, enables caching of file information. If <tt>on</tt> is false caching is disabled.</p> <p>When caching is enabled, <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></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> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#refresh()"><tt>refresh</tt></a>, <a href="QFileInfo.html#caching()"><tt>caching</tt></a></DL> </DD> </DL> <HR> <A NAME="setFile(com.trolltech.qt.core.QDir, java.lang.String)"><!-- --></A><H3> setFile</H3> <PRE> public final void <B>setFile</B>(<A HREF="../../../../com/trolltech/qt/core/QDir.html" title="class in com.trolltech.qt.core">QDir</A> dir, java.lang.String file)</PRE> <DL> <DD><p>Sets the file that the <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> provides information about to <tt>file</tt> in directory <tt>dir</tt>.</p> <p>If <tt>file</tt> includes a relative path, the <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> will also have a relative path.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#isRelative()"><tt>isRelative</tt></a></DL> </DD> </DL> <HR> <A NAME="setFile(java.lang.String)"><!-- --></A><H3> setFile</H3> <PRE> public final void <B>setFile</B>(java.lang.String file)</PRE> <DL> <DD><p>Sets the file that the <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> provides information about to <tt>file</tt>.</p> <p>The <tt>file</tt> 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> QString absolute = "/local/bin"; QString relative = "local/bin"; QFileInfo absFile(absolute); QFileInfo relFile(relative); QDir::setCurrent(QDir::rootPath()); <span class="comment"> // absFile and relFile now point to the same file</span> QDir::setCurrent("/tmp"); <span class="comment"> // absFile now points to "/local/bin",</span> <span class="comment"> // while relFile points to "/tmp/local/bin"</span></pre> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#isRelative()"><tt>isRelative</tt></a>, <tt>QDir::setCurrent</tt>, <tt>QDir::isRelativePath</tt></DL> </DD> </DL> <HR> <A NAME="setFile(com.trolltech.qt.core.QFile)"><!-- --></A><H3> setFile</H3> <PRE> public final void <B>setFile</B>(<A HREF="../../../../com/trolltech/qt/core/QFile.html" title="class in com.trolltech.qt.core">QFile</A> file)</PRE> <DL> <DD><p>Sets the file that the <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> provides information about to <tt>file</tt>.</p> <p>If <tt>file</tt> includes a relative path, the <a href="QFileInfo.html#QFileInfo()"><tt>QFileInfo</tt></a> will also have a relative path.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#isFile()"><tt>isFile</tt></a>, <a href="QFileInfo.html#isRelative()"><tt>isRelative</tt></a></DL> </DD> </DL> <HR> <A NAME="size()"><!-- --></A><H3> size</H3> <PRE> public final long <B>size</B>()</PRE> <DL> <DD><p>Returns the file size in bytes. If the file does not exist or cannot be fetched, 0 is returned.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#exists()"><tt>exists</tt></a></DL> </DD> </DL> <HR> <A NAME="suffix()"><!-- --></A><H3> suffix</H3> <PRE> public final java.lang.String <B>suffix</B>()</PRE> <DL> <DD><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> QFileInfo fi("/tmp/archive.tar.gz"); QString ext = fi.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> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#fileName()"><tt>fileName</tt></a>, <a href="QFileInfo.html#completeSuffix()"><tt>completeSuffix</tt></a>, <a href="QFileInfo.html#baseName()"><tt>baseName</tt></a>, <a href="QFileInfo.html#completeBaseName()"><tt>completeBaseName</tt></a></DL> </DD> </DL> <HR> <A NAME="symLinkTarget()"><!-- --></A><H3> symLinkTarget</H3> <PRE> public final java.lang.String <B>symLinkTarget</B>()</PRE> <DL> <DD><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. QFileInfo::exists() returns true if the symlink points to an existing file.</p> <P> <DD><DL> <DT><B>See Also:</B><DD><a href="QFileInfo.html#exists()"><tt>exists</tt></a>, <a href="QFileInfo.html#isSymLink()"><tt>isSymLink</tt></a>, <a href="QFileInfo.html#isDir()"><tt>isDir</tt></a>, <a href="QFileInfo.html#isFile()"><tt>isFile</tt></a></DL> </DD> </DL> <HR> <A NAME="fromNativePointer(com.trolltech.qt.QNativePointer)"><!-- --></A><H3> fromNativePointer</H3> <PRE> public static <A HREF="../../../../com/trolltech/qt/core/QFileInfo.html" title="class in com.trolltech.qt.core">QFileInfo</A> <B>fromNativePointer</B>(<A HREF="../../../../com/trolltech/qt/QNativePointer.html" title="class in com.trolltech.qt">QNativePointer</A> nativePointer)</PRE> <DL> <DD>This function returns the QFileInfo instance pointed to by nativePointer <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>nativePointer</CODE> - the QNativePointer of which object should be returned.</DL> </DD> </DL> <HR> <A NAME="nativePointerArray(com.trolltech.qt.core.QFileInfo[])"><!-- --></A><H3> nativePointerArray</H3> <PRE> public static <A HREF="../../../../com/trolltech/qt/QNativePointer.html" title="class in com.trolltech.qt">QNativePointer</A> <B>nativePointerArray</B>(<A HREF="../../../../com/trolltech/qt/core/QFileInfo.html" title="class in com.trolltech.qt.core">QFileInfo</A>[] array)</PRE> <DL> <DD>This function returns a QNativePointer that is pointing to the specified QFileInfo array. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>array</CODE> - the array that the returned pointer will point to. <DT><B>Returns:</B><DD>a QNativePointer that is pointing to the specified array.</DL> </DD> </DL> <HR> <A NAME="equals(java.lang.Object)"><!-- --></A><H3> equals</H3> <PRE> public boolean <B>equals</B>(java.lang.Object other)</PRE> <DL> <DD> <P> <DD><DL> <DT><B>Overrides:</B><DD><CODE>equals</CODE> in class <CODE>java.lang.Object</CODE></DL> </DD> <DD><DL> </DL> </DD> </DL> <!-- ========= END OF CLASS DATA ========= --> <HR> <!-- ======= START OF BOTTOM NAVBAR ====== --> <A NAME="navbar_bottom"><!-- --></A> <A HREF="#skip-navbar_bottom" title="Skip navigation links"></A> <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""> <TR> <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A NAME="navbar_bottom_firstrow"><!-- --></A> <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> <TR ALIGN="center" VALIGN="top"> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> </TR> </TABLE> </TD> <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM> </EM> </TD> </TR> <TR> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../../com/trolltech/qt/core/QFile.Permissions.html" title="class in com.trolltech.qt.core"><B>PREV CLASS</B></A> <A HREF="../../../../com/trolltech/qt/core/QFileSystemWatcher.html" title="class in com.trolltech.qt.core"><B>NEXT CLASS</B></A></FONT></TD> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../../index.html?com/trolltech/qt/core/QFileInfo.html" target="_top"><B>FRAMES</B></A> <A HREF="QFileInfo.html" target="_top"><B>NO FRAMES</B></A> <SCRIPT type="text/javascript"> <!-- if(window==top) { document.writeln('<A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A>'); } //--> </SCRIPT> <NOSCRIPT> <A HREF="../../../../allclasses-noframe.html"><B>All Classes</B></A> </NOSCRIPT> </FONT></TD> </TR> <TR> <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> SUMMARY: <A HREF="#nested_classes_inherited_from_class_com.trolltech.qt.QSignalEmitter">NESTED</A> | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD> <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD> </TR> </TABLE> <A NAME="skip-navbar_bottom"></A> <!-- ======== END OF BOTTOM NAVBAR ======= --> <HR> </BODY> </HTML>