3party/date
0
0
Fork 0
mirror of https://github.com/HowardHinnant/date.git synced 2025-01-16 20:41:20 +08:00
Code Issues Projects Releases Wiki Activity

Document set_install.

Browse Source
This commit is contained in:
Howard Hinnant 2017-03-22 22:52:07 -04:00
parent c12319552a
commit f3b61aab48
1 changed files with 32 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

33
tz.html
View File

@ -26,7 +26,7 @@
<br/>
<br/>
<a href="mailto:howard.hinnant@gmail.com">Howard E. Hinnant</a><br/>
2017-03-02<br/>
2017-03-22<br/>
</address>
<hr/>
<h1 align=center>Time Zone Database Parser</h1>
@ -928,6 +928,37 @@ be returned to a valid <code>TZ_DB</code>.
</p>
</blockquote>
<pre>
void set_install(const std::string&amp; s);
</pre>
<blockquote>
<p>
<i>Effects:</i> Sets the location which the database is, or will be, installed at.
</p>
<p>
<i>Default:</i> If this function is never called, and the macro <code>INSTALL</code> is
defined, the location of the database is <code>INSTALL/tzdata</code>
(<code>INSTALL\tzdata</code> on Windows). If the macro <code>INSTALL</code> is not
defined, the default location of the database is <code>~/Downloads/tzdata</code>
(<code>%homedrive%\%homepath%\downloads\tzdata</code> on Windows).
</p>
<p>
<i>Thread Safety:</i> This function is <i>not</i> thread safe. You must
provide your own synchronization among threads calling this function. It should be
called prior to any other access to the database.
</p>
<p>
<i>Throws:</i> Anything assignment to <code>std::string</code> might throw.
</p>
<p>
<i>Note:</i> No expansion is attempted on the argument <code>s</code> (e.g. expanding
<code>~/</code>). This is a low-level function meant to enable other expansion techniques
such as
<a href="https://freedesktop.org/wiki/Software/xdg-user-dirs/ ">xdg-user-dirs</a> whose
result can be passed directly to <code>set_install</code>.
</p>
</blockquote>
<p>
The following functions are available only if you compile with the configuration macro
<code>HAS_REMOTE_API == 1</code>. Use of this API requires linking to