<HTML>
<HEAD>
<TITLE>class KStandardDirs</TITLE>
<META NAME="Generator" CONTENT="KDOC ">
</HEAD>
<BODY bgcolor="#ffffff" text="#000000" link="#0000ff" vlink="#000099" alink= "#ffffff">
<TABLE WIDTH="100%" BORDER="0">
<TR>
<TD>
<TABLE BORDER="0">
<TR><TD valign="top" align="left" cellspacing="10">
<h1>class KStandardDirs</h1>
</TD>
<TD valign="top" align="right" colspan="1">Site-independent access to standard KDE directories.
<small><A HREF="#longdesc">More...</A></small></TD></TR>
</TABLE>
<HR>
<TABLE BORDER="0">
<TR><TH>Definition</TH><TD><code>#include <<A HREF="kstddirs_h.html">kstddirs.h</A>></code></TD></TR>
<TR><TH><A HREF="full-list-KStandardDirs.html">List of all Methods</A></TH></TR>
</TABLE>
</TD>
<TD align="right"><TABLE BORDER="0"><TR><TD><small><A HREF="index-long.html">Annotated List</A></small></TD></TR>
<TR><TD><small><A HREF="header-list.html">Files</A></small></TD></TR>
<TR><TD><small><A HREF="all-globals.html">Globals</A></small></TD></TR>
<TR><TD><small><A HREF="hier.html">Hierarchy</A></small></TD></TR>
<TR><TD><small><A HREF="index.html">Index</A></small></TD></TR>
</TABLE></TD></TR></TABLE>
<h4>Public Methods</h4><ul><LI> <b><A HREF="#ref1">KStandardDirs</A></b> ( )
</LI>
<LI>virtual <b><A HREF="#ref2">~KStandardDirs</A></b> ()
</LI>
<LI>void <b><A HREF="#ref3">addPrefix</A></b> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& dir )
</LI>
<LI>bool <b><A HREF="#ref4">addResourceType</A></b> ( const char *type,
const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& relativename )
</LI>
<LI>bool <b><A HREF="#ref5">addResourceDir</A></b> ( const char *type,
const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& absdir)
</LI>
<LI><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref6">findResource</A></b> ( const char *type,
const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& filename ) const
</LI>
<LI>Q_UINT32 <b><A HREF="#ref7">calcResourceHash</A></b> ( const char *type,
const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& filename, bool deep) const
</LI>
<LI><A HREF="#QStringList">QStringList</A> <b><A HREF="#ref8">findDirs</A></b> ( const char *type,
const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& reldir ) const
</LI>
<LI><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref9">findResourceDir</A></b> ( const char *type,
const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& filename) const
</LI>
<LI><A HREF="#QStringList">QStringList</A> <b><A HREF="#ref10">findAllResources</A></b> ( const char *type,
const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& filter = QString::null,
bool recursive = false,
bool uniq = false) const
</LI>
<LI><A HREF="#QStringList">QStringList</A> <b><A HREF="#ref11">findAllResources</A></b> ( const char *type,
const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& filter,
bool recursive,
bool uniq,
<A HREF="#QStringList">QStringList</A> &relPaths) const
</LI>
<LI>void <b><A HREF="#ref14">addKDEDefaults</A></b> ()
</LI>
<LI>bool <b><A HREF="#ref15">addCustomized</A></b> (<A HREF="KConfig.html">KConfig</A> *config)
</LI>
<LI><A HREF="#QStringList">QStringList</A> <b><A HREF="#ref16">resourceDirs</A></b> (const char *type) const
</LI>
<LI><A HREF="#QStringList">QStringList</A> <b><A HREF="#ref17">allTypes</A></b> () const
</LI>
<LI><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref18">saveLocation</A></b> (const char *type,
const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& suffix = QString::null,
bool create = true) const
</LI>
<LI><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref21">kfsstnd_prefixes</A></b> ()
</LI>
<LI><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref22">localkdedir</A></b> () const
</LI>
</ul><h4>Public Static Methods</h4><ul><LI>static <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref12">findExe</A></b> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& appname,
const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& pathstr=QString::null,
bool ignoreExecBit=false )
</LI>
<LI>static int <b><A HREF="#ref13">findAllExe</A></b> ( <A HREF="#QStringList">QStringList</A>& list, const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& appname,
const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& pathstr=QString::null,
bool ignoreExecBit=false )
</LI>
<LI>static bool <b><A HREF="#ref19">makeDir</A></b> (const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& dir, int mode = 0755)
</LI>
<LI>static <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <b><A HREF="#ref20">kde_default</A></b> (const char *type)
</LI>
<LI>static bool <b><A HREF="#ref23">exists</A></b> (const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> &fullPath)
</LI>
</ul><HR><H2><A NAME="longdesc">Detailed Description</A></H2><p>
</p>
<p> This is one of the most central classes in kdelibs as
it provides a basic service: It knows where the files
reside on the user's hard disk. And it's meant to be the
only one that knows -- to make the real location as
transparent as possible to both the user and the applications.
</p>
<p> To this end it insulates the application from all information
and applications always refer to a file with a resource type
(e.g. icon) and a filename (e.g. khexdit.xpm). In an ideal world
the application would make no assumption where this file is and
leave it up to KStandardDirs::findResource("apps", "Home.desktop")
to apply this knowledge to return /opt/kde/share/applnk/Home.desktop
or locate("data", "kgame/background.jpg") to return
/opt/kde/share/apps/kgame/background.jpg
</p>
<p> The main idea behind <A HREF="KStandardDirs.html#KStandardDirs">KStandardDirs</A> is that there are several
toplevel prefixes below which the files lie. One of these prefixes is
the one where the user installed kdelibs, one is where the
application was installed, and one is $HOME/.kde, but there
may be even more. Under these prefixes there are several well
defined suffixes where specific resource types are to be found.
For example, for the resource type "html" the suffixes could be
share/doc/HTML and share/doc/kde/HTML.
So the search algorithm basicly appends to each prefix each registered
suffix and tries to locate the file there.
To make the thing even more complex, it's also possible to register
absolute paths that <A HREF="KStandardDirs.html#KStandardDirs">KStandardDirs</A> looks up after not finding anything
in the former steps. They can be useful if the user wants to provide
specific directories that aren't in his $HOME/.kde directory for,
for example, icons.
</p>
<p></p>
<H3>Standard resources that kdelibs allocates are:
</H3>
<p>
</p>
<p></p>
<ul>
<li>apps - Applications menu (.desktop files).
</li>
<li>cgi - CGIs to run from kdehelp.
</li>
<li>config - Configuration files.
</li>
<li>data - Where applications store data.
</li>
<li>exe - Executables in $prefix/bin. <A HREF="KStandardDirs.html#findExe">findExe</A> for a function that takes $PATH into account.
</li>
<li>html - HTML documentation.
</li>
<li>icon - Icons, see <A HREF="KIconLoader.html">KIconLoader</A>.
</li>
<li>lib - Libraries.
</li>
<li>locale - Translation files for <A HREF="KLocale.html">KLocale</A>.
</li>
<li>mime - Mime types.
</li>
<li>module - Module (dynamically loaded library).
</li>
<li>services - Services.
</li>
<li>servicetypes - Service types.
</li>
<li>sound - Application sounds.
</li>
<li>templates - Templates
</li>
<li>wallpaper - Wallpapers.
</li>
<li>tmp - Temporary files (specfic for both current host and current user)
</li>
<li>socket - UNIX Sockets (specific for both current host and current user)
</li>
</ul>
<p>
</p>
<p> A type that is added by the class KApplication if you use it, is
appdata. This one makes the use of the type data a bit easier as it
appends the name of the application.
So while you had to <A HREF="#locate">locate</A>("data", "appname/filename") so you can
also write <A HREF="#locate">locate</A>("appdata", "filename") if your KApplication instance
is called "appname". Please note though that you cannot use the "appdata"
type if you intend to use it in an applet for Kicker because 'appname' would
be "Kicker" instead of the applet's name. Therefore, for applets, you've got
to work around this by using <A HREF="#locate">locate</A>("data", "appletname/filename").
</p>
<p></p>
<H3>KStandardDirs supports the following environment variables:
</H3>
<p>
</p>
<p></p>
<ul>
<li>KDEDIRS: This may set an additional number of directory prefixes to
search for resources. The directories should be seperated
by ':'. The directories are searched in the order they are
specified.
</li>
<li>KDEDIR: Used for backwards compatibility. As KDEDIRS but only a single
directory may be specified. If KDEDIRS is set KDEDIR is
ignored.
</li>
<li>KDEHOME: The directory where changes are saved to. This directory is
used to search for resources first. If KDEHOME is not
specified it defaults to "$HOME/.kde"
</li>
</ul>
<p>
</p>
<p></p>
<A NAME="KStandardDirs"></A><A NAME="ref1"></A><table width="100%"><tr bgcolor="#eeeeee"><td> <strong>KStandardDirs</strong> ( )
<br></td><td align="right"><h3><strong>KStandardDirs</strong></h3></td></tr></table><p></p><p>
<A HREF="KStandardDirs.html#KStandardDirs">KStandardDirs</A> constructor. It just initializes the caches.
</p>
<A NAME="~KStandardDirs"></A><A NAME="ref2"></A><table width="100%"><tr bgcolor="#eeeeee"><td> <strong>~KStandardDirs</strong> ()
<br></td><td align="right"><h3><strong>~KStandardDirs</strong></h3></td></tr></table><p> <small>[virtual]</small></p><p>
<A HREF="KStandardDirs.html#KStandardDirs">KStandardDirs</A> destructor.
</p>
<A NAME="addPrefix"></A><A NAME="ref3"></A><table width="100%"><tr bgcolor="#eeeeee"><td>void <strong>addPrefix</strong> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& dir )
<br></td><td align="right"><h3><strong>addPrefix</strong></h3></td></tr></table><p></p><p>
Add another search dir to front of the <code>fsstnd</code> list.
</p>
<p></p>
<ul>
<li>When compiling kdelibs, the prefix is added to this.
</li>
<li>KDEDIRS or KDEDIR is taking into account
</li>
<li>Additional dirs may be loaded from kdeglobals.
</li>
</ul>
<p>
</p>
<p></p>
<p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5">
<TR><TD align="left" valign="top"><i>dir</i></TD><TD align="left" valign="top">The directory to append relative paths to.
</TD></TR>
</TABLE></P>
<A NAME="addResourceType"></A><A NAME="ref4"></A><table width="100%"><tr bgcolor="#eeeeee"><td>bool <strong>addResourceType</strong> ( const char *type,
const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& relativename )
<br></td><td align="right"><h3><strong>addResourceType</strong></h3></td></tr></table><p></p><p>
Add suffixes for types.
</p>
<p> You may add as many as you need, but it is advised that there
is exactly one to make writing definite.
All basic types (<A HREF="KStandardDirs.html#kde_default">kde_default</A>) are added by <A HREF="KStandardDirs.html#addKDEDefaults">addKDEDefaults</A>(),
but for those you can add more relative paths as well.
</p>
<p> The later a suffix is added, the higher its priority. Note, that the
suffix should end with / but doesn't have to start with one (as prefixes
should end with one). So adding a suffix for app_pics would look
like KGlobal::dirs()->addResourceType("app_pics", "share/app/pics");
</p>
<p></p>
<p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5">
<TR><TD align="left" valign="top"><i>type</i></TD><TD align="left" valign="top">Specifies a short descriptive string to access
files of this type.
</TD></TR>
<TR><TD align="left" valign="top"><i>relativename</i></TD><TD align="left" valign="top">Specifies a directory relative to the root
of the KFSSTND.
</TD></TR>
</TABLE></P>
<A NAME="addResourceDir"></A><A NAME="ref5"></A><table width="100%"><tr bgcolor="#eeeeee"><td>bool <strong>addResourceDir</strong> ( const char *type,
const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& absdir)
<br></td><td align="right"><h3><strong>addResourceDir</strong></h3></td></tr></table><p></p><p>
Add absolute path at the end of the search path for
particular types (for example in case of icons where
the user specifies extra paths).
</p>
<p> You shouldn't need this
function in 99% of all cases besides adding user-given
paths.
</p>
<p></p>
<p> </p>
<p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5">
<TR><TD align="left" valign="top"><i>type</i></TD><TD align="left" valign="top">Specifies a short descriptive string to access files
of this type.
</TD></TR>
<TR><TD align="left" valign="top"><i>absdir</i></TD><TD align="left" valign="top">Points to directory where to look for this specific
type. Non-existant directories may be saved but pruned.
</TD></TR>
</TABLE></P>
<A NAME="findResource"></A><A NAME="ref6"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>findResource</strong> ( const char *type,
const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& filename )
<br></td><td align="right"><h3><strong>findResource</strong></h3></td></tr></table><p> <small>[const]</small></p><p>
Try to find resource in the following order:
</p>
<ul>
<li>All PREFIX/<relativename> paths (most recent first).
</li>
<li>All absolute paths (most recent first).
</li>
</ul>
<p>
</p>
<p> The filename should be a filename relative to the base dir
for resources. So is a way to get the path to libkdecore.la
to findResource("lib", "libkdecore.la"). KStandardDirs will
then look into the subdir lib of all elements of all prefixes
($KDEDIRS) for a file libkdecore.la and return the path to
the first one it finds (e.g. /opt/kde/lib/libkdecore.la)
</p>
<p></p>
<p></p>
<p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5">
<TR><TD align="left" valign="top"><i>type</i></TD><TD align="left" valign="top">The type of the wanted resource
</TD></TR>
<TR><TD align="left" valign="top"><i>filename</i></TD><TD align="left" valign="top">A relative filename of the resource.
</TD></TR>
</TABLE></P>
<p><b>Returns</b>: A full path to the filename specified in the second
argument, or QString::null if not found.
</p>
<A NAME="calcResourceHash"></A><A NAME="ref7"></A><table width="100%"><tr bgcolor="#eeeeee"><td>Q_UINT32 <strong>calcResourceHash</strong> ( const char *type,
const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& filename, bool deep)
<br></td><td align="right"><h3><strong>calcResourceHash</strong></h3></td></tr></table><p> <small>[const]</small></p><p>
Returns a number that identifies this version of the resource.
When a change is made to the resource this number will change.
</p>
<p></p>
<p></p>
<p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5">
<TR><TD align="left" valign="top"><i>type</i></TD><TD align="left" valign="top">The type of the wanted resource
</TD></TR>
<TR><TD align="left" valign="top"><i>filename</i></TD><TD align="left" valign="top">A relative filename of the resource.
</TD></TR>
<TR><TD align="left" valign="top"><i>deep</i></TD><TD align="left" valign="top">If true, all resources are taken into account
otherwise only the one returned by findResource().
</TD></TR>
</TABLE></P>
<p><b>Returns</b>: A number identifying the current version of the
resource.
</p>
<A NAME="findDirs"></A><A NAME="ref8"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="#QStringList">QStringList</A> <strong>findDirs</strong> ( const char *type,
const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& reldir )
<br></td><td align="right"><h3><strong>findDirs</strong></h3></td></tr></table><p> <small>[const]</small></p><p>
Try to find all directories whose names consist of the
specified type and a relative path. So would
findDirs("apps", "Settings") return
</p>
<ul>
<li>/opt/kde/share/applnk/Settings/
</li>
<li>/home/joe/.kde/share/applnk/Settings/
</li>
</ul>
<p>
</p>
<p> Note that it appends / to the end of the directories,
so you can use this right away as directory names.
</p>
<p></p>
<p></p>
<p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5">
<TR><TD align="left" valign="top"><i>type</i></TD><TD align="left" valign="top">The type of the base directory.
</TD></TR>
<TR><TD align="left" valign="top"><i>reldir</i></TD><TD align="left" valign="top">Relative directory.
</TD></TR>
</TABLE></P>
<p><b>Returns</b>: A list of matching directories, or an empty
list if the resource specified is not found.
</p>
<A NAME="findResourceDir"></A><A NAME="ref9"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>findResourceDir</strong> ( const char *type,
const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& filename)
<br></td><td align="right"><h3><strong>findResourceDir</strong></h3></td></tr></table><p> <small>[const]</small></p><p>
Try to find the directory the file is in.
It works the same as <A HREF="KStandardDirs.html#findResource">findResource</A>(), but it doesn't
return the filename but the name of the directory.
</p>
<p> This way the application can access a couple of files
that have been installed into the same directory without
having to look for each file.
</p>
<p> findResourceDir("lib", "libkdecore.la") would return the
path of the subdir libkdecore.la is found first in
(e.g. /opt/kde/lib/)
</p>
<p></p>
<p><b>Returns</b>: The directory where the file specified in the second
argument is located, or QString::null if the type
of resource specified is unknown or the resource
cannot be found.
</p>
<A NAME="findAllResources"></A><A NAME="ref10"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="#QStringList">QStringList</A> <strong>findAllResources</strong> ( const char *type,
const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& filter = QString::null,
bool recursive = false,
bool uniq = false)
<br></td><td align="right"><h3><strong>findAllResources</strong></h3></td></tr></table><p> <small>[const]</small></p><p>
Try to find all resources with the specified type.
</p>
<p> The function will look into all specified directories
and return all filenames in these directories.
</p>
<p></p>
<p></p>
<p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5">
<TR><TD align="left" valign="top"><i>type</i></TD><TD align="left" valign="top">The type of resource to locate directories for.
</TD></TR>
<TR><TD align="left" valign="top"><i>filter</i></TD><TD align="left" valign="top">Only accept filenames that fit to filter. The filter
may consist of an optional directory and a QRexExp
wildcard expression. E.g. "images\*.jpg"
</TD></TR>
<TR><TD align="left" valign="top"><i>recursive</i></TD><TD align="left" valign="top">Specifies if the function should decend
into subdirectories.
</TD></TR>
<TR><TD align="left" valign="top"><i>uniq</i></TD><TD align="left" valign="top">If specified, only return items which have
unique suffixes - supressing duplicated filenames.
</TD></TR>
</TABLE></P>
<p><b>Returns</b>: A list of directories matching the resource specified,
or an empty list if the resource type is unknown.
</p>
<A NAME="findAllResources"></A><A NAME="ref11"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="#QStringList">QStringList</A> <strong>findAllResources</strong> ( const char *type,
const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& filter,
bool recursive,
bool uniq,
<A HREF="#QStringList">QStringList</A> &relPaths)
<br></td><td align="right"><h3><strong>findAllResources</strong></h3></td></tr></table><p> <small>[const]</small></p><p>
Try to find all resources with the specified type.
</p>
<p> The function will look into all specified directories
and return all filenames (full and relative paths) in
these directories.
</p>
<p></p>
<p></p>
<p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5">
<TR><TD align="left" valign="top"><i>type</i></TD><TD align="left" valign="top">The type of resource to locate directories for.
</TD></TR>
<TR><TD align="left" valign="top"><i>filter</i></TD><TD align="left" valign="top">Only accept filenames that fit to filter. The filter
may consist of an optional directory and a QRexExp
wildcard expression. E.g. "images\*.jpg"
</TD></TR>
<TR><TD align="left" valign="top"><i>recursive</i></TD><TD align="left" valign="top">Specifies if the function should decend
into subdirectories.
</TD></TR>
<TR><TD align="left" valign="top"><i>uniq</i></TD><TD align="left" valign="top">If specified, only return items which have
unique suffixes.
</TD></TR>
<TR><TD align="left" valign="top"><i>list</i></TD><TD align="left" valign="top">Of relative paths for the given type.
</TD></TR>
<TR><TD align="left" valign="top"><i>relPaths</i></TD><TD align="left" valign="top">The list to store the relative paths into
These can be used later to <A HREF="#locate">locate</A> the file
</TD></TR>
</TABLE></P>
<p><b>Returns</b>: A list of directories matching the resource specified,
or an empty list if the resource type is unknown.
</p>
<A NAME="findExe"></A><A NAME="ref12"></A><table width="100%"><tr bgcolor="#eeeeee"><td> <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>findExe</strong> ( const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& appname,
const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& pathstr=QString::null,
bool ignoreExecBit=false )
<br></td><td align="right"><h3><strong>findExe</strong></h3></td></tr></table><p> <small>[static]</small></p><p>
Find the executable in the system path.
</p>
<p> A valid executable must
be a file and have its executable bit set.
</p>
<p></p>
<p></p>
<p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5">
<TR><TD align="left" valign="top"><i>appname</i></TD><TD align="left" valign="top">The name of the executable file for which to search.
</TD></TR>
<TR><TD align="left" valign="top"><i>pathstr</i></TD><TD align="left" valign="top">The path which will be searched. If this is
0 (default), the $PATH environment variable will
be searched.
</TD></TR>
<TR><TD align="left" valign="top"><i>ignoreExecBit</i></TD><TD align="left" valign="top">If true, an existing file will be returned
even if its executable bit is not set.
</TD></TR>
</TABLE></P>
<p><b>Returns</b>: The path of the executable. If it was not found,
it will return QString::null.
</p>
<p><b>See also</b>: findAllExe()</p>
<A NAME="findAllExe"></A><A NAME="ref13"></A><table width="100%"><tr bgcolor="#eeeeee"><td> int <strong>findAllExe</strong> ( <A HREF="#QStringList">QStringList</A>& list, const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& appname,
const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& pathstr=QString::null,
bool ignoreExecBit=false )
<br></td><td align="right"><h3><strong>findAllExe</strong></h3></td></tr></table><p> <small>[static]</small></p><p>
Find all occurences of an executable in the system path.
</p>
<p></p>
<p></p>
<p></p>
<p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5">
<TR><TD align="left" valign="top"><i>list</i></TD><TD align="left" valign="top">Will be filled with the pathnames of all the
executables found. Will be empty if the executable
was not found.
</TD></TR>
<TR><TD align="left" valign="top"><i>appname</i></TD><TD align="left" valign="top">The name of the executable for which to
search.
</TD></TR>
<TR><TD align="left" valign="top"><i>pathstr</i></TD><TD align="left" valign="top">The path list which will be searched. If this
is 0 (default), the $PATH environment variable will
be searched.
</TD></TR>
<TR><TD align="left" valign="top"><i>ignoreExecBit</i></TD><TD align="left" valign="top">If true, an existing file will be returned
even if its executable bit is not set.
</TD></TR>
</TABLE></P>
<p><b>Returns</b>: The number of executables found, 0 if none were found.
</p>
<p><b>See also</b>: findExe()</p>
<A NAME="addKDEDefaults"></A><A NAME="ref14"></A><table width="100%"><tr bgcolor="#eeeeee"><td>void <strong>addKDEDefaults</strong> ()
<br></td><td align="right"><h3><strong>addKDEDefaults</strong></h3></td></tr></table><p></p><p>
This function adds the defaults that are used by the current
KDE version.
</p>
<p> It's a series of addResourceTypes()
and <A HREF="KStandardDirs.html#addPrefix">addPrefix</A>() calls.
You normally wouldn't call this function because it's called
for you from <A HREF="KGlobal.html">KGlobal</A>.
</p>
<A NAME="addCustomized"></A><A NAME="ref15"></A><table width="100%"><tr bgcolor="#eeeeee"><td>bool <strong>addCustomized</strong> (<A HREF="KConfig.html">KConfig</A> *config)
<br></td><td align="right"><h3><strong>addCustomized</strong></h3></td></tr></table><p></p><p>
Read customized entries out of the given config object and add
them via addResourceDirs().
</p>
<p></p>
<p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5">
<TR><TD align="left" valign="top"><i>config</i></TD><TD align="left" valign="top">The object the entries are read from. This should
contain global config files
</TD></TR>
</TABLE></P>
<p><b>Returns</b>: true if new config paths have been added
from <code>config</code>.
</p>
<A NAME="resourceDirs"></A><A NAME="ref16"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="#QStringList">QStringList</A> <strong>resourceDirs</strong> (const char *type)
<br></td><td align="right"><h3><strong>resourceDirs</strong></h3></td></tr></table><p> <small>[const]</small></p><p>
This function is used internally by almost all other function as
it serves and fills the directories cache.
</p>
<p></p>
<p><b>Returns</b>: The list of possible directories for the specified <code>type</code>.
The function updates the cache if possible. If the resource
type specified is unknown, it will return an empty list.
Note, that the directories are asured to exist beside the save
location, which may not exist, but is returned anyway.
</p>
<A NAME="allTypes"></A><A NAME="ref17"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="#QStringList">QStringList</A> <strong>allTypes</strong> ()
<br></td><td align="right"><h3><strong>allTypes</strong></h3></td></tr></table><p> <small>[const]</small></p><p>
This function will return a list of all the types that KStandardDirs
supports.
</p>
<p></p>
<p><b>Returns</b>: All types that KDE supports
</p>
<A NAME="saveLocation"></A><A NAME="ref18"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>saveLocation</strong> (const char *type,
const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& suffix = QString::null,
bool create = true)
<br></td><td align="right"><h3><strong>saveLocation</strong></h3></td></tr></table><p> <small>[const]</small></p><p>
Find a location to save files into for the given type
in the user's home directory.
</p>
<p></p>
<p></p>
<p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5">
<TR><TD align="left" valign="top"><i>suffix</i></TD><TD align="left" valign="top">A subdirectory name.
Makes it easier for you to create subdirectories.
You can't pass filenames here, you _have_ to pass
directory names only and add possible filename in
that directory yourself. A directory name always has a
trailing slash ('/').
</TD></TR>
<TR><TD align="left" valign="top"><i>create</i></TD><TD align="left" valign="top">If set, saveLocation() will create the directories
needed (including those given by <code>suffix</code>).
</TD></TR>
</TABLE></P>
<p><b>Returns</b>: A path where resources of the specified type should be
saved, or QString::null if the resource type is unknown.
</p>
<A NAME="makeDir"></A><A NAME="ref19"></A><table width="100%"><tr bgcolor="#eeeeee"><td> bool <strong>makeDir</strong> (const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A>& dir, int mode = 0755)
<br></td><td align="right"><h3><strong>makeDir</strong></h3></td></tr></table><p> <small>[static]</small></p><p>
Recursively create still-missing directories in the given path.
</p>
<p> The resulting permissions will depend on the current umask setting.
permission = mode & ~umask.
</p>
<p></p>
<p><b>Parameters</b>:<TABLE BORDER="0" CELLPADDING="5">
<TR><TD align="left" valign="top"><i>dir</i></TD><TD align="left" valign="top">Absolute path of the directory to be made.
</TD></TR>
<TR><TD align="left" valign="top"><i>mode</i></TD><TD align="left" valign="top">Directory permissions.
</TD></TR>
</TABLE></P>
<A NAME="kde_default"></A><A NAME="ref20"></A><table width="100%"><tr bgcolor="#eeeeee"><td> <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>kde_default</strong> (const char *type)
<br></td><td align="right"><h3><strong>kde_default</strong></h3></td></tr></table><p> <small>[static]</small></p><p>
This returns a default relative path for the standard KDE
resource types. Below is a list of them so you get an idea
of what this is all about.
</p>
<p></p>
<ul>
<li>data - share/apps
</li>
<li>html - share/doc/HTML
</li>
<li>icon - share/icon
</li>
<li>config - share/config
</li>
<li>pixmap - share/pixmaps
</li>
<li>apps - share/applnk
</li>
<li>sound - share/sounds
</li>
<li>locale - share/locale
</li>
<li>services - share/services
</li>
<li>servicetypes - share/servicetypes
</li>
<li>mime - share/mimelnk
</li>
<li>wallpaper - share/wallpapers
</li>
<li>templates - share/templates
</li>
<li>exe - bin
</li>
<li>lib - lib
</li>
</ul>
<p>
</p>
<p></p>
<p><b>Returns</b>: Static default for the specified resource. You
should probably be using <A HREF="#locate">locate</A>() or <A HREF="#locateLocal">locateLocal</A>()
instead.
</p>
<p><b>See also</b>: locate(), locateLocal()</p>
<A NAME="kfsstnd_prefixes"></A><A NAME="ref21"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>kfsstnd_prefixes</strong> ()
<br></td><td align="right"><h3><strong>kfsstnd_prefixes</strong></h3></td></tr></table><p></p><p>
</p>
<A NAME="localkdedir"></A><A NAME="ref22"></A><table width="100%"><tr bgcolor="#eeeeee"><td><A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> <strong>localkdedir</strong> ()
<br></td><td align="right"><h3><strong>localkdedir</strong></h3></td></tr></table><p> <small>[const]</small></p><p>
</p>
<p> Don't use this function if you can use locateLocal
</p>
<p><b>Returns</b>: the toplevel directory in which KStandardDirs
will store things. Most likely $HOME/.kde
</p>
<A NAME="exists"></A><A NAME="ref23"></A><table width="100%"><tr bgcolor="#eeeeee"><td> bool <strong>exists</strong> (const <A HREF="../../../../../../../../../usr/share/doc/qt-2.3.1/html/qstring.html">QString</A> &fullPath)
<br></td><td align="right"><h3><strong>exists</strong></h3></td></tr></table><p> <small>[static]</small></p><p>
checks for existance and accessability
faster than creating a QFileInfo first
</p>
<HR><UL><LI><i>Version</i>: $Id: kstddirs.h,v 1.79.2.1 2001/09/21 18:10:47 waba Exp $
</LI><LI><i>Author</i>: Stephan Kulow <coolo@kde.org> and Sirtaj Singh Kang <taj@kde.org>
</LI><LI><i>Generated</i>: qateam on updates.mandrakesoft.com on Mon Dec 30 16:08:56 2002, using kdoc 2.0a53.</LI></UL></BODY></HTML>
