html/doxygen/3.0/namespacesago.html
browsing at commit = 4b4f1e3e4a33faac2e16861a71ef9240dc9e9da4
<!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">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.13"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>Platform folders: sago Namespace Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">Platform folders
 <span id="projectnumber">3.0</span>
</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.8.13 -->
<script type="text/javascript">
var searchBox = new SearchBox("searchBox", "search",false,'Search');
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
$(function() {
initMenu('',true,false,'search.php','Search');
$(document).ready(function() { init_search(); });
});
</script>
<div id="main-nav"></div>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>
<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#nested-classes">Classes</a> |
<a href="#func-members">Functions</a> </div>
<div class="headertitle">
<div class="title">sago Namespace Reference</div> </div>
</div><!--header-->
<div class="contents">
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="nested-classes"></a>
Classes</h2></td></tr>
<tr class="memitem:"><td class="memItemLeft" align="right" valign="top">class  </td><td class="memItemRight" valign="bottom"><a class="el" href="classsago_1_1PlatformFolders.html">PlatformFolders</a></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2"> </td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:a85c382a039426b76aa408961ac2149ee"><td class="memItemLeft" align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="namespacesago.html#a85c382a039426b76aa408961ac2149ee">getDataHome</a> ()</td></tr>
<tr class="separator:a85c382a039426b76aa408961ac2149ee"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:aa6c6da4e6fe460076ac069e176622f59"><td class="memItemLeft" align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="namespacesago.html#aa6c6da4e6fe460076ac069e176622f59">getConfigHome</a> ()</td></tr>
<tr class="separator:aa6c6da4e6fe460076ac069e176622f59"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a426458c0e30383f23ecab17bdf55a407"><td class="memItemLeft" align="right" valign="top">std::string </td><td class="memItemRight" valign="bottom"><a class="el" href="namespacesago.html#a426458c0e30383f23ecab17bdf55a407">getCacheDir</a> ()</td></tr>
<tr class="separator:a426458c0e30383f23ecab17bdf55a407"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a2d3b0d91188997c4949f5f39a24dd8ab"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="namespacesago.html#a2d3b0d91188997c4949f5f39a24dd8ab">appendAdditionalDataDirectories</a> (std::vector< std::string > &homes)</td></tr>
<tr class="separator:a2d3b0d91188997c4949f5f39a24dd8ab"><td class="memSeparator" colspan="2"> </td></tr>
<tr class="memitem:a760a4d546d0bccc82dc939ed6e10304d"><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="namespacesago.html#a760a4d546d0bccc82dc939ed6e10304d">appendAdditionalConfigDirectories</a> (std::vector< std::string > &homes)</td></tr>
<tr class="separator:a760a4d546d0bccc82dc939ed6e10304d"><td class="memSeparator" colspan="2"> </td></tr>
</table>
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
<div class="textblock"><p>The namespace I use for common function. Nothing special about it. </p>
</div><h2 class="groupheader">Function Documentation</h2>
<a id="a760a4d546d0bccc82dc939ed6e10304d"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a760a4d546d0bccc82dc939ed6e10304d">◆ </a></span>appendAdditionalConfigDirectories()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void sago::appendAdditionalConfigDirectories </td>
<td>(</td>
<td class="paramtype">std::vector< std::string > & </td>
<td class="paramname"><em>homes</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>This will append extra folders that your program should be looking for config files in. This does not normally include the path returned by GetConfigHome(). If you want all the folders you should do something like: </p><div class="fragment"><div class="line">std::vector<std::string> folders;</div><div class="line">folders.push_back(<a class="code" href="namespacesago.html#aa6c6da4e6fe460076ac069e176622f59">sago::getConfigHome</a>());</div><div class="line"><a class="code" href="namespacesago.html#a760a4d546d0bccc82dc939ed6e10304d">sago::appendAdditionalConfigDirectories</a>(folders);</div><div class="line"><span class="keywordflow">for</span> (std::string s& : folders) {</div><div class="line"> s+=<span class="stringliteral">"/My Program Name/"</span>;</div><div class="line">}</div></div><!-- fragment --><p> You must apply "/My Program Name/" to all the strings. The string at the lowest index has the highest priority. </p><dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">homes</td><td>A vector that extra folders will be appended to. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="a2d3b0d91188997c4949f5f39a24dd8ab"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a2d3b0d91188997c4949f5f39a24dd8ab">◆ </a></span>appendAdditionalDataDirectories()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">void sago::appendAdditionalDataDirectories </td>
<td>(</td>
<td class="paramtype">std::vector< std::string > & </td>
<td class="paramname"><em>homes</em></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>This will append extra folders that your program should be looking for data files in. This does not normally include the path returned by GetDataHome(). If you want all the folders you should do something like: </p><div class="fragment"><div class="line">vector<string> folders;</div><div class="line">folders.push_back(<a class="code" href="namespacesago.html#a85c382a039426b76aa408961ac2149ee">getDataHome</a>());</div><div class="line"><a class="code" href="namespacesago.html#a2d3b0d91188997c4949f5f39a24dd8ab">appendAdditionalDataDirectories</a>(folders);</div><div class="line"><span class="keywordflow">for</span> (<span class="keywordtype">string</span> s& : folders) {</div><div class="line"> s+=<span class="stringliteral">"/My Program Name/"</span>;</div><div class="line">}</div></div><!-- fragment --><p> You must apply "/My Program Name/" to all the strings. The string at the lowest index has the highest priority. </p><dl class="params"><dt>Parameters</dt><dd>
<table class="params">
<tr><td class="paramname">homes</td><td>A vector that extra folders will be appended to. </td></tr>
</table>
</dd>
</dl>
</div>
</div>
<a id="a426458c0e30383f23ecab17bdf55a407"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a426458c0e30383f23ecab17bdf55a407">◆ </a></span>getCacheDir()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::string sago::getCacheDir </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Retrives the base folder for storring cache files. You must add the program name yourself like this: </p><div class="fragment"><div class="line"><span class="keywordtype">string</span> data_home = <a class="code" href="namespacesago.html#a426458c0e30383f23ecab17bdf55a407">getCacheDir</a>()+<span class="stringliteral">"/My Program Name/"</span>;</div></div><!-- fragment --><p> On Windows this defaults to APPDATALOCAL% On Linux this defaults to ~/.cache but can be configured </p><dl class="section return"><dt>Returns</dt><dd>The base folder for storring data that do not need to be backed up. </dd></dl>
</div>
</div>
<a id="aa6c6da4e6fe460076ac069e176622f59"></a>
<h2 class="memtitle"><span class="permalink"><a href="#aa6c6da4e6fe460076ac069e176622f59">◆ </a></span>getConfigHome()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::string sago::getConfigHome </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Retrives the base folder for storring config files. You must add the program name yourself like this: </p><div class="fragment"><div class="line"><span class="keywordtype">string</span> data_home = <a class="code" href="namespacesago.html#aa6c6da4e6fe460076ac069e176622f59">getConfigHome</a>()+<span class="stringliteral">"/My Program Name/"</span>;</div></div><!-- fragment --><p> On Windows this defaults to APPDATA% (Roaming profile) On Linux this defaults to ~/.config but can be configured </p><dl class="section return"><dt>Returns</dt><dd>The base folder for storring config data. </dd></dl>
</div>
</div>
<a id="a85c382a039426b76aa408961ac2149ee"></a>
<h2 class="memtitle"><span class="permalink"><a href="#a85c382a039426b76aa408961ac2149ee">◆ </a></span>getDataHome()</h2>
<div class="memitem">
<div class="memproto">
<table class="memname">
<tr>
<td class="memname">std::string sago::getDataHome </td>
<td>(</td>
<td class="paramname"></td><td>)</td>
<td></td>
</tr>
</table>
</div><div class="memdoc">
<p>Retrives the base folder for storring data files. You must add the program name yourself like this: </p><div class="fragment"><div class="line"><span class="keywordtype">string</span> data_home = <a class="code" href="namespacesago.html#a85c382a039426b76aa408961ac2149ee">getDataHome</a>()+<span class="stringliteral">"/My Program Name/"</span>;</div></div><!-- fragment --><p> On Windows this defaults to APPDATA% (Roaming profile) On Linux this defaults to ~/.local/share but can be configured </p><dl class="section return"><dt>Returns</dt><dd>The base folder for storring program data. </dd></dl>
</div>
</div>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated on Wed Apr 18 2018 20:58:02 for Platform folders by  <a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/>
</a> 1.8.13
</small></address>
</body>
</html>