<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="en_US" xml:lang="en_US">
<head>
<title>kdecore: KStandardDirs Class Reference (kdecore)</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta http-equiv="pics-label" content='(pics-1.1 "http://www.icra.org/ratingsv02.html" comment "ICRAonline DE v2.0" l gen true for "http://www.kde.org" r (nz 1 vz 1 lz 1 oz 1 cb 1) "http://www.rsac.org/ratingsv01.html" l gen true for "http://www.kde.org" r (n 0 s 0 v 0 l 0))' />
<meta name="trademark" content="KDE e.V." />
<meta name="description" content="K Desktop Environment Homepage, KDE.org" />
<meta name="MSSmartTagsPreventParsing" content="true" />
<meta name="robots" content="all" />
<link rel="shortcut icon" href="../../favicon.ico" />
<link rel="stylesheet" media="screen" type="text/css" title="APIDOX" href="doxygen.css" />
</head>
<body>
<div id="nav_header_top" align="right">
<a href="#content" class="doNotDisplay" accesskey="2">Skip to main content ::</a>
<a href="../.."><img id="nav_header_logo" alt="Home" align="left" src="../../kde_gear_64.png" border="0" /></a>
<span class="doNotDisplay">::</span>
<div id="nav_header_title" align="left">KDE API Reference</div>
</div>
<div id="nav_header_bottom" align="right">
<span class="doNotDisplay">:: <a href="#navigation" accesskey="5">Skip to Link Menu</a><br/></span>
<div id="nav_header_bottom_right" style="text-align: left;">
/ <a href="../..">API Reference</a>
/ <a href=".">kdecore</a>
</div>
</div>
<table id="main" border="0" cellpadding="0" cellspacing="0" width="100%">
<tr>
<td valign="top" class="menuheader" height="0"></td>
<td id="contentcolumn" valign="top" rowspan="2" >
<div id="content" style="padding-top: 0px;"><div style="width:100%; margin: 0px; padding: 0px;">
<a name="content"></a>
<!-- Generated by Doxygen 1.7.4 -->
</div>
<div class="header">
<div class="summary">
<a href="#pub-methods">Public Member Functions</a> |
<a href="#pub-static-methods">Static Public Member Functions</a> |
<a href="#related">Related Functions</a> </div>
<div class="headertitle">
<div class="title">KStandardDirs Class Reference</div> </div>
</div>
<div class="contents">
<!-- doxytag: class="KStandardDirs" -->
<p>Site-independent access to standard <a class="el" href="namespaceKDE.html" title="Namespace for general KDE functions.">KDE</a> directories.
<a href="classKStandardDirs.html#details">More...</a></p>
<p><code>#include <<a class="el" href="kstandarddirs_8h_source.html">kstandarddirs.h</a>></code></p>
<p><a href="classKStandardDirs-members.html">List of all members.</a></p>
<table class="memberdecls">
<tr><td colspan="2"><h2><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#a0dea59353fd7424bbfefc83764db1536">KStandardDirs</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#aa48bb206735aebb889a2bc1a06694e70">~KStandardDirs</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#ac64a8c771c14dd45a48eb3c26ce067b3">addPrefix</a> (const <a class="elRef" href="qstring.html">QString</a> &dir)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#a18e96ec891490006e9d38a6212ad6887">addXdgConfigPrefix</a> (const <a class="elRef" href="qstring.html">QString</a> &dir)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#ac841775774d70f9d1e3ad243d873ab59">addXdgDataPrefix</a> (const <a class="elRef" href="qstring.html">QString</a> &dir)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#a6e1ff3ff0615497351601fad3417151c">addResourceType</a> (const char *type, const <a class="elRef" href="qstring.html">QString</a> &relativename)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#a3db07fb1afea2bbe2b1136a4bd7f131e">addResourceDir</a> (const char *type, const <a class="elRef" href="qstring.html">QString</a> &absdir)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#adae97fe8f8a994938704cfa6b483c70a">findResource</a> (const char *type, const <a class="elRef" href="qstring.html">QString</a> &filename) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#a74602a8eb5dc48ca82d2baa21abb6ab3">isRestrictedResource</a> (const char *type, const <a class="elRef" href="qstring.html">QString</a> &relPath=QString::null) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">Q_UINT32 </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#a78c8d606d902a40bcd573f76f2d8b218">calcResourceHash</a> (const char *type, const <a class="elRef" href="qstring.html">QString</a> &filename, bool deep) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstringlist.html">QStringList</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#aa5fa59142fd9f1cfb28d631e0d1e1fc3">findDirs</a> (const char *type, const <a class="elRef" href="qstring.html">QString</a> &reldir) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#a5f8270da7537c26cd9d4e5f084c0f55a">findResourceDir</a> (const char *type, const <a class="elRef" href="qstring.html">QString</a> &filename) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstringlist.html">QStringList</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#ae6310facab4e97b2aceb5cf37080c3c0">findAllResources</a> (const char *type, const <a class="elRef" href="qstring.html">QString</a> &filter=QString::null, bool recursive=false, bool unique=false) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstringlist.html">QStringList</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#a5e41aebb0e58ed9770593220d4518c37">findAllResources</a> (const char *type, const <a class="elRef" href="qstring.html">QString</a> &filter, bool recursive, bool unique, <a class="elRef" href="qstringlist.html">QStringList</a> &relPaths) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#ab6c80dce964bfebe8da0307bbf4ec0ef">addKDEDefaults</a> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#acf3dd51e728058f85c41db12c3a23227">addCustomized</a> (<a class="el" href="classKConfig.html">KConfig</a> *config)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstringlist.html">QStringList</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#ab9c60e7d155beb6c273435ff409c7721">resourceDirs</a> (const char *type) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstringlist.html">QStringList</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#a6c8c05abd3428d85dc980ae4ba9279d3">allTypes</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#ac0f4d29ad29c1db30b2984d078e18fdc">saveLocation</a> (const char *type, const <a class="elRef" href="qstring.html">QString</a> &suffix=QString::null, bool create=true) const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#a2e1dac802f588a3dace78c2af14d0137">relativeLocation</a> (const char *type, const <a class="elRef" href="qstring.html">QString</a> &absPath)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a875022fd5f2a5d447b5288b8b74f6fcd"></a><!-- doxytag: member="KStandardDirs::kfsstnd_prefixes" ref="a875022fd5f2a5d447b5288b8b74f6fcd" args="()" -->
<a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><b>kfsstnd_prefixes</b> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ae78de37e4b005689df33a98b43b29b70"></a><!-- doxytag: member="KStandardDirs::kfsstnd_xdg_conf_prefixes" ref="ae78de37e4b005689df33a98b43b29b70" args="()" -->
<a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><b>kfsstnd_xdg_conf_prefixes</b> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ac03010577daba883e81ce1ccf61ac5f2"></a><!-- doxytag: member="KStandardDirs::kfsstnd_xdg_data_prefixes" ref="ac03010577daba883e81ce1ccf61ac5f2" args="()" -->
<a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><b>kfsstnd_xdg_data_prefixes</b> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#aa801bdec934b2d23e7e047fff1acd122">localkdedir</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#a70de1cc47b83512db8ae9f66cb9ab8dc">localxdgdatadir</a> () const </td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#a0f3ab8809bfdb7e60d2b0e481595d753">localxdgconfdir</a> () const </td></tr>
<tr><td colspan="2"><h2><a name="pub-static-methods"></a>
Static Public Member Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstringlist.html">QStringList</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#a2fbec0b1fb0278f106abefde5f5204e1">systemPaths</a> (const <a class="elRef" href="qstring.html">QString</a> &pstr=QString::null)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#acff5cb412926a454bcacc6849a4b4a7c">findExe</a> (const <a class="elRef" href="qstring.html">QString</a> &appname, const <a class="elRef" href="qstring.html">QString</a> &pathstr=QString::null, bool ignoreExecBit=false)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static int </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#a275565ac7c15a1e407146545d7edfe54">findAllExe</a> (<a class="elRef" href="qstringlist.html">QStringList</a> &list, const <a class="elRef" href="qstring.html">QString</a> &appname, const <a class="elRef" href="qstring.html">QString</a> &pathstr=QString::null, bool ignoreExecBit=false)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#a69a6cdd47b96c5183cdc2eb38d28d543">makeDir</a> (const <a class="elRef" href="qstring.html">QString</a> &dir, int mode=0755)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#a3f2eef83977134adf26ea2a6aacbdc59">kde_default</a> (const char *type)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a28e0783b83dcf9a2ec7a3595cbf7d4de"></a><!-- doxytag: member="KStandardDirs::kfsstnd_defaultprefix" ref="a28e0783b83dcf9a2ec7a3595cbf7d4de" args="()" -->
static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><b>kfsstnd_defaultprefix</b> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="adef25e27e8d2f44f1dd3841ff089df95"></a><!-- doxytag: member="KStandardDirs::kfsstnd_defaultbindir" ref="adef25e27e8d2f44f1dd3841ff089df95" args="()" -->
static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><b>kfsstnd_defaultbindir</b> ()</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static bool </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#a34bcd336fe58ada146805ce2ad0f3dfa">exists</a> (const <a class="elRef" href="qstring.html">QString</a> &fullPath)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#ac6832b607fb745a61ade8d5ba55c5efd">realPath</a> (const <a class="elRef" href="qstring.html">QString</a> &dirname)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classKStandardDirs.html#acfdf6be6d56bbe6f55bca1b8c4038df3">realFilePath</a> (const <a class="elRef" href="qstring.html">QString</a> &filename)</td></tr>
<tr><td colspan="2"><h2><a name="related"></a>
Related Functions</h2></td></tr>
<tr><td class="ititle" colspan="2"><p>(Note that these are not member functions.) </p>
</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__locates.html#ga89fd87f617b688014a7b361ed36dcdf8">locate</a> (const char *type, const <a class="elRef" href="qstring.html">QString</a> &filename, const <a class="el" href="classKInstance.html">KInstance</a> *instance=KGlobal::instance())</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__locates.html#gaa61f4722cb5eb55a0661b5aec0bbb3fe">locateLocal</a> (const char *type, const <a class="elRef" href="qstring.html">QString</a> &filename, const <a class="el" href="classKInstance.html">KInstance</a> *instance=KGlobal::instance())</td></tr>
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="qstring.html">QString</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="group__locates.html#gaac74ea84046012b3ebc2a311474f9a65">locateLocal</a> (const char *type, const <a class="elRef" href="qstring.html">QString</a> &filename, bool createDir, const <a class="el" href="classKInstance.html">KInstance</a> *instance=KGlobal::instance())</td></tr>
</table>
<hr/><a name="details" id="details"></a><h2>Detailed Description</h2>
<div class="textblock"><p>Site-independent access to standard <a class="el" href="namespaceKDE.html" title="Namespace for general KDE functions.">KDE</a> directories. </p>
<dl class="author"><dt><b>Author:</b></dt><dd>Stephan Kulow <<a href="mailto:coolo@kde.org">coolo@kde.org</a>> and Sirtaj Singh Kang <<a href="mailto:taj@kde.org">taj@kde.org</a>></dd></dl>
<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 <a class="el" href="classKStandardDirs.html#adae97fe8f8a994938704cfa6b483c70a" title="Tries to find a resource in the following order:">KStandardDirs::findResource</a>("apps", "Home.desktop") to apply this knowledge to return /opt/kde/share/applnk/Home.desktop or <a class="el" href="group__locates.html#ga89fd87f617b688014a7b361ed36dcdf8">locate</a>("data", "kgame/background.jpg") to return /opt/kde/share/apps/kgame/background.jpg</p>
<p>The main idea behind <a class="el" href="classKStandardDirs.html" title="Site-independent access to standard KDE directories.">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 basically 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 class="el" href="classKStandardDirs.html" title="Site-independent access to standard KDE directories.">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><b>Standard resources that kdelibs allocates are:</b><br/>
</p>
<ul>
<li>apps - Applications menu (.desktop files). </li>
<li>cache - Cached information (e.g. favicons, web-pages) </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 class="el" href="classKStandardDirs.html#acff5cb412926a454bcacc6849a4b4a7c" title="Finds the executable in the system path.">findExe()</a> for a function that takes $PATH into account. </li>
<li>html - HTML documentation. </li>
<li>icon - Icons, see <a class="el" href="classKIconLoader.html" title="Iconloader for KDE.">KIconLoader</a>. </li>
<li>lib - Libraries. </li>
<li>locale - Translation files for <a class="el" href="classKLocale.html" title="KLocale provides support for country specific stuff like the national language.">KLocale</a>. </li>
<li>mime - Mime types. </li>
<li>module - Module (dynamically loaded library). </li>
<li>qtplugins - <a class="elRef" href="qt.html">Qt</a> plugins (dynamically loaded objects for <a class="elRef" href="qt.html">Qt</a>) </li>
<li>services - Services. </li>
<li>servicetypes - Service types. </li>
<li>scripts - Application scripting additions. </li>
<li>sound - Application sounds. </li>
<li>templates - Templates </li>
<li>wallpaper - Wallpapers. </li>
<li>tmp - Temporary files (specific for both current host and current user) </li>
<li>socket - UNIX Sockets (specific for both current host and current user) </li>
<li>emoticons - Emoticons themes (Since <a class="el" href="namespaceKDE.html" title="Namespace for general KDE functions.">KDE</a> 3.4)</li>
</ul>
<p>A type that is added by the class <a class="el" href="classKApplication.html" title="Controls and provides information to all KDE applications.">KApplication</a> 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 class="el" href="group__locates.html#ga89fd87f617b688014a7b361ed36dcdf8">locate</a>("data", "appname/filename") so you can also write <a class="el" href="group__locates.html#ga89fd87f617b688014a7b361ed36dcdf8">locate</a>("appdata", "filename") if your <a class="el" href="classKApplication.html" title="Controls and provides information to all KDE applications.">KApplication</a> instance is called "appname" (as set via KApplication's constructor or <a class="el" href="classKAboutData.html" title="This class is used to store information about a program.">KAboutData</a>, if you use the global <a class="el" href="classKStandardDirs.html" title="Site-independent access to standard KDE directories.">KStandardDirs</a> object <a class="el" href="classKGlobal.html#a431d05bf9a252475846c89769fbff8c1" title="Returns the application standard dirs object.">KGlobal::dirs()</a>). 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 class="el" href="group__locates.html#ga89fd87f617b688014a7b361ed36dcdf8">locate</a>("data", "appletname/filename").</p>
<p><b><a class="el" href="classKStandardDirs.html" title="Site-independent access to standard KDE directories.">KStandardDirs</a> supports the following environment variables:</b></p>
<ul>
<li>KDEDIRS: This may set an additional number of directory prefixes to search for resources. The directories should be separated 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>
<li>KDEROOTHOME: Like KDEHOME, but used for the root user. If KDEROOTHOME is not set it defaults to the .kde directory in the home directory of root, usually "/root/.kde". Note that the setting of $HOME is ignored in this case.</li>
</ul>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKGlobalSettings.html" title="Access the KDE global configuration.">KGlobalSettings</a> </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8h_source.html#l00125">125</a> of file <a class="el" href="kstandarddirs_8h_source.html">kstandarddirs.h</a>.</p>
</div><hr/><h2>Constructor & Destructor Documentation</h2>
<a class="anchor" id="a0dea59353fd7424bbfefc83764db1536"></a><!-- doxytag: member="KStandardDirs::KStandardDirs" ref="a0dea59353fd7424bbfefc83764db1536" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">KStandardDirs::KStandardDirs </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>KStandardDirs' constructor. </p>
<p>It just initializes the caches. </p>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l00109">109</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="aa48bb206735aebb889a2bc1a06694e70"></a><!-- doxytag: member="KStandardDirs::~KStandardDirs" ref="aa48bb206735aebb889a2bc1a06694e70" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">KStandardDirs::~KStandardDirs </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td><code> [virtual]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>KStandardDirs' destructor. </p>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l00119">119</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<hr/><h2>Member Function Documentation</h2>
<a class="anchor" id="acf3dd51e728058f85c41db12c3a23227"></a><!-- doxytag: member="KStandardDirs::addCustomized" ref="acf3dd51e728058f85c41db12c3a23227" args="(KConfig *config)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KStandardDirs::addCustomized </td>
<td>(</td>
<td class="paramtype"><a class="el" href="classKConfig.html">KConfig</a> * </td>
<td class="paramname"><em>config</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Reads customized entries out of the given config object and add them via addResourceDirs(). </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">config</td><td>The object the entries are read from. This should contain global config files </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if new config paths have been added from <code>config</code>. </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l01509">1509</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="ab6c80dce964bfebe8da0307bbf4ec0ef"></a><!-- doxytag: member="KStandardDirs::addKDEDefaults" ref="ab6c80dce964bfebe8da0307bbf4ec0ef" args="()" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KStandardDirs::addKDEDefaults </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This function adds the defaults that are used by the current <a class="el" href="namespaceKDE.html" title="Namespace for general KDE functions.">KDE</a> version. </p>
<p>It's a series of addResourceTypes() and <a class="el" href="classKStandardDirs.html#ac64a8c771c14dd45a48eb3c26ce067b3" title="Adds another search dir to front of the fsstnd list.">addPrefix()</a> calls. You normally wouldn't call this function because it's called for you from <a class="el" href="classKGlobal.html" title="Access to the KDE global objects.">KGlobal</a>. </p>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l01277">1277</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="ac64a8c771c14dd45a48eb3c26ce067b3"></a><!-- doxytag: member="KStandardDirs::addPrefix" ref="ac64a8c771c14dd45a48eb3c26ce067b3" args="(const QString &dir)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KStandardDirs::addPrefix </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>dir</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Adds another search dir to front of the <code>fsstnd</code> list. </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>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">dir</td><td>The directory to append relative paths to. </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l00181">181</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a3db07fb1afea2bbe2b1136a4bd7f131e"></a><!-- doxytag: member="KStandardDirs::addResourceDir" ref="a3db07fb1afea2bbe2b1136a4bd7f131e" args="(const char *type, const QString &absdir)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KStandardDirs::addResourceDir </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>absdir</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Adds 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>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">type</td><td>Specifies a short descriptive string to access files of this type. </td></tr>
<tr><td class="paramname">absdir</td><td>Points to directory where to look for this specific type. Non-existant directories may be saved but pruned. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if successful, false otherwise. </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l00287">287</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a6e1ff3ff0615497351601fad3417151c"></a><!-- doxytag: member="KStandardDirs::addResourceType" ref="a6e1ff3ff0615497351601fad3417151c" args="(const char *type, const QString &relativename)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KStandardDirs::addResourceType </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>relativename</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Adds 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 ( kde_default) are added by <a class="el" href="classKStandardDirs.html#ab6c80dce964bfebe8da0307bbf4ec0ef" title="This function adds the defaults that are used by the current KDE version.">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 <a class="el" href="classKGlobal.html#a431d05bf9a252475846c89769fbff8c1" title="Returns the application standard dirs object.">KGlobal::dirs()</a>->addResourceType("app_pics", "share/app/pics");</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">type</td><td>Specifies a short descriptive string to access files of this type. </td></tr>
<tr><td class="paramname">relativename</td><td>Specifies a directory relative to the root of the KFSSTND. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if successful, false otherwise. </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l00256">256</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a18e96ec891490006e9d38a6212ad6887"></a><!-- doxytag: member="KStandardDirs::addXdgConfigPrefix" ref="a18e96ec891490006e9d38a6212ad6887" args="(const QString &dir)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KStandardDirs::addXdgConfigPrefix </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>dir</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Adds another search dir to front of the XDG_CONFIG_XXX list of prefixes. </p>
<p>This prefix is only used for resources that start with "xdgconf-"</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">dir</td><td>The directory to append relative paths to. </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l00201">201</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="ac841775774d70f9d1e3ad243d873ab59"></a><!-- doxytag: member="KStandardDirs::addXdgDataPrefix" ref="ac841775774d70f9d1e3ad243d873ab59" args="(const QString &dir)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void KStandardDirs::addXdgDataPrefix </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>dir</em></td><td>)</td>
<td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Adds another search dir to front of the XDG_DATA_XXX list of prefixes. </p>
<p>This prefix is only used for resources that start with "xdgdata-"</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">dir</td><td>The directory to append relative paths to. </td></tr>
</table>
</dd>
</dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l00221">221</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a6c8c05abd3428d85dc980ae4ba9279d3"></a><!-- doxytag: member="KStandardDirs::allTypes" ref="a6c8c05abd3428d85dc980ae4ba9279d3" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstringlist.html">QStringList</a> KStandardDirs::allTypes </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This function will return a list of all the types that <a class="el" href="classKStandardDirs.html" title="Site-independent access to standard KDE directories.">KStandardDirs</a> supports. </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>All types that <a class="el" href="namespaceKDE.html" title="Namespace for general KDE functions.">KDE</a> supports </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l00158">158</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a78c8d606d902a40bcd573f76f2d8b218"></a><!-- doxytag: member="KStandardDirs::calcResourceHash" ref="a78c8d606d902a40bcd573f76f2d8b218" args="(const char *type, const QString &filename, bool deep) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">Q_UINT32 KStandardDirs::calcResourceHash </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>filename</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"><em>deep</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns a number that identifies this version of the resource. </p>
<p>When a change is made to the resource this number will change.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">type</td><td>The type of the wanted resource </td></tr>
<tr><td class="paramname">filename</td><td>A relative filename of the resource. </td></tr>
<tr><td class="paramname">deep</td><td>If true, all resources are taken into account otherwise only the one returned by <a class="el" href="classKStandardDirs.html#adae97fe8f8a994938704cfa6b483c70a" title="Tries to find a resource in the following order:">findResource()</a>.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A number identifying the current version of the resource. </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l00353">353</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a34bcd336fe58ada146805ce2ad0f3dfa"></a><!-- doxytag: member="KStandardDirs::exists" ref="a34bcd336fe58ada146805ce2ad0f3dfa" args="(const QString &fullPath)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KStandardDirs::exists </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>fullPath</em></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Checks for existence and accessability of a file or directory. </p>
<p>Faster than creating a <a class="elRef" href="qfileinfo.html">QFileInfo</a> first. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">fullPath</td><td>the path to check. IMPORTANT: must end with a slash if expected to be a directory (and no slash for a file, obviously). </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if the directory exists </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l00451">451</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a275565ac7c15a1e407146545d7edfe54"></a><!-- doxytag: member="KStandardDirs::findAllExe" ref="a275565ac7c15a1e407146545d7edfe54" args="(QStringList &list, const QString &appname, const QString &pathstr=QString::null, bool ignoreExecBit=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">int KStandardDirs::findAllExe </td>
<td>(</td>
<td class="paramtype"><a class="elRef" href="qstringlist.html">QStringList</a> & </td>
<td class="paramname"><em>list</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>appname</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>pathstr</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"><em>ignoreExecBit</em> = <code>false</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Finds all occurrences of an executable in the system path. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">list</td><td>Will be filled with the pathnames of all the executables found. Will be empty if the executable was not found. </td></tr>
<tr><td class="paramname">appname</td><td>The name of the executable for which to search. </td></tr>
<tr><td class="paramname">pathstr</td><td>The path list which will be searched. If this is 0 (default), the $PATH environment variable will be searched. </td></tr>
<tr><td class="paramname">ignoreExecBit</td><td>If true, an existing file will be returned even if its executable bit is not set.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The number of executables found, 0 if none were found.</dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKStandardDirs.html#acff5cb412926a454bcacc6849a4b4a7c" title="Finds the executable in the system path.">findExe()</a> </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l00969">969</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="ae6310facab4e97b2aceb5cf37080c3c0"></a><!-- doxytag: member="KStandardDirs::findAllResources" ref="ae6310facab4e97b2aceb5cf37080c3c0" args="(const char *type, const QString &filter=QString::null, bool recursive=false, bool unique=false) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstringlist.html">QStringList</a> KStandardDirs::findAllResources </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>filter</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"><em>recursive</em> = <code>false</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"><em>unique</em> = <code>false</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Tries 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>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">type</td><td>The type of resource to locate directories for. </td></tr>
<tr><td class="paramname">filter</td><td>Only accept filenames that fit to filter. The filter may consist of an optional directory and a <a class="elRef" href="qregexp.html">QRegExp</a> wildcard expression. E.g. "images\*.jpg". Use QString::null if you do not want a filter. </td></tr>
<tr><td class="paramname">recursive</td><td>Specifies if the function should decend into subdirectories. </td></tr>
<tr><td class="paramname">unique</td><td>If specified, only return items which have unique suffixes - suppressing duplicated filenames.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>List of all the files whose filename matches the specified filter. </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l00676">676</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a5e41aebb0e58ed9770593220d4518c37"></a><!-- doxytag: member="KStandardDirs::findAllResources" ref="a5e41aebb0e58ed9770593220d4518c37" args="(const char *type, const QString &filter, bool recursive, bool unique, QStringList &relPaths) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstringlist.html">QStringList</a> KStandardDirs::findAllResources </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>filter</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"><em>recursive</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"><em>unique</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype"><a class="elRef" href="qstringlist.html">QStringList</a> & </td>
<td class="paramname"><em>relPaths</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Tries 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>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">type</td><td>The type of resource to locate directories for. </td></tr>
<tr><td class="paramname">filter</td><td>Only accept filenames that fit to filter. The filter may consist of an optional directory and a <a class="elRef" href="qregexp.html">QRegExp</a> wildcard expression. E.g. "images\*.jpg". Use QString::null if you do not want a filter. </td></tr>
<tr><td class="paramname">recursive</td><td>Specifies if the function should decend into subdirectories. </td></tr>
<tr><td class="paramname">unique</td><td>If specified, only return items which have unique suffixes. </td></tr>
<tr><td class="paramname">relPaths</td><td>The list to store the relative paths into These can be used later to <a class="el" href="group__locates.html#ga89fd87f617b688014a7b361ed36dcdf8">locate()</a> the file</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>List of all the files whose filename matches the specified filter. </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l00620">620</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="aa5fa59142fd9f1cfb28d631e0d1e1fc3"></a><!-- doxytag: member="KStandardDirs::findDirs" ref="aa5fa59142fd9f1cfb28d631e0d1e1fc3" args="(const char *type, const QString &reldir) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstringlist.html">QStringList</a> KStandardDirs::findDirs </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>reldir</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Tries to find all directories whose names consist of the specified type and a relative path. </p>
<p>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>Note that it appends / to the end of the directories, so you can use this right away as directory names.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">type</td><td>The type of the base directory. </td></tr>
<tr><td class="paramname">reldir</td><td>Relative directory.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A list of matching directories, or an empty list if the resource specified is not found. </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l00379">379</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="acff5cb412926a454bcacc6849a4b4a7c"></a><!-- doxytag: member="KStandardDirs::findExe" ref="acff5cb412926a454bcacc6849a4b4a7c" args="(const QString &appname, const QString &pathstr=QString::null, bool ignoreExecBit=false)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStandardDirs::findExe </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>appname</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>pathstr</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"><em>ignoreExecBit</em> = <code>false</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Finds the executable in the system path. </p>
<p>A valid executable must be a file and have its executable bit set.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">appname</td><td>The name of the executable file for which to search. </td></tr>
<tr><td class="paramname">pathstr</td><td>The path which will be searched. If this is null (default), the $PATH environment variable will be searched. </td></tr>
<tr><td class="paramname">ignoreExecBit</td><td>If true, an existing file will be returned even if its executable bit is not set.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>The path of the executable. If it was not found, it will return QString::null. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classKStandardDirs.html#a275565ac7c15a1e407146545d7edfe54" title="Finds all occurrences of an executable in the system path.">findAllExe()</a> </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l00920">920</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="adae97fe8f8a994938704cfa6b483c70a"></a><!-- doxytag: member="KStandardDirs::findResource" ref="adae97fe8f8a994938704cfa6b483c70a" args="(const char *type, const QString &filename) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStandardDirs::findResource </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>filename</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Tries to find a 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>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"). <a class="el" href="classKStandardDirs.html" title="Site-independent access to standard KDE directories.">KStandardDirs</a> 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>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">type</td><td>The type of the wanted resource </td></tr>
<tr><td class="paramname">filename</td><td>A relative filename of the resource.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A full path to the filename specified in the second argument, or QString::null if not found. </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l00318">318</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a5f8270da7537c26cd9d4e5f084c0f55a"></a><!-- doxytag: member="KStandardDirs::findResourceDir" ref="a5f8270da7537c26cd9d4e5f084c0f55a" args="(const char *type, const QString &filename) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStandardDirs::findResourceDir </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>filename</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Tries to find the directory the file is in. </p>
<p>It works the same as <a class="el" href="classKStandardDirs.html#adae97fe8f8a994938704cfa6b483c70a" title="Tries to find a resource in the following order:">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>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">type</td><td>The type of the wanted resource </td></tr>
<tr><td class="paramname">filename</td><td>A relative filename of the resource. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>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. </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l00413">413</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a74602a8eb5dc48ca82d2baa21abb6ab3"></a><!-- doxytag: member="KStandardDirs::isRestrictedResource" ref="a74602a8eb5dc48ca82d2baa21abb6ab3" args="(const char *type, const QString &relPath=QString::null) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KStandardDirs::isRestrictedResource </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>relPath</em> = <code>QString::null</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Checks whether a resource is restricted as part of the KIOSK framework. </p>
<p>When a resource is restricted it means that user- specific files in the resource are ignored.</p>
<p>E.g. by restricting the "wallpaper" resource, only system-wide installed wallpapers will be found by this class. Wallpapers installed under the $KDEHOME directory will be ignored.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">type</td><td>The type of the resource to check </td></tr>
<tr><td class="paramname">relPath</td><td>A relative path in the resource.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>True if the resource is restricted. </dd></dl>
<dl class="since"><dt><b>Since:</b></dt><dd>3.1 </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l00124">124</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a3f2eef83977134adf26ea2a6aacbdc59"></a><!-- doxytag: member="KStandardDirs::kde_default" ref="a3f2eef83977134adf26ea2a6aacbdc59" args="(const char *type)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStandardDirs::kde_default </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>type</em></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This returns a default relative path for the standard <a class="el" href="namespaceKDE.html" title="Namespace for general KDE functions.">KDE</a> resource types. </p>
<p>Below is a list of them so you get an idea of what this is all about.</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>
<dl class="return"><dt><b>Returns:</b></dt><dd>Static default for the specified resource. You should probably be using <a class="el" href="group__locates.html#ga89fd87f617b688014a7b361ed36dcdf8">locate()</a> or <a class="el" href="group__locates.html#gaa61f4722cb5eb55a0661b5aec0bbb3fe">locateLocal()</a> instead. </dd></dl>
<dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="group__locates.html#ga89fd87f617b688014a7b361ed36dcdf8">locate()</a> </dd>
<dd>
<a class="el" href="group__locates.html#gaa61f4722cb5eb55a0661b5aec0bbb3fe">locateLocal()</a> </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l01024">1024</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="aa801bdec934b2d23e7e047fff1acd122"></a><!-- doxytag: member="KStandardDirs::localkdedir" ref="aa801bdec934b2d23e7e047fff1acd122" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStandardDirs::localkdedir </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns the toplevel directory in which <a class="el" href="classKStandardDirs.html" title="Site-independent access to standard KDE directories.">KStandardDirs</a> will store things. </p>
<p>Most likely $HOME/.kde Don't use this function if you can use locateLocal </p>
<dl class="return"><dt><b>Returns:</b></dt><dd>the toplevel directory </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l01641">1641</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a0f3ab8809bfdb7e60d2b0e481595d753"></a><!-- doxytag: member="KStandardDirs::localxdgconfdir" ref="a0f3ab8809bfdb7e60d2b0e481595d753" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStandardDirs::localxdgconfdir </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<dl class="return"><dt><b>Returns:</b></dt><dd>$XDG_CONFIG_HOME See also <a href="http://www.freedesktop.org/standards/basedir/draft/basedir-spec/basedir-spec.html">http://www.freedesktop.org/standards/basedir/draft/basedir-spec/basedir-spec.html</a> </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l01653">1653</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a70de1cc47b83512db8ae9f66cb9ab8dc"></a><!-- doxytag: member="KStandardDirs::localxdgdatadir" ref="a70de1cc47b83512db8ae9f66cb9ab8dc" args="() const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStandardDirs::localxdgdatadir </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<dl class="return"><dt><b>Returns:</b></dt><dd>$XDG_DATA_HOME See also <a href="http://www.freedesktop.org/standards/basedir/draft/basedir-spec/basedir-spec.html">http://www.freedesktop.org/standards/basedir/draft/basedir-spec/basedir-spec.html</a> </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l01647">1647</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a69a6cdd47b96c5183cdc2eb38d28d543"></a><!-- doxytag: member="KStandardDirs::makeDir" ref="a69a6cdd47b96c5183cdc2eb38d28d543" args="(const QString &dir, int mode=0755)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">bool KStandardDirs::makeDir </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>dir</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">int </td>
<td class="paramname"><em>mode</em> = <code>0755</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Recursively creates still-missing directories in the given path. </p>
<p>The resulting permissions will depend on the current umask setting. permission = mode & ~umask.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">dir</td><td>Absolute path of the directory to be made. </td></tr>
<tr><td class="paramname">mode</td><td>Directory permissions. </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>true if successful, false otherwise </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l01160">1160</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="acfdf6be6d56bbe6f55bca1b8c4038df3"></a><!-- doxytag: member="KStandardDirs::realFilePath" ref="acfdf6be6d56bbe6f55bca1b8c4038df3" args="(const QString &filename)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStandardDirs::realFilePath </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>filename</em></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Expands all symbolic links and resolves references to '/. </p>
<p>/', '/../' and extra '/' characters in <code>filename</code> and returns the canonicalized absolute pathname. The resulting path will have no symbolic link, '/./' or '/../' components. </p>
<dl class="since"><dt><b>Since:</b></dt><dd>3.4 </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l00704">704</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="ac6832b607fb745a61ade8d5ba55c5efd"></a><!-- doxytag: member="KStandardDirs::realPath" ref="ac6832b607fb745a61ade8d5ba55c5efd" args="(const QString &dirname)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStandardDirs::realPath </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>dirname</em></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Expands all symbolic links and resolves references to '/. </p>
<p>/', '/../' and extra '/' characters in <code>dirname</code> and returns the canonicalized absolute pathname. The resulting path will have no symbolic link, '/./' or '/../' components. </p>
<dl class="since"><dt><b>Since:</b></dt><dd>3.1 </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l00686">686</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a2e1dac802f588a3dace78c2af14d0137"></a><!-- doxytag: member="KStandardDirs::relativeLocation" ref="a2e1dac802f588a3dace78c2af14d0137" args="(const char *type, const QString &absPath)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStandardDirs::relativeLocation </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>absPath</em> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Converts an absolute path to a path relative to a certain resource. </p>
<p>If "abs = ::locate(resource, rel)" then "rel = relativeLocation(resource, abs)" and vice versa.</p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">type</td><td>The type of resource.</td></tr>
<tr><td class="paramname">absPath</td><td>An absolute path to make relative.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A relative path relative to resource <code>type</code> that will find <code>absPath</code>. If no such relative path exists, absPath will be returned unchanged. </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l01138">1138</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="ab9c60e7d155beb6c273435ff409c7721"></a><!-- doxytag: member="KStandardDirs::resourceDirs" ref="ab9c60e7d155beb6c273435ff409c7721" args="(const char *type) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstringlist.html">QStringList</a> KStandardDirs::resourceDirs </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>type</em></td><td>)</td>
<td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>This function is used internally by almost all other function as it serves and fills the directories cache. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">type</td><td>The type of resource </td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>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 assured to exist beside the save location, which may not exist, but is returned anyway. </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l00783">783</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="ac0f4d29ad29c1db30b2984d078e18fdc"></a><!-- doxytag: member="KStandardDirs::saveLocation" ref="ac0f4d29ad29c1db30b2984d078e18fdc" args="(const char *type, const QString &suffix=QString::null, bool create=true) const " -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstring.html">QString</a> KStandardDirs::saveLocation </td>
<td>(</td>
<td class="paramtype">const char * </td>
<td class="paramname"><em>type</em>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>suffix</em> = <code>QString::null</code>, </td>
</tr>
<tr>
<td class="paramkey"></td>
<td></td>
<td class="paramtype">bool </td>
<td class="paramname"><em>create</em> = <code>true</code> </td>
</tr>
<tr>
<td></td>
<td>)</td>
<td></td><td> const</td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Finds a location to save files into for the given type in the user's home directory. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">type</td><td>The type of location to return. </td></tr>
<tr><td class="paramname">suffix</td><td>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 class="paramname">create</td><td>If set, <a class="el" href="classKStandardDirs.html#ac0f4d29ad29c1db30b2984d078e18fdc" title="Finds a location to save files into for the given type in the user's home directory.">saveLocation()</a> will create the directories needed (including those given by <code>suffix</code>).</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>A path where resources of the specified type should be saved, or QString::null if the resource type is unknown. </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l01081">1081</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<a class="anchor" id="a2fbec0b1fb0278f106abefde5f5204e1"></a><!-- doxytag: member="KStandardDirs::systemPaths" ref="a2fbec0b1fb0278f106abefde5f5204e1" args="(const QString &pstr=QString::null)" -->
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname"><a class="elRef" href="qstringlist.html">QStringList</a> KStandardDirs::systemPaths </td>
<td>(</td>
<td class="paramtype">const <a class="elRef" href="qstring.html">QString</a> & </td>
<td class="paramname"><em>pstr</em> = <code>QString::null</code></td><td>)</td>
<td><code> [static]</code></td>
</tr>
</table>
</div>
<div class="memdoc">
<p>Returns a <a class="elRef" href="qstringlist.html">QStringList</a> list of pathnames in the system path. </p>
<dl><dt><b>Parameters:</b></dt><dd>
<table class="params">
<tr><td class="paramname">pstr</td><td>The path which will be searched. If this is null (default), the $PATH environment variable will be searched.</td></tr>
</table>
</dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>a <a class="elRef" href="qstringlist.html">QStringList</a> list of pathnames in the system path. </dd></dl>
<p>Definition at line <a class="el" href="kstandarddirs_8cpp_source.html#l00874">874</a> of file <a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a>.</p>
</div>
</div>
<hr/>The documentation for this class was generated from the following files:<ul>
<li><a class="el" href="kstandarddirs_8h_source.html">kstandarddirs.h</a></li>
<li><a class="el" href="kstandarddirs_8cpp_source.html">kstandarddirs.cpp</a></li>
</ul>
</div>
</div></div>
</td>
</tr>
<tr>
<td valign="top" id="leftmenu" width="25%">
<a name="navigation"></a>
<div class="menu_box"><h2>kdecore</h2>
<div class="nav_list">
<ul><li><a href="index.html">Main Page</a></li><li><a href="modules.html">Modules</a></li><li><a href="namespaces.html">Namespace List</a></li><li><a href="hierarchy.html">Class Hierarchy</a></li><li><a href="classes.html">Alphabetical List</a></li><li><a href="annotated.html">Class List</a></li><li><a href="files.html">File List</a></li><li><a href="namespacemembers.html">Namespace Members</a></li><li><a href="functions.html">Class Members</a></li><li><a href="pages.html">Related Pages</a></li></ul>
<!--
<h2>Class Picker</h2>
<div style="text-align: center;">
<form name="guideform">
<select name="guidelinks" style="width:100%;" onChange="window.location=document.guideform.guidelinks.options[document.guideform.guidelinks.selectedIndex].value">
<option value="annotated.html">-- Choose --</option>
<option value="classKAboutData.html">kaboutdata</option>, <option value="classKAboutPerson.html">kaboutperson</option>, <option value="classKAboutTranslator.html">kabouttranslator</option>, <option value="classKAccel.html">kaccel</option>, <option value="classKAcceleratorManager.html">kacceleratormanager</option>, <option value="classKAccelManagerAlgorithm.html">kaccelmanageralgorithm</option>, <option value="classKAccelShortcutList.html">kaccelshortcutlist</option>, <option value="classKAccelString.html">kaccelstring</option>, <option value="classKAddressInfo.html">kaddressinfo</option>, <option value="classKAppDCOPInterface.html">kappdcopinterface</option>, <option value="classKApplication.html">kapplication</option>, <option value="classKAsyncIO.html">kasyncio</option>, <option value="classKAudioPlayer.html">kaudioplayer</option>, <option value="classKBufferedIO.html">kbufferedio</option>, <option value="classKCalendarSystem.html">kcalendarsystem</option>, <option value="classKCalendarSystemFactory.html">kcalendarsystemfactory</option>, <option value="classKCalendarSystemJalali.html">kcalendarsystemjalali</option>, <option value="classKCatalogue.html">kcatalogue</option>, <option value="classKCharMacroExpander.html">kcharmacroexpander</option>, <option value="classKCharsets.html">kcharsets</option>, <option value="classKClipboardSynchronizer.html">kclipboardsynchronizer</option>, <option value="classKCmdLineArgs.html">kcmdlineargs</option>, <option value="classKCodecs.html">kcodecs</option>, <option value="classKCompletion.html">kcompletion</option>, <option value="classKCompletionBase.html">kcompletionbase</option>, <option value="classKCompletionMatches.html">kcompletionmatches</option>, <option value="classKCompTreeNode.html">kcomptreenode</option>, <option value="classKConfig.html">kconfig</option>, <option value="classKConfigBackEnd.html">kconfigbackend</option>, <option value="classKConfigBase.html">kconfigbase</option>, <option value="classKConfigDialogManager.html">kconfigdialogmanager</option>, <option value="classKConfigGroup.html">kconfiggroup</option>, <option value="classKConfigGroupSaver.html">kconfiggroupsaver</option>, <option value="classKConfigINIBackEnd.html">kconfiginibackend</option>, <option value="classKConfigSkeleton.html">kconfigskeleton</option>, <option value="classKConfigSkeleton_1_1ItemBool.html">kconfigskeleton::itembool</option>, <option value="classKConfigSkeleton_1_1ItemColor.html">kconfigskeleton::itemcolor</option>, <option value="classKConfigSkeleton_1_1ItemDateTime.html">kconfigskeleton::itemdatetime</option>, <option value="classKConfigSkeleton_1_1ItemDouble.html">kconfigskeleton::itemdouble</option>, <option value="classKConfigSkeleton_1_1ItemEnum.html">kconfigskeleton::itemenum</option>, <option value="classKConfigSkeleton_1_1ItemFont.html">kconfigskeleton::itemfont</option>, <option value="classKConfigSkeleton_1_1ItemInt.html">kconfigskeleton::itemint</option>, <option value="classKConfigSkeleton_1_1ItemInt64.html">kconfigskeleton::itemint64</option>, <option value="classKConfigSkeleton_1_1ItemIntList.html">kconfigskeleton::itemintlist</option>, <option value="classKConfigSkeleton_1_1ItemLong.html">kconfigskeleton::itemlong</option>, <option value="classKConfigSkeleton_1_1ItemPassword.html">kconfigskeleton::itempassword</option>, <option value="classKConfigSkeleton_1_1ItemPath.html">kconfigskeleton::itempath</option>, <option value="classKConfigSkeleton_1_1ItemPathList.html">kconfigskeleton::itempathlist</option>, <option value="classKConfigSkeleton_1_1ItemPoint.html">kconfigskeleton::itempoint</option>, <option value="classKConfigSkeleton_1_1ItemProperty.html">kconfigskeleton::itemproperty</option>, <option value="classKConfigSkeleton_1_1ItemRect.html">kconfigskeleton::itemrect</option>, <option value="classKConfigSkeleton_1_1ItemSize.html">kconfigskeleton::itemsize</option>, <option value="classKConfigSkeleton_1_1ItemString.html">kconfigskeleton::itemstring</option>, <option value="classKConfigSkeleton_1_1ItemStringList.html">kconfigskeleton::itemstringlist</option>, <option value="classKConfigSkeleton_1_1ItemUInt.html">kconfigskeleton::itemuint</option>, <option value="classKConfigSkeleton_1_1ItemUInt64.html">kconfigskeleton::itemuint64</option>, <option value="classKConfigSkeleton_1_1ItemULong.html">kconfigskeleton::itemulong</option>, <option value="classKConfigSkeletonItem.html">kconfigskeletonitem</option>, <option value="classKCrash.html">kcrash</option>, <option value="classKDCOPPropertyProxy.html">kdcoppropertyproxy</option>, <option value="classKDebugDCOPIface.html">kdebugdcopiface</option>, <option value="classKDesktopFile.html">kdesktopfile</option>, <option value="classKExtendedSocket.html">kextendedsocket</option>, <option value="classKGenericFactory.html">kgenericfactory</option>, <option value="classKGenericFactory_3_01KTypeList_3_01Product_00_01ProductListTail_01_4_00_01KTypeList_3_01Pare1ed8d1e5a9847c99711cad3b12c7e96c.html">kgenericfactory< ktypelist< product, productlisttail >, ktypelist< pare1ed8d1e5a9847c99711cad3b12c7e96c</option>, <option value="classKGenericFactory_3_01KTypeList_3_01Product_00_01ProductListTail_01_4_00_01KTypeList_3_01Paref6a00f76851e0daa2cb662bb8a41fc7f.html">kgenericfactory< ktypelist< product, productlisttail >, ktypelist< paref6a00f76851e0daa2cb662bb8a41fc7f</option>, <option value="classKGenericFactory_3_01KTypeList_3_01Product_00_01ProductListTail_01_4_00_01QObject_01_4.html">kgenericfactory< ktypelist< product, productlisttail >, qobject ></option>, <option value="classKGlobal.html">kglobal</option>, <option value="classKGlobalAccel.html">kglobalaccel</option>, <option value="classKGlobalSettings.html">kglobalsettings</option>, <option value="classKIcon.html">kicon</option>, <option value="classKIconEffect.html">kiconeffect</option>, <option value="classKIconLoader.html">kiconloader</option>, <option value="classKIconTheme.html">kicontheme</option>, <option value="classKInetSocketAddress.html">kinetsocketaddress</option>, <option value="classKInstance.html">kinstance</option>, <option value="classKIOBufferBase.html">kiobufferbase</option>, <option value="classKIPC.html">kipc</option>, <option value="classKKey.html">kkey</option>, <option value="classKKeyNative.html">kkeynative</option>, <option value="classKKeySequence.html">kkeysequence</option>, <option value="classKLibFactory.html">klibfactory</option>, <option value="classKLibLoader.html">klibloader</option>, <option value="classKLibrary.html">klibrary</option>, <option value="classKLocale.html">klocale</option>, <option value="classKLockFile.html">klockfile</option>, <option value="classKMacroExpanderBase.html">kmacroexpanderbase</option>, <option value="classKMD4.html">kmd4</option>, <option value="classKMD5.html">kmd5</option>, <option value="classKMimeSourceFactory.html">kmimesourcefactory</option>, <option value="classKMountPoint.html">kmountpoint</option>, <option value="classKMultipleDrag.html">kmultipledrag</option>, <option value="classKNetwork_1_1KActiveSocketBase.html">knetwork::kactivesocketbase</option>, <option value="classKNetwork_1_1KBufferedSocket.html">knetwork::kbufferedsocket</option>, <option value="classKNetwork_1_1KClientSocketBase.html">knetwork::kclientsocketbase</option>, <option value="classKNetwork_1_1KDatagramPacket.html">knetwork::kdatagrampacket</option>, <option value="classKNetwork_1_1KDatagramSocket.html">knetwork::kdatagramsocket</option>, <option value="classKNetwork_1_1KHttpProxySocketDevice.html">knetwork::khttpproxysocketdevice</option>, <option value="classKNetwork_1_1KInetSocketAddress.html">knetwork::kinetsocketaddress</option>, <option value="classKNetwork_1_1KIpAddress.html">knetwork::kipaddress</option>, <option value="classKNetwork_1_1KMulticastSocket.html">knetwork::kmulticastsocket</option>, <option value="classKNetwork_1_1KMulticastSocketImpl.html">knetwork::kmulticastsocketimpl</option>, <option value="classKNetwork_1_1KNetworkInterface.html">knetwork::knetworkinterface</option>, <option value="classKNetwork_1_1KPassiveSocketBase.html">knetwork::kpassivesocketbase</option>, <option value="classKNetwork_1_1KResolver.html">knetwork::kresolver</option>, <option value="classKNetwork_1_1KResolverEntry.html">knetwork::kresolverentry</option>, <option value="classKNetwork_1_1KResolverResults.html">knetwork::kresolverresults</option>, <option value="classKNetwork_1_1KResolverWorkerBase_1_1ResolverLocker.html">knetwork::kresolverworkerbase::resolverlocker</option>, <option value="classKNetwork_1_1KReverseResolver.html">knetwork::kreverseresolver</option>, <option value="classKNetwork_1_1KServerSocket.html">knetwork::kserversocket</option>, <option value="classKNetwork_1_1KSocketAddress.html">knetwork::ksocketaddress</option>, <option value="classKNetwork_1_1KSocketBase.html">knetwork::ksocketbase</option>, <option value="classKNetwork_1_1KSocketDevice.html">knetwork::ksocketdevice</option>, <option value="classKNetwork_1_1KSocketDeviceFactory.html">knetwork::ksocketdevicefactory</option>, <option value="classKNetwork_1_1KSocksSocketDevice.html">knetwork::ksockssocketdevice</option>, <option value="classKNetwork_1_1KStreamSocket.html">knetwork::kstreamsocket</option>, <option value="classKNetwork_1_1KUnixSocketAddress.html">knetwork::kunixsocketaddress</option>, <option value="classKNotifyClient_1_1Instance.html">knotifyclient::instance</option>, <option value="classKPalette.html">kpalette</option>, <option value="classKPixmapProvider.html">kpixmapprovider</option>, <option value="classKPopupAccelManager.html">kpopupaccelmanager</option>, <option value="classKProcess.html">kprocess</option>, <option value="classKProcessController.html">kprocesscontroller</option>, <option value="classKProcIO.html">kprocio</option>, <option value="classKProtocolInfoFactory.html">kprotocolinfofactory</option>, <option value="classKPty.html">kpty</option>, <option value="classKRandomSequence.html">krandomsequence</option>, <option value="classKRegExp.html">kregexp</option>, <option value="classKRegExpPrivate.html">kregexpprivate</option>, <option value="classKRFCDate.html">krfcdate</option>, <option value="classKRootProp.html">krootprop</option>, <option value="classKSaveFile.html">ksavefile</option>, <option value="classKServerSocket.html">kserversocket</option>, <option value="classKSessionManaged.html">ksessionmanaged</option>, <option value="classKShared.html">kshared</option>, <option value="classKSharedConfig.html">ksharedconfig</option>, <option value="classKSharedPtr.html">ksharedptr</option>, <option value="classKShellProcess.html">kshellprocess</option>, <option value="classKShortcut.html">kshortcut</option>, <option value="classKShortcutList.html">kshortcutlist</option>, <option value="classKSimpleConfig.html">ksimpleconfig</option>, <option value="classKSocket.html">ksocket</option>, <option value="classKSocketAddress.html">ksocketaddress</option>, <option value="classKSocks.html">ksocks</option>, <option value="classKSortableItem.html">ksortableitem</option>, <option value="classKSortableValueList.html">ksortablevaluelist</option>, <option value="classKStandardDirs.html">kstandarddirs</option>, <option value="classKStaticDeleter.html">kstaticdeleter</option>, <option value="classKStaticDeleterBase.html">kstaticdeleterbase</option>, <option value="classKStdAccel_1_1ShortcutList.html">kstdaccel::shortcutlist</option>, <option value="classKStringHandler.html">kstringhandler</option>, <option value="classKSycocaEntry.html">ksycocaentry</option>, <option value="classKSycocaFactoryList.html">ksycocafactorylist</option>, <option value="classKTempDir.html">ktempdir</option>, <option value="classKTempFile.html">ktempfile</option>, <option value="classKTimezone.html">ktimezone</option>, <option value="classKTimezoneDetails.html">ktimezonedetails</option>, <option value="classKTimezones.html">ktimezones</option>, <option value="classKTimezoneSource.html">ktimezonesource</option>, <option value="classKUniqueApplication.html">kuniqueapplication</option>, <option value="classKUnixSocketAddress.html">kunixsocketaddress</option>, <option value="classKURL.html">kurl</option>, <option value="classKURL_1_1List.html">kurl::list</option>, <option value="classKURLDrag.html">kurldrag</option>, <option value="classKUser.html">kuser</option>, <option value="classKUserGroup.html">kusergroup</option>, <option value="classKVMAllocator.html">kvmallocator</option>, <option value="classKWin.html">kwin</option>, <option value="classKWin_1_1WindowInfo.html">kwin::windowinfo</option>, <option value="classKWinModule.html">kwinmodule</option>, <option value="classKWordMacroExpander.html">kwordmacroexpander</option>, <option value="classKXErrorHandler.html">kxerrorhandler</option>, <option value="classKZoneAllocator.html">kzoneallocator</option>, <option value="classNET.html">net</option>,
</select>
</form>
</div>
-->
</div></div>
<div class="menu_box"><h2>API Dox</h2>
<div class="nav_list">
<ul>
<li><a href="../../arts/html/index.html">arts</a></li><li><a href="../../dcop/html/index.html">dcop</a></li><li><a href="../../dnssd/html/index.html">dnssd</a></li><li><a href="../../interfaces/html/index.html">interfaces</a></li><li> <a href="../../interfaces/kimproxy/interface/html/index.html">interface</a></li><li> <a href="../../interfaces/kimproxy/library/html/index.html">library</a></li><li> <a href="../../interfaces/kspeech/html/index.html">kspeech</a></li><li> <a href="../../interfaces/ktexteditor/html/index.html">ktexteditor</a></li><li><a href="../../kabc/html/index.html">kabc</a></li><li><a href="../../kate/html/index.html">kate</a></li><li><a href="../../kcmshell/html/index.html">kcmshell</a></li><li><a href="../../kdecore/html/index.html">kdecore</a></li><li><a href="../../kded/html/index.html">kded</a></li><li><a href="../../kdefx/html/index.html">kdefx</a></li><li><a href="../../kdeprint/html/index.html">kdeprint</a></li><li><a href="../../kdesu/html/index.html">kdesu</a></li><li><a href="../../kdeui/html/index.html">kdeui</a></li><li><a href="../../kdoctools/html/index.html">kdoctools</a></li><li><a href="../../khtml/html/index.html">khtml</a></li><li><a href="../../kimgio/html/index.html">kimgio</a></li><li><a href="../../kinit/html/index.html">kinit</a></li><li><a href="../../kio/html/index.html">kio</a></li><li> <a href="../../kio/bookmarks/html/index.html">bookmarks</a></li><li> <a href="../../kio/httpfilter/html/index.html">httpfilter</a></li><li> <a href="../../kio/kfile/html/index.html">kfile</a></li><li> <a href="../../kio/kio/html/index.html">kio</a></li><li> <a href="../../kio/kioexec/html/index.html">kioexec</a></li><li> <a href="../../kio/kpasswdserver/html/index.html">kpasswdserver</a></li><li> <a href="../../kio/kssl/html/index.html">kssl</a></li><li><a href="../../kioslave/html/index.html">kioslave</a></li><li> <a href="../../kioslave/http/html/index.html">http</a></li><li><a href="../../kjs/html/index.html">kjs</a></li><li><a href="../../kmdi/html/index.html">kmdi</a></li><li> <a href="../../kmdi/kmdi/html/index.html">kmdi</a></li><li><a href="../../knewstuff/html/index.html">knewstuff</a></li><li><a href="../../kparts/html/index.html">kparts</a></li><li><a href="../../kresources/html/index.html">kresources</a></li><li><a href="../../kspell2/html/index.html">kspell2</a></li><li><a href="../../kunittest/html/index.html">kunittest</a></li><li><a href="../../kutils/html/index.html">kutils</a></li><li><a href="../../kwallet/html/index.html">kwallet</a></li><li><a href="../../libkmid/html/index.html">libkmid</a></li><li><a href="../../libkscreensaver/html/index.html">libkscreensaver</a></li>
</ul></div></div>
</td>
</tr>
</table>
<span class="doNotDisplay">
<a href="http://www.kde.org/" accesskey="8">KDE Home</a> |
<a href="http://accessibility.kde.org/" accesskey="9">KDE Accessibility Home</a> |
<a href="http://www.kde.org/media/accesskeys.php" accesskey="0">Description of Access Keys</a>
</span>
<div style="height: 8px"></div>
<div id="footer">
<div id="footer_left">
Maintained by <a href="mailto:groot@kde.org">Adriaan de Groot</a>
and
<a href="mailto:winter@kde.org">Allen Winter</a>.
<br/>
KDE and K Desktop Environment are trademarks of <a href="http://www.kde.org/areas/kde-ev/" title="Homepage of the KDE non-profit Organization">KDE e.V.</a> |
<a href="http://www.kde.org/contact/impressum.php">Legal</a>
</div>
<div id="footer_right"><img src="/media/images/footer_right.png" style="margin: 0px" alt="" /></div>
</div>
<!--
WARNING: DO NOT SEND MAIL TO THE FOLLOWING EMAIL ADDRESS! YOU WILL
BE BLOCKED INSTANTLY AND PERMANENTLY!
<a href="mailto:aaaatrap-425acc3b5374943f@kde.org">Block me</a>
WARNING END
-->
</body>
</html>
