]>
Commit | Line | Data |
---|---|---|
7c673cae FG |
1 | <html> |
2 | <head> | |
3 | <!-- Generated by the Spirit (http://spirit.sf.net) QuickDoc --> | |
4 | <title>predefined_actors</title> | |
5 | <link rel="stylesheet" href="theme/style.css" type="text/css"> | |
6 | </head> | |
7 | <body> | |
8 | <table width="100%" height="48" border="0" background="theme/bkd2.gif" cellspacing="2"> | |
9 | <tr> | |
10 | <td width="10"> | |
11 | </td> | |
12 | <td width="85%"> <font size="6" face="Verdana, Arial, Helvetica, sans-serif"><b>Predefined | |
13 | Actors</b></font></td> | |
14 | <td width="112"><a href="http://spirit.sf.net"><img src="theme/spirit.gif" align="right" border="0"></a></td> | |
15 | </tr> | |
16 | </table> | |
17 | <br> | |
18 | <table border="0"> | |
19 | <tr> | |
20 | <td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td> | |
21 | <td width="30"><a href="indepth_the_parser_context.html"><img src="theme/l_arr.gif" width="20" height="19" border="0"></a></td> | |
22 | <td width="20"><a href="parametric_parsers.html"><img src="theme/r_arr.gif" width="20" height="19" border="0"></a></td> | |
23 | </tr> | |
24 | </table> | |
25 | <h2>Actors</h2><p> | |
26 | The framework has a number of predefined semantic action functors. | |
27 | Experience shows that these functors are so often used that they were included | |
28 | as part of the core framework to spare the user from having to reinvent the | |
29 | same functionality over and over again.</p> | |
30 | <h2>Quick example: <tt>assign_a</tt> actor</h2> | |
31 | <code> | |
32 | <pre> <span class=keyword>int </span><span class=identifier>i</span><span class=special>,</span><span class=identifier> j</span><span class=special>; | |
33 | </span><span class=identifier>std</span><span class=special>::</span><span class=identifier>string </span><span class=identifier>s</span><span class=special>; | |
34 | </span><span class=identifier>r </span><span class=special>= </span><span class=identifier>int_p</span><span class=special>[</span><span class=identifier>assign_a</span><span class=special>(</span><span class=identifier>i</span><span class=special>)] >> (+</span><span class=identifier>alpha_p</span><span class=special>)[</span><span class=identifier>assign_a</span><span class=special>(</span><span class=identifier>s</span><span class=special>)] >> </span><span class=identifier>int_p</span><span class=special>[</span><span class=identifier>assign_a</span><span class=special>(</span><span class=identifier>j</span><span class=special>,</span><span class=identifier>i</span><span class=special>)];</span></pre> | |
35 | </code> | |
36 | <p> | |
37 | Given an input <tt>123456 Hello 789</tt>, </p> | |
38 | <ol><li><tt>assign_a(i)</tt> will extract the number <tt>123456</tt> and assign it to <tt>i</tt>, </li><li><tt>assign_a(s)</tt> will extract the string <tt>"Hello"</tt> and assign it to <tt>s</tt>,</li><li><tt>assign_a(j,i)</tt> will assign i to j, j=i, without using the parse result.</li></ol> | |
39 | <p> Technically, the expression <tt>assign_a(v)</tt> is a template function that | |
40 | generates a semantic action. In fact, actor instances are not created directly | |
41 | since they usually involve a number of template parameters. Instead generator | |
42 | functions ("helper functions") are provided to generate actors from | |
43 | their arguments. All helper functions have the "_a" suffix. For example, | |
44 | <tt>append_actor</tt> is created using the <tt>append_a</tt> function. </p> | |
45 | <p> | |
46 | The semantic action generated is polymorphic and should work with any | |
47 | type as long as it is compatible with the arguments received from the parser. | |
48 | It might not be obvious, but a string can accept the iterator first and last | |
49 | arguments that are passed into a generic semantic action (see above). In fact, | |
50 | any STL container that has an <tt>assign(first, last)</tt> member function can be | |
51 | used.</p> | |
52 | <h2>Actors summary</h2><p> | |
53 | Below are tables summarizing the "built-in" actors with the | |
54 | conventions given below.</p> | |
55 | <ul> | |
56 | <li><tt>ref</tt> is a <b>reference</b> to an object stored in a policy holder | |
57 | actor</li> | |
58 | <li><tt>value_ref</tt> and <tt>key_ref</tt> are <b>const reference</b>s stored | |
59 | in a policy holder actor</li> | |
60 | <li><tt>value</tt> is the <b>parse result</b>. This could be the result for | |
61 | the single argument () operator or the two argument () operator</li> | |
62 | <li><tt>vt</tt> stands for the <tt>value_type</tt> type: <tt>type& ref; | |
63 | // vt is type::value_type</tt>.</li> | |
64 | </ul> | |
65 | <p> Note that examples are provided after the tables.</p> | |
66 | <table width="90%" border="0" align="center"> | |
67 | <tr> | |
68 | <td class="table_title" colspan="8"> Unary operator actors</td> | |
69 | </tr> | |
70 | <td width="30%" class="table_cells">++ref</td> <td width="70%" class="table_cells"><b>increment_a</b>(ref)</td> | |
71 | </tr> | |
72 | <td class="table_cells">--ref</td> <td class="table_cells"><b>decrement_a</b>(ref)</td> | |
73 | </tr> | |
74 | </table> | |
75 | <table width="90%" border="0" align="center"> | |
76 | <tr> | |
77 | <td class="table_title" colspan="26"> Assign actors</td> | |
78 | </tr> | |
79 | <tr> | |
80 | <td class="table_cells">ref = value</td> | |
81 | <td class="table_cells"><b>assign_a</b>(ref)</td> | |
82 | </tr> | |
83 | <td width="30%" class="table_cells">ref = value_ref</td> | |
84 | <td width="70%" class="table_cells"><b>assign_a</b>(ref, value_ref)</td> | |
85 | </tr> | |
86 | </table> | |
87 | <table width="90%" border="0" align="center"> | |
88 | <tr> | |
89 | <td class="table_title" colspan="30"> Container actors </td> | |
90 | </tr> | |
91 | <tr> | |
92 | <td width="30%" class="table_cells">ref.push_back(value)</td> | |
93 | <td width="70%" class="table_cells"><b>push_back_a</b>(ref)</td> | |
94 | </tr> | |
95 | <td class="table_cells">ref.push_back(value_ref)</td> | |
96 | <td class="table_cells"><b>push_back_a</b>(ref, value_ref)</td> | |
97 | </tr> | |
98 | <td class="table_cells">ref.push_front(value)</td> | |
99 | <td class="table_cells"><b>push_front_a</b>(ref)</td> | |
100 | </tr> | |
101 | <td class="table_cells">ref.push_front(value_ref)</td> | |
102 | <td class="table_cells"><b>push_front_a</b>(ref, value_ref)</td> | |
103 | </tr> | |
104 | <td class="table_cells">ref.clear()</td> | |
105 | <td class="table_cells"><b>clear_a</b>(ref)</td> | |
106 | </tr> | |
107 | </table> | |
108 | <table width="90%" border="0" align="center"> | |
109 | <tr> | |
110 | <td class="table_title" colspan="14"> Associative container actors </td> | |
111 | </tr> | |
112 | <td width="30%" class="table_cells">ref.insert(vt(value, value_ref))</td> <td width="70%" class="table_cells"><b>insert_key_a</b>(ref, value_ref)</td> | |
113 | </tr> <tr> | |
114 | <td class="table_cells"> ref.insert(vt(key_ref,value_ref)) </td> | |
115 | <td class="table_cells"> <strong>insert_at_a</strong>(ref, key_ref_, value_ref)</td> | |
116 | </tr> | |
117 | <tr> | |
118 | <td class="table_cells"> ref.insert(vt(key_ref,value)) </td> | |
119 | <td class="table_cells"> <strong>insert_at_a</strong>(ref, key_ref) </td> | |
120 | </tr> | |
121 | <td class="table_cells">ref[value] = value_ref</td> | |
122 | <td class="table_cells"><b>assign_key_a</b>(ref, value_ref)</td> | |
123 | </tr> | |
124 | <td class="table_cells">ref.erase(ref,value)</td> | |
125 | <td class="table_cells"><b>erase_a</b>(ref)</td> | |
126 | </tr> | |
127 | <td class="table_cells">ref.erase(ref,key_ref)</td> | |
128 | <td class="table_cells"><b>erase_a</b>(ref, key_ref)</td> | |
129 | </tr> | |
130 | </table> | |
131 | <table width="90%" border="0" align="center"> | |
132 | <tr> | |
133 | <td class="table_title" colspan="8"> Miscellanous actors </td> | |
134 | </tr> | |
135 | <tr> | |
136 | <td width="30%" class="table_cells">swaps aref and bref</td> | |
137 | <td width="70%" class="table_cells"><strong>swap_a</strong>(aref, bref)</td> | |
138 | </tr> | |
139 | </table> | |
140 | <h3>Include Files</h3> | |
141 | <p>The header files for the predefined actors are located in <tt>boost/spirit/actor</tt>. | |
142 | The file <tt>actors.hpp</tt> contains all the includes for all the actors. You | |
143 | may include just the specific header files that you need. The list below enumerates | |
144 | the header files.</p> | |
145 | <pre> <span class="preprocessor">#include</span> <span class="special"><</span>boost<span class="special">/</span>spirit<span class="special">/</span>actor<span class="special">/</span><span class="identifier">assign_actor</span><span class="special">.</span>hpp<span class="special">><br></span> <span class="preprocessor">#include</span> <span class="special"><</span>boost<span class="special">/</span>spirit<span class="special">/</span>actor<span class="special">/</span>assign_key_actor<span class="special">.</span>hpp<span class="special">></span><span class="special"></span><span class="special"></span> | |
146 | <span class="preprocessor">#include</span> <span class="special"><</span>boost<span class="special">/</span>spirit<span class="special">/</span>actor<span class="special">/</span><span class="identifier">clear_actor</span><span class="special">.</span>hpp<span class="special">></span><span class="special"></span><span class="special"></span> | |
147 | <span class="preprocessor">#include</span> <span class="special"><</span>boost<span class="special">/</span>spirit<span class="special">/</span>actor<span class="special">/</span><span class="identifier">decrement_actor</span><span class="special">.</span>hpp<span class="special">></span><span class="special"></span><span class="special"></span> | |
148 | <span class="preprocessor">#include</span> <span class="special"><</span>boost<span class="special">/</span>spirit<span class="special">/</span>actor<span class="special">/</span><span class="identifier">erase_actor</span><span class="special">.</span>hpp<span class="special">></span><span class="special"></span> <br> <span class="preprocessor">#include</span> <span class="special"><</span>boost<span class="special">/</span>spirit<span class="special">/</span>actor<span class="special">/</span><span class="identifier">increment_actor</span><span class="special">.</span>hpp<span class="special">><br></span> <span class="preprocessor">#include</span> <span class="special"><</span>boost<span class="special">/</span>spirit<span class="special">/</span>actor<span class="special">/</span><span class="identifier">insert_key_actor</span><span class="special">.</span>hpp<span class="special">></span><span class="special"></span><span class="special"></span> | |
149 | <span class="preprocessor">#include</span> <span class="special"><</span>boost<span class="special">/</span>spirit<span class="special">/</span>actor<span class="special">/</span>insert_at_actor.hpp<span class="special">></span> | |
150 | <span class="preprocessor">#include</span> <span class="special"><</span>boost<span class="special">/</span>spirit<span class="special">/</span>actor<span class="special">/</span><span class="identifier">push_back_actor</span><span class="special">.</span>hpp<span class="special">></span><span class="special"></span><span class="special"></span> | |
151 | <span class="preprocessor">#include</span> <span class="special"><</span>boost<span class="special">/</span>spirit<span class="special">/</span>actor<span class="special">/</span><span class="identifier">push_front_actor</span><span class="special">.</span>hpp<span class="special">></span><span class="special"></span><span class="special"></span> | |
152 | <span class="preprocessor">#include</span> <span class="special"><</span>boost<span class="special">/</span>spirit<span class="special">/</span>actor<span class="special">/</span><span class="identifier">swap_actor</span><span class="special">.</span>hpp<span class="special">></span><span class="special"></span><span class="special"></span></pre> | |
153 | <h3>Examples</h3> | |
154 | <h4>Increment a value</h4> | |
155 | <p> | |
156 | Suppose that your input string is </p> | |
157 | <code> | |
158 | <pre> 1,2,-3,4,... | |
159 | </pre> | |
160 | </code><p> | |
161 | and we want to count the number of ints. The actor <tt>increment_a</tt> applies <tt>++</tt> to its reference:</p> | |
162 | <code> | |
163 | <pre> <span class=keyword>int </span><span class=identifier>count </span><span class=special>= </span><span class=number>0</span><span class=special>; | |
164 | </span><span class=identifier>rule</span><span class=special><> </span><span class=identifier>r </span><span class=special>= </span><span class=identifier>list_p</span><span class=special>.</span><span class=identifier>direct</span><span class=special>(</span><span class=identifier>int_p</span><span class=special>[</span><span class=identifier>increment_a</span><span class=special>(</span><span class=identifier>count</span><span class=special>)], </span><span class=identifier>ch_p</span><span class=special>(</span><span class=literal>','</span><span class=special>));</span></pre> | |
165 | </code> | |
166 | <h4>Append values to a vector (or other container)</h4> | |
167 | <p> Here, you want to fill a <tt>vector<int></tt> with the numbers. The | |
168 | actor <tt>push_back_a</tt> can be used to insert the integers at the back of | |
169 | the vector:</p> | |
170 | <code> | |
171 | <pre> <span class=identifier>vector</span><span class=special><</span><span class=keyword>int</span><span class=special>> </span><span class=identifier>v</span><span class=special>; | |
172 | </span><span class=identifier>rule</span><span class=special><> </span><span class=identifier>r </span><span class=special>= </span><span class=identifier>list_p</span><span class=special>.</span><span class=identifier>direct</span><span class=special>(</span><span class=identifier>int_p</span><span class=special>[</span><span class=identifier>push_back_a</span><span class=special>(</span><span class=identifier>v</span><span class=special>)], </span><span class=identifier>ch_p</span><span class=special>(</span><span class=literal>','</span><span class=special>));</span></pre> | |
173 | </code> | |
174 | <h4>insert key-value pairs into a map</h4><p> | |
175 | Suppose that your input string is </p> | |
176 | <code> | |
177 | <pre> (1,2) (3,4) ... | |
178 | </pre> | |
179 | </code> | |
180 | <p> and you want to parse the pair into a <tt>map<int,int></tt>. <tt>assign_a</tt> | |
181 | can be used to store key and values in a temporary key variable, while <tt>insert_a</tt> | |
182 | is used to insert it into the map:</p> | |
183 | <pre> <code><span class=identifier>map</span><span class=special><</span><span class=keyword>int</span><span class=special>, </span><span class=keyword>int</span><span class="special">>::</span>value_type<span class=keyword> </span>k<span class=special>; | |
184 | </span><span class=identifier>map</span><span class=special><</span><span class=keyword>int</span><span class=special>, </span><span class=keyword>int</span><span class=special>> </span><span class=identifier>m</span><span class=special>; | |
185 | ||
186 | </span><span class=identifier>rule</span><span class=special><> </span><span class=identifier>pair </span><span class=special>= </span><span class=identifier> | |
187 | confix_p</span><span class=special>( | |
188 | </span><span class=literal>'('</span><span class=special> | |
189 | , </span><span class=identifier>int_p</span><span class=special>[</span><span class=identifier>assign_a</span><span class=special>(</span>k.first<span class=special>)] >> </span><span class=literal>','</span><span class=special> >> </span><span class=identifier>int_p</span><span class=special>[</span><span class=identifier>assign_a</span><span class=special>(</span>k.second<span class=special>)] | |
190 | ,</span><span class=literal> ')' | |
191 | </span><span class=special>)<br> [</span><span class=identifier>insert_at_a</span><span class=special>(</span><span class=identifier>m</span><span class=special>, </span><span class=identifier>k</span><span class=identifier></span><span class=special>)] | |
192 | ;</span></code></pre> | |
193 | <h2>Policy holder actors and policy actions</h2> | |
194 | <p> The action takes place through a call to the <tt>()</tt> operator: single | |
195 | argument <tt>()</tt> operator call for character parsers and two argument (first, | |
196 | last) call for phrase parsers. Actors should implement at least one of the two | |
197 | <tt>()</tt> operator.</p> | |
198 | <p> | |
199 | A lot of actors need to store reference to one or more objects. For | |
200 | example, actions on container need to store a reference to the container.</p> | |
201 | <p> Therefore, this kind of actor have been broken down into <strong>a)</strong> | |
202 | an action policy that does the action (act member function), <strong>b)</strong> | |
203 | policy holder actor that stores the references and feeds the act member function.</p> | |
204 | <h3>Policy holder actors</h3> | |
205 | <p> The available policy holders are enumerated below.</p> | |
206 | <table width="90%" border="0" align="center"> | |
207 | <tr> | |
208 | <td class="table_title" colspan="24"> Policy holders </td> | |
209 | </tr> | |
210 | <tr> | |
211 | <td class="table_cells">Name</td> | |
212 | <td class="table_cells">Stored variables</td> | |
213 | <td class="table_cells">Act signature</td> | |
214 | </tr> | |
215 | <td class="table_cells">ref_actor</td> | |
216 | <td class="table_cells">1 reference</td> | |
217 | <td class="table_cells"><tt>act(ref)</tt></td> | |
218 | </tr> | |
219 | <td class="table_cells">ref_value_actor</td> | |
220 | <td class="table_cells">1 ref</td> | |
221 | <td class="table_cells"> <tt>act(ref, value)</tt> or <tt>act(ref, first, last)</tt></td> | |
222 | </tr> | |
223 | <td class="table_cells">ref_const_ref_actor</td> | |
224 | <td class="table_cells">1 ref and 1 const ref</td> | |
225 | <td class="table_cells"><tt>act(ref, const_ref)</tt></td> | |
226 | </tr> | |
227 | <td class="table_cells">ref_const_ref_value_actor</td> | |
228 | <td class="table_cells">1 ref</td> | |
229 | <td class="table_cells"><tt>act(ref, value)</tt> or <tt>act(ref, first, last)</tt></td> | |
230 | </tr> | |
231 | <td class="table_cells">ref_const_ref_const_ref_actor</td> | |
232 | <td class="table_cells">1 ref, 2 const ref</td> | |
233 | <td class="table_cells"><tt>act(ref, const_ref1, const_ref2)</tt></td> | |
234 | </tr> | |
235 | </table> | |
236 | <h3>Include Files</h3> | |
237 | <p>The predefined policy header files are located in <tt>boost/spirit/actor</tt>:</p> | |
238 | <pre> <span class="preprocessor">#include</span> <span class="special"><</span>boost<span class="special">/</span>spirit<span class="special">/</span>actor<span class="special">/</span>ref_actor<span class="special">.</span>hpp<span class="special">><br></span> <span class="preprocessor">#include</span> <span class="special"><</span>boost<span class="special">/</span>spirit<span class="special">/</span>actor<span class="special">/</span>ref_value_actor<span class="special">.</span>hpp<span class="special">></span><span class="special"></span><span class="special"></span> | |
239 | <span class="preprocessor">#include</span> <span class="special"><</span>boost<span class="special">/</span>spirit<span class="special">/</span>actor<span class="special">/</span>ref_const_ref<span class="special">.</span>hpp<span class="special">></span><span class="special"></span> | |
240 | <span class="preprocessor">#include</span> <span class="special"><</span>boost<span class="special">/</span>spirit<span class="special">/</span>actor<span class="special">/</span>ref_const_ref_value<span class="special">.</span>hpp<span class="special">></span><span class="special"></span> | |
241 | <span class="preprocessor">#include</span> <span class="special"><</span>boost<span class="special">/</span>spirit<span class="special">/</span>actor<span class="special">/</span>ref_const_ref_value<span class="special">.</span>hpp<span class="special">></span><span class="special"></span> | |
242 | <span class="preprocessor">#include</span> <span class="special"><</span>boost<span class="special">/</span>spirit<span class="special">/</span>actor<span class="special">/</span>ref_const_ref_const_ref<span class="special">.</span>hpp<span class="special">></span><span class="special"></span></pre> | |
243 | <h3>Holder naming convention</h3> | |
244 | <p> Policy holder have the following naming convention:</p> | |
245 | <pre> <code><member>_ >> *<member> >> !value >> actor</code></pre> | |
246 | <p> where <tt>member</tt> is the action policy member which can be of type:</p> | |
247 | <ul> | |
248 | <li>ref, a reference</li> | |
249 | <li>const_ref, a const reference</li> | |
250 | <li>value, by value</li> | |
251 | <li>empty, no stored members</li> | |
252 | </ul> | |
253 | <p> and <tt>value</tt> states if the policy uses the parse result or not.</p> | |
254 | <h3>Holder example: <tt>ref_actor</tt> class</h3> | |
255 | <pre><code> <span class=comment>// this is the building block for action that | |
256 | // take a reference and the parse result | |
257 | ||
258 | </span><span class=keyword>template</span><span class=special>< | |
259 | </span><span class=keyword>typename </span><span class=identifier>T</span><span class=special>,</span><span class="comment"> // reference type</span><span class=identifier> | |
260 | </span><span class=keyword>typename </span><span class=identifier>ActionT </span><span class=comment>// action policy | |
261 | </span><span class=special>> | |
262 | </span><span class=keyword>class </span><span class=identifier>ref_value_actor </span><span class=special>: </span><span class=keyword>public </span><span class=identifier>ActionT | |
263 | </span><span class=special>{ | |
264 | </span> <span class=keyword>public</span><span class=special>: | |
265 | ||
266 | </span><span class=keyword>explicit </span><span class=identifier>ref_value_actor</span><span class=special>(</span><span class=identifier>T</span><span class=special>& </span><span class=identifier>ref_</span><span class=special>) | |
267 | : </span><span class=identifier>ref</span><span class=special>(</span><span class=identifier>ref_</span><span class=special>){} | |
268 | ||
269 | </span><span class=keyword>template</span><span class=special><</span><span class=keyword>typename </span><span class=identifier>T2</span><span class=special>> | |
270 | </span><span class=keyword>void operator</span><span class=special>()(</span><span class=identifier>T2 </span><span class=keyword>const</span><span class=special>& </span><span class=identifier>val</span><span class=special>) </span><span class=keyword>const | |
271 | </span><span class=special>{ | |
272 | </span><span class=identifier>act</span><span class=special>(</span><span class=identifier>ref</span><span class=special>, </span><span class=identifier>val</span><span class=special>);</span><span class="comment"> // defined in ActionT</span><span class=identifier> | |
273 | </span><span class=special>} | |
274 | ||
275 | </span><span class=keyword>template</span><span class=special><</span><span class=keyword>typename </span><span class=identifier>IteratorT</span><span class=special>> | |
276 | </span><span class=keyword>void operator</span><span class=special>()( | |
277 | </span><span class=identifier>IteratorT </span><span class=keyword>const</span><span class=special>& </span><span class=identifier>first</span><span class=special>, | |
278 | </span><span class=identifier>IteratorT </span><span class=keyword>const</span><span class=special>& </span><span class=identifier>last</span><span class=special>) </span><span class=keyword>const | |
279 | </span><span class=special>{ | |
280 | </span><span class=identifier>act</span><span class=special>(</span><span class=identifier>ref</span><span class=special>,</span><span class=identifier>first</span><span class=special>,</span><span class=identifier>last</span><span class=special>);</span><span class="comment"> // defined in ActionT</span><span class=identifier> | |
281 | </span><span class=special>} | |
282 | ||
283 | </span><span class=keyword>private</span><span class=special>: | |
284 | ||
285 | </span><span class=identifier> T</span><span class=special>& </span><span class=identifier>ref</span><span class=special>; | |
286 | };</span></code></pre> | |
287 | <h3>Actor example: <tt>assign_actor</tt></h3> | |
288 | <code> | |
289 | <pre> <span class=comment>// assign_action assigns the parse result to the reference | |
290 | ||
291 | </span><span class=keyword>struct </span><span class=identifier>assign_action | |
292 | </span><span class=special>{ | |
293 | </span><span class=keyword>template</span><span class=special>< | |
294 | </span><span class=keyword>typename </span><span class=identifier>T</span><span class=special>, | |
295 | </span><span class=keyword>typename </span><span class=identifier>ValueT | |
296 | </span><span class=special>> | |
297 | </span><span class=keyword>void </span><span class=identifier>act</span><span class=special>(</span><span class=identifier>T</span><span class=special>& </span><span class=identifier>ref</span><span class=special>, </span><span class=identifier>ValueT </span><span class=keyword>const</span><span class=special>& </span><span class=identifier>value</span><span class=special>) </span><span class=keyword>const | |
298 | </span><span class=special>{ | |
299 | </span><span class=identifier>ref</span><span class=special> = </span><span class=special></span><span class=identifier>value</span><span class=special>; | |
300 | } | |
301 | ||
302 | </span><span class=keyword>template</span><span class=special>< | |
303 | </span><span class=keyword>typename </span><span class=identifier>T</span><span class=special>, | |
304 | </span><span class=keyword>typename </span><span class=identifier>IteratorT | |
305 | </span><span class=special>> | |
306 | </span><span class=keyword>void </span><span class=identifier>act</span><span class=special>( | |
307 | </span><span class=identifier>T</span><span class=special>& </span><span class=identifier>ref</span><span class=special>, | |
308 | </span><span class=identifier>IteratorT </span><span class=keyword>const</span><span class=special>& </span><span class=identifier>first</span><span class=special>, | |
309 | </span><span class=identifier>IteratorT </span><span class=keyword>const</span><span class=special>& </span><span class=identifier>last</span><span class=special>) </span><span class=keyword>const | |
310 | </span><span class=special>{ | |
311 | </span><span class=keyword>typedef </span><span class=keyword>typename </span><span class=identifier>T</span><span class=special>::</span><span class=identifier>value_type </span><span class=identifier>value_type</span><span class=special>; | |
312 | </span><span class=identifier>value_type </span><span class=identifier>vt</span><span class=special>(</span><span class=identifier>first</span><span class=special>,</span><span class=identifier> last</span><span class=special>); | |
313 | </span><span class=identifier>ref</span><span class=special> = </span><span class=special></span><span class=identifier>vt</span><span class=special>; | |
314 | } | |
315 | };</span></pre> | |
316 | </code> | |
317 | <h3>Helper function example: <tt>assign_a</tt> function</h3> | |
318 | <code> | |
319 | <pre> | |
320 | <span class=comment>// assign_a is a polymorphic helper function that generators an | |
321 | // assign_actor based on ref_value_actor, assign_action and the | |
322 | // type of its argument. | |
323 | ||
324 | </span><span class=keyword>template</span><span class=special><</span><span class=keyword>typename </span><span class=identifier>T</span><span class=special>> | |
325 | </span><span class=keyword>inline </span><span class=identifier>ref_value_actor</span><span class=special><</span><span class=identifier>T</span><span class=special>, </span>assign<span class=identifier>_action</span><span class=special>></span><span class=identifier> | |
326 | assign_a</span><span class=special>(</span><span class=identifier>T</span><span class=special>& </span><span class=identifier>ref</span><span class=special>) | |
327 | { | |
328 | </span><span class=keyword>return </span><span class=identifier>ref_value_actor</span><span class=special><</span><span class=identifier>T</span><span class=special>,</span><span class=identifier> assign_action</span><span class=special>>(</span><span class=identifier>ref</span><span class=special>); | |
329 | }</span></pre> | |
330 | </code> | |
331 | <table border="0"> | |
332 | <tr> | |
333 | <td width="30"><a href="../index.html"><img src="theme/u_arr.gif" border="0"></a></td> | |
334 | <td width="30"><a href="indepth_the_parser_context.html"><img src="theme/l_arr.gif" width="20" height="19" border="0"></a></td> | |
335 | <td width="20"><a href="parametric_parsers.html"><img src="theme/r_arr.gif" width="20" height="19" border="0"></a></td> | |
336 | </tr> | |
337 | </table> | |
338 | <br> | |
339 | <hr size="1"> | |
340 | <p class="copyright">Copyright © 2003 <font color="#666666">Jonathan de Halleux</font><font size="2"><font size="2"><font color="#666666"> | |
341 | </font></font> </font><br> | |
342 | Copyright © 2003 Joel de Guzman<br> | |
343 | <br> | |
344 | <font size="2">Use, modification and distribution is subject to the Boost Software License, Version 1.0. (See accompanying file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) </font> </p> | |
345 | </body> | |
346 | </html> |