8000 Jinja2C++ doxygen documentation · jinja2cpp/jinja2cpp.github.io@991494c · GitHub
[go: up one dir, main page]

Skip to content

Commit 991494c

Browse files
committed
Jinja2C++ doxygen documentation
1 parent 557067c commit 991494c

File tree

148 files changed

+1774
-997
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

148 files changed

+1774
-997
lines changed

docs/reference/1.0/html/annotated.html

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -119,13 +119,13 @@
119119
<tr id="row_0_5_0_" class="even"><td class="entry"><span style="width:48px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="structjinja2_1_1_generic_list_iterator_1_1_cloner.html" target="_self">Cloner</a></td><td class="desc"></td></tr>
120120
<tr id="row_0_6_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="classjinja2_1_1_generic_map.html" target="_self">GenericMap</a></td><td class="desc">Helper class for accessing maps specified by the <a class="el" href="structjinja2_1_1_map_item_accessor.html">MapItemAccessor</a> interface </td></tr>
121121
<tr id="row_0_7_" class="even"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="classjinja2_1_1_i_error_handler.html" target="_self">IErrorHandler</a></td><td class="desc"></td></tr>
122-
<tr id="row_0_8_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="classjinja2_1_1_i_filesystem_handler.html" target="_self">IFilesystemHandler</a></td><td class="desc"></td></tr>
122+
<tr id="row_0_8_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="classjinja2_1_1_i_filesystem_handler.html" target="_self">IFilesystemHandler</a></td><td class="desc">Generic interface to filesystem handlers (loaders) </td></tr>
123123
<tr id="row_0_9_" class="even"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="structjinja2_1_1_index_based_accessor.html" target="_self">IndexBasedAccessor</a></td><td class="desc"></td></tr>
124124
<tr id="row_0_10_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="structjinja2_1_1_list_enumerator.html" target="_self">ListEnumerator</a></td><td class="desc"></td></tr>
125125
<tr id="row_0_11_" class="even"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="structjinja2_1_1_list_item_accessor.html" target="_self">ListItemAccessor</a></td><td class="desc"></td></tr>
126126
<tr id="row_0_12_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="structjinja2_1_1_map_item_accessor.html" target="_self">MapItemAccessor</a></td><td class="desc">Interface to the generic dictionary type which maps string to some value </td></tr>
127-
<tr id="row_0_13_" class="even"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="classjinja2_1_1_memory_file_system.html" target="_self">MemoryFileSystem</a></td><td class="desc"></td></tr>
128-
<tr id="row_0_14_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="classjinja2_1_1_real_file_system.html" target="_self">RealFileSystem</a></td><td class="desc"></td></tr>
127+
<tr id="row_0_13_" class="even"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="classjinja2_1_1_memory_file_system.html" target="_self">MemoryFileSystem</a></td><td class="desc">Filesystem handler for files stored in memory </td></tr>
128+
<tr id="row_0_14_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="classjinja2_1_1_real_file_system.html" target="_self">RealFileSystem</a></td><td class="desc">Filesystem handler for files stored on the filesystem </td></tr>
129129
<tr id="row_0_15_" class="even"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="classjinja2_1_1_reflected_data_holder.html" target="_self">ReflectedDataHolder</a></td><td class="desc"></td></tr>
130130
<tr id="row_0_16_"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="classjinja2_1_1_reflected_data_holder_3_01_t_00_01false_01_4.html" target="_self">ReflectedDataHolder&lt; T, false &gt;</a></td><td class="desc"></td></tr>
131131
<tr id="row_0_17_" class="even"><td class="entry"><span style="width:32px;display:inline-block;">&#160;</span><span class="icona"><span class="icon">C</span></span><a class="el" href="classjinja2_1_1_reflected_data_holder_3_01_t_00_01true_01_4.html" target="_self">ReflectedDataHolder&lt; T, true &gt;</a></td><td class="desc"></td></tr>

docs/reference/1.0/html/classjinja2_1_1_i_filesystem_handler-members.html

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -101,9 +101,10 @@
101101

102102
<p>This is the complete list of members for <a class="el" href="classjinja2_1_1_i_filesystem_handler.html">jinja2::IFilesystemHandler</a>, including all inherited members.</p>
103103
<table class="directory">
104-
<tr class="even"><td class="entry"><a class="el" href="classjinja2_1_1_i_filesystem_handler.html#ab20beae340570f352193bd12819d8efd">OpenStream</a>(const std::string &amp;name) const =0</td><td class="entry"><a class="el" href="classjinja2_1_1_i_filesystem_handler.html">jinja2::IFilesystemHandler</a></td><td class="entry"><span class="mlabel">pure virtual</span></td></tr>
105-
<tr><td class="entry"><a class="el" href="classjinja2_1_1_i_filesystem_handler.html#a76b088ac5bcff7ecd673b45ef59906cb">OpenWStream</a>(const std::string &amp;name) const =0</td><td class="entry"><a class="el" href="classjinja2_1_1_i_filesystem_handler.html">jinja2::IFilesystemHandler</a></td><td class="entry"><span class="mlabel">pure virtual</span></td></tr>
106-
<tr class="even"><td class="entry"><a class="el" href="classjinja2_1_1_i_filesystem_handler.html#af1e98b85bed16d51148d42d64fb07e40">~IFilesystemHandler</a>()=default</td><td class="entry"><a class="el" href="classjinja2_1_1_i_filesystem_handler.html">jinja2::IFilesystemHandler</a></td><td class="entry"><span class="mlabel">virtual</span></td></tr>
104+
<tr class="even"><td class="entry"><a class="el" href="classjinja2_1_1_i_filesystem_handler.html#a9bceaeb724626d1f9055e5be8ee5cc9f">GetLastModificationDate</a>(const std::string &amp;name) const =0</td><td class="entry"><a class="el" href="classjinja2_1_1_i_filesystem_handler.html">jinja2::IFilesystemHandler</a></td><td class="entry"><span class="mlabel">pure virtual</span></td></tr>
105+
<tr><td class="entry"><a class="el" href="classjinja2_1_1_i_filesystem_handler.html#ab20beae340570f352193bd12819d8efd">OpenStream</a>(const std::string &amp;name) const =0</td><td class="entry"><a class="el" href="classjinja2_1_1_i_filesystem_handler.html">jinja2::IFilesystemHandler</a></td><td class="entry"><span class="mlabel">pure virtual</span></td></tr>
106+
<tr class="even"><td class="entry"><a class="el" href="classjinja2_1_1_i_filesystem_handler.html#a76b088ac5bcff7ecd673b45ef59906cb">OpenWStream</a>(const std::string &amp;name) const =0</td><td class="entry"><a class="el" href="classjinja2_1_1_i_filesystem_handler.html">jinja2::IFilesystemHandler</a></td><td class="entry"><span class="mlabel">pure virtual</span></td></tr>
107+
<tr><td class="entry"><a class="el" href="classjinja2_1_1_i_filesystem_handler.html#af1e98b85bed16d51148d42d64fb07e40">~IFilesystemHandler</a>()=default</td><td class="entry"><a class="el" href="classjinja2_1_1_i_filesystem_handler.html">jinja2::IFilesystemHandler</a></td><td class="entry"><span class="mlabel">virtual</span></td></tr>
107108
</table></div><!-- contents -->
108109
</div><!-- doc-content -->
109110
<!-- HTML footer for doxygen 1.8.16-->

docs/reference/1.0/html/classjinja2_1_1_i_filesystem_handler.html

Lines changed: 75 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -102,28 +102,40 @@
102102
</div><!--header-->
103103
<div class="contents">
104104

105+
<p>Generic interface to filesystem handlers (loaders)
106+
<a href="classjinja2_1_1_i_filesystem_handler.html#details">More...</a></p>
107+
105108
<p><code>#include &lt;<a class="el" href="filesystem__handler_8h_source.html">filesystem_handler.h</a>&gt;</code></p>
106109
<div class="dynheader">
107110
Inheritance diagram for jinja2::IFilesystemHandler:</div>
108111
<div class="dyncontent">
109112
<div class="center">
110113
<img src="classjinja2_1_1_i_filesystem_handler.png" usemap="#jinja2::IFilesystemHandler_map" alt=""/>
111114
<map id="jinja2::IFilesystemHandler_map" name="jinja2::IFilesystemHandler_map">
112-
<area href="classjinja2_1_1_memory_file_system.html" alt="jinja2::MemoryFileSystem" shape="rect" coords="0,56,155,80"/>
113-
<area href="classjinja2_1_1_real_file_system.html" alt="jinja2::RealFileSystem" shape="rect" coords="165,56,320,80"/>
115+
<area href="classjinja2_1_1_memory_file_system.html" title="Filesystem handler for files stored in memory." alt="jinja2::MemoryFileSystem" shape="rect" coords="0,56,155,80"/>
116+
<area href="classjinja2_1_1_real_file_system.html" title="Filesystem handler for files stored on the filesystem." alt="jinja2::RealFileSystem" shape="rect" coords="165,56,320,80"/>
114117
</map>
115118
</div></div>
116119
<table class="memberdecls">
117120
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
118121
Public Member Functions</h2></td></tr>
119122
<tr class="memitem:af1e98b85bed16d51148d42d64fb07e40"><td class="memItemLeft" align="right" valign="top">virtual&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classjinja2_1_1_i_filesystem_handler.html#af1e98b85bed16d51148d42d64fb07e40">~IFilesystemHandler</a> ()=default</td></tr>
123+
<tr class="memdesc:af1e98b85bed16d51148d42d64fb07e40"><td class="mdescLeft">&#160;</td><td class="mdescRight">Destructor. <a href="classjinja2_1_1_i_filesystem_handler.html#af1e98b85bed16d51148d42d64fb07e40">More...</a><br /></td></tr>
120124
<tr class="separator:af1e98b85bed16d51148d42d64fb07e40"><td class="memSeparator" colspan="2">&#160;</td></tr>
121125
<tr class="memitem:ab20beae340570f352193bd12819d8efd"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="namespacejinja2.html#ab5d363d70df829219a7b5652328977c6">CharFileStreamPtr</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classjinja2_1_1_i_filesystem_handler.html#ab20beae340570f352193bd12819d8efd">OpenStream</a> (const std::string &amp;name) const =0</td></tr>
126+
<tr class="memdesc:ab20beae340570f352193bd12819d8efd"><td class="mdescLeft">&#160;</td><td class="mdescRight">Method is called to open the file with the specified name in 'narrow-char' mode. <a href="classjinja2_1_1_i_filesystem_handler.html#ab20beae340570f352193bd12819d8efd">More...</a><br /></td></tr>
122127
<tr class="separator:ab20beae340570f352193bd12819d8efd"><td class="memSeparator" colspan="2">&#160;</td></tr>
123128
<tr class="memitem:a76b088ac5bcff7ecd673b45ef59906cb"><td class="memItemLeft" align="right" valign="top">virtual <a class="el" href="namespacejinja2.html#ad07d25b586e095c48d73b504a49d4697">WCharFileStreamPtr</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classjinja2_1_1_i_filesystem_handler.html#a76b088ac5bcff7ecd673b45ef59906cb">OpenWStream</a> (const std::string &amp;name) const =0</td></tr>
129+
<tr class="memdesc:a76b088ac5bcff7ecd673b45ef59906cb"><td class="mdescLeft">&#160;</td><td class="mdescRight">Method is called to open the file with the specified name in 'wide-char' mode. <a href="classjinja2_1_1_i_filesystem_handler.html#a76b088ac5bcff7ecd673b45ef59906cb">More...</a><br /></td></tr>
124130
<tr class="separator:a76b088ac5bcff7ecd673b45ef59906cb"><td class="memSeparator" colspan="2">&#160;</td></tr>
131+
<tr class="memitem:a9bceaeb724626d1f9055e5be8ee5cc9f"><td class="memItemLeft" align="right" valign="top">virtual nonstd::optional&lt; std::chrono::system_clock::time_point &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="classjinja2_1_1_i_filesystem_handler.html#a9bceaeb724626d1f9055e5be8ee5cc9f">GetLastModificationDate</a> (const std::string &amp;name) const =0</td></tr>
132+
<tr class="memdesc:a9bceaeb724626d1f9055e5be8ee5cc9f"><td class="mdescLeft">&#160;</td><td class="mdescRight">Method is called to obtain the modification date of the specified file (if applicable) <a href="classjinja2_1_1_i_filesystem_handler.html#a9bceaeb724626d1f9055e5be8ee5cc9f">More...</a><br /></td></tr>
133+
<tr class="separator:a9bceaeb724626d1f9055e5be8ee5cc9f"><td class="memSeparator" colspan="2">&#160;</td></tr>
125134
</table>
126-
<h2 class="groupheader">Constructor &amp; Destructor Documentation</h2>
135+
<a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
136+
<div class="textblock"><p>Generic interface to filesystem handlers (loaders) </p>
137+
<p>This interface should be implemented in order to provide custom file system handler. Interface provides most-common methods which are called by the template environment to load the particular template. <code>OpenStream</code> methods return the unique pointer to the generic <code>istream</code> object implementation. So, the exact type (ex. <code>ifstream</code>, <code>istringstream</code> etc.) of input stream is unspecified. In order to delete stream object correctly returned pointer provide the custom deleter which should properly delete the stream object. </p>
138+
</div><h2 class="groupheader">Constructor &amp; Destructor Documentation</h2>
127139
<a id="af1e98b85bed16d51148d42d64fb07e40"></a>
128140
<h2 class="memtitle"><span class="permalink"><a href="#af1e98b85bed16d51148d42d64fb07e40">&#9670;&nbsp;</a></span>~IFilesystemHandler()</h2>
129141

@@ -147,9 +159,49 @@ <h2 class="memtitle"><span class="permalink"><a href="#af1e98b85bed16d51148d42d6
147159
</table>
148160
</div><div class="memdoc">
149161

162+
<p>Destructor. </p>
163+
150164
</div>
151165
</div>
152166
<h2 class="groupheader">Member Function Documentation</h2>
167+
<a id="a9bceaeb724626d1f9055e5be8ee5cc9f"></a>
168+
<h2 class="memtitle"><span class="permalink"><a href="#a9bceaeb724626d1f9055e5be8ee5cc9f">&#9670;&nbsp;</a></span>GetLastModificationDate()</h2>
169+
170+
<div class="memitem">
171+
<div class="memproto">
172+
<table class="mlabels">
173+
<tr>
174+
<td class="mlabels-left">
175+
<table class="memname">
176+
<tr>
177+
<td class="memname">virtual nonstd::optional&lt;std::chrono::system_clock::time_point&gt; jinja2::IFilesystemHandler::GetLastModificationDate </td>
178+
<td>(</td>
179+
<td class="paramtype">const std::string &amp;&#160;</td>
180+
<td class="paramname"><em>name</em></td><td>)</td>
181+
<td> const</td>
182+
</tr>
183+
</table>
184+
</td>
185+
<td class="mlabels-right">
186+
<span class="mlabels"><span class="mlabel">pure virtual</span></span> </td>
187+
</tr>
188+
</table>
189+
</div><div class="memdoc">
190+
191+
<p>Method is called to obtain the modification date of the specified file (if applicable) </p>
192+
<p>If the underlaying filesystem supports retrival of the last modification date of the file this method should return this date when called. In other case it should return the empty optional object. Main purpose of this method is to help templates loader to determine the necessity of cached template reload</p>
193+
<dl class="params"><dt>Parameters</dt><dd>
194+
<table class="params">
195+
<tr><td class="paramname">name</td><td>Name of the file to get the last modification date </td></tr>
196+
</table>
197+
</dd>
198+
</dl>
199+
<dl class="section return"><dt>Returns</dt><dd>Last modification date (if applicable) or empty optional object otherwise </dd></dl>
200+
201+
<p>Implemented in <a class="el" href="classjinja2_1_1_real_file_system.html#a5c0ceaf6dbc6dd19875107431f77e528">jinja2::RealFileSystem</a>, and <a class="el" href="classjinja2_1_1_memory_file_system.html#aa2552ba005db25f41d4c7b3d589d3092">jinja2::MemoryFileSystem</a>.</p>
202+
203+
</div>
204+
</div>
153205
<a id="ab20beae340570f352193bd12819d8efd"></a>
154206
<h2 class="memtitle"><span class="permalink"><a href="#ab20beae340570f352193bd12819d8efd">&#9670;&nbsp;</a></span>OpenStream()</h2>
155207

@@ -174,6 +226,16 @@ <h2 class="memtitle"><span class="permalink"><a href="#ab20beae340570f352193bd12
174226
</table>
175227
</div><div class="memdoc">
176228

229+
<p>Method is called to open the file with the specified name in 'narrow-char' mode. </p>
230+
<p>Method should return unique pointer to the std::istream object with custom deleter (<a class="el" href="namespacejinja2.html#ab5d363d70df829219a7b5652328977c6">CharFileStreamPtr</a>) . Deleter should properly delete pointee stream object.</p>
231+
<dl class="params"><dt>Parameters</dt><dd>
232+
<table class="params">
233+
<tr><td class="paramname">name</td><td>Name of the file to open </td></tr>
234+
</table>
235+
</dd>
236+
</dl>
237+
<dl class="section return"><dt>Returns</dt><dd>Opened stream object or empty pointer in case of any error </dd></dl>
238+
177239
<p>Implemented in <a class="el" href="classjinja2_1_1_real_file_system.html#aa92284a328d2adfa13ef05049862b284">jinja2::RealFileSystem</a>, and <a class="el" href="classjinja2_1_1_memory_file_system.html#aef0bb8aecde68e0aeff2e530461d39b8">jinja2::MemoryFileSystem</a>.</p>
178240

179241
</div>
@@ -202,6 +264,16 @@ <h2 class="memtitle"><span class="permalink"><a href="#a76b088ac5bcff7ecd673b45e
202264
</table>
203265
</div><div class="memdoc">
204266

267+
<p>Method is called to open the file with the specified name in 'wide-char' mode. </p>
268+
<p>Method should return unique pointer to the std::wistream object with custom deleter (<a class="el" href="namespacejinja2.html#ad07d25b586e095c48d73b504a49d4697">WCharFileStreamPtr</a>) . Deleter should properly delete pointee stream object.</p>
269+
<dl class="params"><dt>Parameters</dt><dd>
270+
<table class="params">
271+
<tr><td class="paramname">name</td><td>Name of the file to open </td></tr>
272+
</table>
273+
</dd>
274+
</dl>
275+
<dl class="section return"><dt>Returns</dt><dd>Opened stream object or empty pointer in case of any error </dd></dl>
276+
205277
<p>Implemented in <a class="el" href="classjinja2_1_1_real_file_system.html#ae463b6ab90e75c2bd5f540347ff91f9f">jinja2::RealFileSystem</a>, and <a class="el" href="classjinja2_1_1_memory_file_system.html#a008a9a04f0961215e0cbc5d739d2df7f">jinja2::MemoryFileSystem</a>.</p>
206278

207279
</div>
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
var classjinja2_1_1_i_filesystem_handler =
22
[
33
[ "~IFilesystemHandler", "classjinja2_1_1_i_filesystem_handler.html#af1e98b85bed16d51148d42d64fb07e40", null ],
4+
[ "GetLastModificationDate", "classjinja2_1_1_i_filesystem_handler.html#a9bceaeb724626d1f9055e5be8ee5cc9f", null ],
45
[ "OpenStream", "classjinja2_1_1_i_filesystem_handler.html#ab20beae340570f352193bd12819d8efd", null ],
56
[ "OpenWStream", "classjinja2_1_1_i_filesystem_handler.html#a76b088ac5bcff7ecd673b45ef59906cb", null ]
67
];

0 commit comments

Comments
 (0)
0