root/library/doc/html/user__info_8h-source.html @ 398

Revision 398, 41.0 kB (checked in by smidl, 15 years ago)

doc 2

Line 
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
3<title>mixpp: user_info.h Source File</title>
4<link href="tabs.css" rel="stylesheet" type="text/css">
5<link href="doxygen.css" rel="stylesheet" type="text/css">
6</head><body>
7<!-- Generated by Doxygen 1.5.8 -->
8<script type="text/javascript">
9<!--
10function changeDisplayState (e){
11  var num=this.id.replace(/[^[0-9]/g,'');
12  var button=this.firstChild;
13  var sectionDiv=document.getElementById('dynsection'+num);
14  if (sectionDiv.style.display=='none'||sectionDiv.style.display==''){
15    sectionDiv.style.display='block';
16    button.src='open.gif';
17  }else{
18    sectionDiv.style.display='none';
19    button.src='closed.gif';
20  }
21}
22function initDynSections(){
23  var divs=document.getElementsByTagName('div');
24  var sectionCounter=1;
25  for(var i=0;i<divs.length-1;i++){
26    if(divs[i].className=='dynheader'&&divs[i+1].className=='dynsection'){
27      var header=divs[i];
28      var section=divs[i+1];
29      var button=header.firstChild;
30      if (button!='IMG'){
31        divs[i].insertBefore(document.createTextNode(' '),divs[i].firstChild);
32        button=document.createElement('img');
33        divs[i].insertBefore(button,divs[i].firstChild);
34      }
35      header.style.cursor='pointer';
36      header.onclick=changeDisplayState;
37      header.id='dynheader'+sectionCounter;
38      button.src='closed.gif';
39      section.id='dynsection'+sectionCounter;
40      section.style.display='none';
41      section.style.marginLeft='14px';
42      sectionCounter++;
43    }
44  }
45}
46window.onload = initDynSections;
47-->
48</script>
49<div class="navigation" id="top">
50  <div class="tabs">
51    <ul>
52      <li><a href="main.html"><span>Main&nbsp;Page</span></a></li>
53      <li><a href="pages.html"><span>Related&nbsp;Pages</span></a></li>
54      <li><a href="modules.html"><span>Modules</span></a></li>
55      <li><a href="annotated.html"><span>Classes</span></a></li>
56      <li class="current"><a href="files.html"><span>Files</span></a></li>
57    </ul>
58  </div>
59  <div class="tabs">
60    <ul>
61      <li><a href="files.html"><span>File&nbsp;List</span></a></li>
62      <li><a href="globals.html"><span>File&nbsp;Members</span></a></li>
63    </ul>
64  </div>
65<h1>user_info.h</h1><a href="user__info_8h.html">Go to the documentation of this file.</a><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001
66<a name="l00014"></a>00014 <span class="preprocessor">#ifndef USER_INFO_H</span>
67<a name="l00015"></a>00015 <span class="preprocessor"></span><span class="preprocessor">#define USER_INFO_H</span>
68<a name="l00016"></a>00016 <span class="preprocessor"></span>
69<a name="l00017"></a>00017 <span class="preprocessor">#include &lt;stdio.h&gt;</span>
70<a name="l00018"></a>00018 <span class="preprocessor">#include &lt;string&gt;</span>
71<a name="l00019"></a>00019 <span class="preprocessor">#include &lt;typeinfo&gt;</span>
72<a name="l00020"></a>00020 <span class="preprocessor">#include &lt;map&gt;</span>
73<a name="l00021"></a>00021 <span class="preprocessor">#include &lt;stdexcept&gt;</span>
74<a name="l00022"></a>00022
75<a name="l00023"></a>00023 <span class="preprocessor">#include "libconfig/libconfig.h++"</span>
76<a name="l00024"></a>00024 <span class="preprocessor">#include "../bdmroot.h"</span>
77<a name="l00025"></a>00025 <span class="preprocessor">#include "itpp/itbase.h"</span>
78<a name="l00026"></a>00026
79<a name="l00027"></a>00027
80<a name="l00028"></a>00028 <span class="keyword">using</span> std::string;
81<a name="l00029"></a>00029 <span class="keyword">using namespace </span>std;
82<a name="l00030"></a>00030 <span class="keyword">using namespace </span>libconfig;
83<a name="l00031"></a>00031
84<a name="l00032"></a>00032 <span class="keyword">namespace </span>bdm
85<a name="l00033"></a>00033 {
86<a name="l00034"></a>00034         
87<a name="l00044"></a>00044 <span class="preprocessor">#ifndef BDMLIB </span>
88<a name="l00045"></a><a class="code" href="user__info_8h.html#4f9de2f17e844047726487b99def99c6">00045</a> <span class="preprocessor"></span><span class="preprocessor">        #define UIREGISTER(class_name) template&lt;&gt; const ParticularUI&lt;class_name&gt;&amp; ParticularUI&lt;class_name&gt;::factory = ParticularUI&lt;class_name&gt;(#class_name) </span>
89<a name="l00046"></a>00046 <span class="preprocessor"></span><span class="preprocessor">#else</span>
90<a name="l00047"></a>00047 <span class="preprocessor"></span><span class="preprocessor">        #define UIREGISTER(class_name)</span>
91<a name="l00048"></a>00048 <span class="preprocessor"></span><span class="preprocessor">#endif</span>
92<a name="l00049"></a>00049 <span class="preprocessor"></span>
93<a name="l00051"></a><a class="code" href="classbdm_1_1UIException.html">00051</a> <span class="keyword">class </span><a class="code" href="classbdm_1_1UIException.html" title="Exception prepared for reporting user-info errors which are always related to some...">UIException</a> : <span class="keyword">public</span> std::exception
94<a name="l00052"></a>00052 {
95<a name="l00053"></a>00053 <span class="keyword">private</span>:
96<a name="l00055"></a>00055         <span class="keyword">const</span> <span class="keywordtype">string</span> message;
97<a name="l00056"></a>00056
98<a name="l00057"></a>00057 <span class="keyword">public</span>:
99<a name="l00059"></a><a class="code" href="classbdm_1_1UIException.html#351bfe4a6e8d0288500e3412313f3301">00059</a>         <a class="code" href="classbdm_1_1UIException.html#351bfe4a6e8d0288500e3412313f3301" title="Use this constructor when you can pass the problematical Setting as a parameter.">UIException</a>( <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;message, <span class="keyword">const</span> Setting &amp;element  )
100<a name="l00060"></a>00060                 : message( <span class="stringliteral">"UI error: "</span> + message + <span class="stringliteral">". Check path \""</span> + string(element.getPath()) + <span class="stringliteral">"\"."</span> )
101<a name="l00061"></a>00061         {
102<a name="l00062"></a>00062         }
103<a name="l00063"></a>00063
104<a name="l00065"></a><a class="code" href="classbdm_1_1UIException.html#691e5563c06a1d4d9e02e01a1a187dae">00065</a>         <a class="code" href="classbdm_1_1UIException.html#351bfe4a6e8d0288500e3412313f3301" title="Use this constructor when you can pass the problematical Setting as a parameter.">UIException</a>( <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;message, <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;path  )
105<a name="l00066"></a>00066                 : message( <span class="stringliteral">"UI error: "</span> + message + <span class="stringliteral">"! Check path \""</span> + path + <span class="stringliteral">"\"."</span> )
106<a name="l00067"></a>00067         {
107<a name="l00068"></a>00068         }
108<a name="l00069"></a>00069
109<a name="l00071"></a><a class="code" href="classbdm_1_1UIException.html#1bf477e4ea19abb638fe5b883f09218e">00071</a>         <span class="keyword">virtual</span> <span class="keyword">const</span> <span class="keywordtype">char</span>* <a class="code" href="classbdm_1_1UIException.html#1bf477e4ea19abb638fe5b883f09218e" title="Overriden method for reporting an error message.">what</a>() <span class="keyword">const</span> throw()
110<a name="l00072"></a>00072         {
111<a name="l00073"></a>00073                 <span class="keywordflow">return</span> message.c_str();
112<a name="l00074"></a>00074         }
113<a name="l00075"></a>00075 };
114<a name="l00076"></a>00076
115<a name="l00077"></a>00077
116<a name="l00100"></a><a class="code" href="classbdm_1_1UIFile.html">00100</a> <span class="keyword">class </span><a class="code" href="classbdm_1_1UIFile.html" title="This class serves to load and/or save user-infos into/from configuration files stored...">UIFile</a> : <span class="keyword">public</span> Config
117<a name="l00101"></a>00101 {
118<a name="l00102"></a>00102 <span class="keyword">public</span>:
119<a name="l00104"></a>00104         <a class="code" href="classbdm_1_1UIFile.html#77274c827f87f16bd6671df8a0cc1e33" title="Create empty file instance prepared to store Settings.">UIFile</a>();
120<a name="l00105"></a>00105
121<a name="l00107"></a>00107         <a class="code" href="classbdm_1_1UIFile.html#77274c827f87f16bd6671df8a0cc1e33" title="Create empty file instance prepared to store Settings.">UIFile</a>( <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;file_name );
122<a name="l00108"></a>00108
123<a name="l00110"></a>00110         <span class="keywordtype">void</span> <a class="code" href="classbdm_1_1UIFile.html#1f8af28a0d8ef1a4956e198df0beb5ba" title="Save all the stored Settings into the configuration file file_name.">save</a>(<span class="keyword">const</span> <span class="keywordtype">string</span> &amp;file_name);
124<a name="l00111"></a>00111
125<a name="l00113"></a>00113         <a class="code" href="classbdm_1_1UIFile.html#5bce10d88c71f6147d58baa8400ff61f" title="This operator allows the ability of substituting Setting parameter by UIFile instance...">operator Setting&amp;</a>();
126<a name="l00114"></a>00114 };
127<a name="l00115"></a>00115
128<a name="l00180"></a><a class="code" href="classbdm_1_1SettingResolver.html">00180</a> <span class="keyword">class </span><a class="code" href="classbdm_1_1SettingResolver.html" title="This class serves to expand links used within configuration files.">SettingResolver</a> : <a class="code" href="classbdm_1_1root.html" title="Root class of BDM objects.">root</a>
129<a name="l00181"></a>00181 {
130<a name="l00182"></a>00182 <span class="keyword">private</span>:
131<a name="l00184"></a>00184         <a class="code" href="classbdm_1_1UIFile.html" title="This class serves to load and/or save user-infos into/from configuration files stored...">UIFile</a> *file;
132<a name="l00185"></a>00185
133<a name="l00191"></a>00191         <span class="keyword">const</span> Setting &amp;initialize_reference( <a class="code" href="classbdm_1_1UIFile.html" title="This class serves to load and/or save user-infos into/from configuration files stored...">UIFile</a>* &amp;file, <span class="keyword">const</span> Setting &amp;potential_link);
134<a name="l00192"></a>00192
135<a name="l00193"></a>00193 <span class="keyword">public</span>:
136<a name="l00195"></a><a class="code" href="classbdm_1_1SettingResolver.html#adfcd0a81d025c52c8335b6aea07b498">00195</a>         <span class="keyword">const</span> Setting &amp;<a class="code" href="classbdm_1_1SettingResolver.html#adfcd0a81d025c52c8335b6aea07b498" title="Reference to a resolved link or to the original Setting in the case it does not contain...">result</a>;
137<a name="l00196"></a>00196
138<a name="l00198"></a>00198         <a class="code" href="classbdm_1_1SettingResolver.html#e2299746b95bf8af54a867aaf52fc8da" title="If potential_link contains a link to some other setting, it is resolved here. Anyway...">SettingResolver</a>( <span class="keyword">const</span> Setting &amp;potential_link );
139<a name="l00199"></a>00199         
140<a name="l00201"></a>00201         <a class="code" href="classbdm_1_1SettingResolver.html#c8b29999710e2db98c1a3979e25e6bbc" title="An opened UIFile file is closed here if necessary.">~SettingResolver</a>();             
141<a name="l00202"></a>00202 };
142<a name="l00203"></a>00203
143<a name="l00211"></a><a class="code" href="classbdm_1_1UI.html">00211</a> <span class="keyword">class </span><a class="code" href="classbdm_1_1UI.html" title="UI is an abstract class and it is intended for internal purposes only.">UI</a> 
144<a name="l00212"></a>00212 {
145<a name="l00213"></a>00213 <span class="keyword">private</span>:
146<a name="l00219"></a>00219         <span class="keyword">class </span>MappedUI
147<a name="l00220"></a>00220         {
148<a name="l00221"></a>00221         <span class="keyword">private</span>:
149<a name="l00223"></a>00223                 <span class="keyword">typedef</span> map&lt; const string, const UI* const &gt; StringToUIMap;
150<a name="l00224"></a>00224
151<a name="l00226"></a>00226                 <span class="keyword">typedef</span> map&lt; const type_info * const, const string &gt; TypeInfoToStringMap;
152<a name="l00227"></a>00227
153<a name="l00229"></a>00229                 <span class="keyword">static</span> StringToUIMap&amp; mapped_strings();
154<a name="l00230"></a>00230
155<a name="l00232"></a>00232                 <span class="keyword">static</span> TypeInfoToStringMap&amp; mapped_type_infos();
156<a name="l00233"></a>00233
157<a name="l00235"></a>00235                 <span class="keyword">static</span> <span class="keywordtype">void</span> unregistered_class_error( <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;unregistered_class_name );
158<a name="l00236"></a>00236
159<a name="l00237"></a>00237         <span class="keyword">public</span>:
160<a name="l00239"></a>00239                 <span class="keyword">static</span> <span class="keywordtype">void</span> add_class( <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;class_name, <span class="keyword">const</span> type_info * <span class="keyword">const</span> class_type_info, <span class="keyword">const</span> <a class="code" href="classbdm_1_1UI.html" title="UI is an abstract class and it is intended for internal purposes only.">UI</a>* <span class="keyword">const</span> ui );
161<a name="l00240"></a>00240
162<a name="l00242"></a>00242                 <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="classbdm_1_1UI.html" title="UI is an abstract class and it is intended for internal purposes only.">UI</a>&amp; retrieve_ui( <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;class_name );
163<a name="l00243"></a>00243
164<a name="l00245"></a>00245                 <span class="keyword">static</span> <span class="keyword">const</span> <span class="keywordtype">string</span>&amp; retrieve_class_name( <span class="keyword">const</span> type_info* <span class="keyword">const</span> class_type_info );
165<a name="l00246"></a>00246         };
166<a name="l00247"></a>00247
167<a name="l00249"></a>00249         <span class="keyword">static</span> <span class="keywordtype">void</span> assert_type( <span class="keyword">const</span> Setting &amp;element, Setting::Type type);
168<a name="l00250"></a>00250
169<a name="l00252"></a>00252         <span class="keyword">virtual</span> <a class="code" href="classbdm_1_1root.html" title="Root class of BDM objects.">root</a>* new_instance() <span class="keyword">const</span> = 0;
170<a name="l00253"></a>00253         
171<a name="l00255"></a>00255         <span class="keyword">static</span> <span class="keyword">const</span> Setting&amp; to_child_setting( <span class="keyword">const</span> Setting &amp;element, <span class="keyword">const</span> <span class="keywordtype">int</span> index );
172<a name="l00256"></a>00256
173<a name="l00258"></a>00258         <span class="keyword">static</span> <span class="keyword">const</span> Setting&amp; to_child_setting( <span class="keyword">const</span> Setting &amp;element, <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;name );
174<a name="l00259"></a>00259
175<a name="l00261"></a>00261         <span class="keyword">static</span> <span class="keywordtype">void</span> from_setting( mat&amp; matrix, <span class="keyword">const</span> Setting &amp;element );       
176<a name="l00263"></a>00263         <span class="keyword">static</span> <span class="keywordtype">void</span> from_setting( ivec &amp;vector, <span class="keyword">const</span> Setting &amp;element );
177<a name="l00265"></a>00265         <span class="keyword">static</span> <span class="keywordtype">void</span> from_setting( <span class="keywordtype">string</span> &amp;<a class="code" href="classbdm_1_1str.html" title="Structure of RV (used internally), i.e. expanded RVs - TODO tak proc je ve verejnem...">str</a>, <span class="keyword">const</span> Setting &amp;element );
178<a name="l00267"></a>00267         <span class="keyword">static</span> <span class="keywordtype">void</span> from_setting( vec &amp;vector, <span class="keyword">const</span> Setting &amp;element );
179<a name="l00269"></a>00269         <span class="keyword">static</span> <span class="keywordtype">void</span> from_setting( <span class="keywordtype">int</span> &amp;integer, <span class="keyword">const</span> Setting &amp;element );
180<a name="l00271"></a>00271         <span class="keyword">static</span> <span class="keywordtype">void</span> from_setting( <span class="keywordtype">double</span> &amp;real, <span class="keyword">const</span> Setting &amp;element );
181<a name="l00273"></a>00273         <span class="keyword">template</span>&lt;<span class="keyword">class</span> T&gt; <span class="keyword">static</span> <span class="keywordtype">void</span> from_setting( T* &amp;instance, <span class="keyword">const</span> Setting &amp;element )
182<a name="l00274"></a>00274         {                       
183<a name="l00275"></a>00275                 <span class="keyword">const</span> <a class="code" href="classbdm_1_1SettingResolver.html" title="This class serves to expand links used within configuration files.">SettingResolver</a> link( element );
184<a name="l00276"></a>00276                 assert_type(link.<a class="code" href="classbdm_1_1SettingResolver.html#adfcd0a81d025c52c8335b6aea07b498" title="Reference to a resolved link or to the original Setting in the case it does not contain...">result</a>,Setting::TypeGroup);
185<a name="l00277"></a>00277
186<a name="l00278"></a>00278                 <span class="comment">// we get a value stored in the "class" attribute </span>
187<a name="l00279"></a>00279                 <span class="keywordtype">string</span> class_name;
188<a name="l00280"></a>00280                 <span class="keywordflow">if</span>( !link.<a class="code" href="classbdm_1_1SettingResolver.html#adfcd0a81d025c52c8335b6aea07b498" title="Reference to a resolved link or to the original Setting in the case it does not contain...">result</a>.lookupValue( <span class="stringliteral">"class"</span>, class_name ) )
189<a name="l00281"></a>00281                         <span class="keywordflow">throw</span> <a class="code" href="classbdm_1_1UIException.html" title="Exception prepared for reporting user-info errors which are always related to some...">UIException</a>( <span class="stringliteral">"the obligatory \"class\" identifier is missing"</span>, link.<a class="code" href="classbdm_1_1SettingResolver.html#adfcd0a81d025c52c8335b6aea07b498" title="Reference to a resolved link or to the original Setting in the case it does not contain...">result</a> );
190<a name="l00282"></a>00282         
191<a name="l00283"></a>00283                 <span class="comment">// then we find a user-info related to this type</span>
192<a name="l00284"></a>00284                 <span class="keyword">const</span> <a class="code" href="classbdm_1_1UI.html" title="UI is an abstract class and it is intended for internal purposes only.">UI</a>&amp; related_UI = MappedUI::retrieve_ui( class_name );
193<a name="l00285"></a>00285                 
194<a name="l00286"></a>00286                 <a class="code" href="classbdm_1_1root.html" title="Root class of BDM objects.">root</a>* typeless_instance = related_UI.<a class="code" href="classbdm_1_1UI.html#77291f28a4b951522ae5f6a03121b635" title="Method assembling a typeless instance, it is implemented in descendant class ParticularUI&amp;lt;T&amp;gt;...">new_instance</a>();
195<a name="l00287"></a>00287
196<a name="l00288"></a>00288                 instance = <span class="keyword">dynamic_cast&lt;</span>T*<span class="keyword">&gt;</span>(typeless_instance);
197<a name="l00289"></a>00289                 <span class="keywordflow">if</span> (!instance)
198<a name="l00290"></a>00290                         <span class="keywordflow">throw</span> <a class="code" href="classbdm_1_1UIException.html" title="Exception prepared for reporting user-info errors which are always related to some...">UIException</a>( <span class="stringliteral">"class "</span> + class_name + <span class="stringliteral">" is not a descendant of the desired output class. Try to call the UI::build&lt;T&gt; function with a different type parameter."</span>, link.<a class="code" href="classbdm_1_1SettingResolver.html#adfcd0a81d025c52c8335b6aea07b498" title="Reference to a resolved link or to the original Setting in the case it does not contain...">result</a> );
199<a name="l00291"></a>00291                 
200<a name="l00292"></a>00292                 <span class="keywordflow">try</span>
201<a name="l00293"></a>00293                 {
202<a name="l00294"></a>00294                         instance-&gt;from_setting( link.<a class="code" href="classbdm_1_1SettingResolver.html#adfcd0a81d025c52c8335b6aea07b498" title="Reference to a resolved link or to the original Setting in the case it does not contain...">result</a> );
203<a name="l00295"></a>00295                 }
204<a name="l00296"></a>00296                 <span class="keywordflow">catch</span>(SettingException xcptn)
205<a name="l00297"></a>00297                 {
206<a name="l00298"></a>00298                         <span class="keywordflow">throw</span> <a class="code" href="classbdm_1_1UIException.html" title="Exception prepared for reporting user-info errors which are always related to some...">UIException</a>( <span class="stringliteral">"the method "</span> + class_name + <span class="stringliteral">".from_setting(Setting&amp;) has thrown an SettingException. Try to correct this method"</span>, xcptn.getPath());
207<a name="l00299"></a>00299                 }
208<a name="l00300"></a>00300         }       
209<a name="l00301"></a>00301
210<a name="l00303"></a>00303         <span class="keyword">template</span>&lt;<span class="keyword">class</span> T&gt; <span class="keyword">static</span> <span class="keywordtype">void</span> from_setting( Array&lt;T&gt; &amp;array_to_load, <span class="keyword">const</span> Setting &amp;element )
211<a name="l00304"></a>00304         {
212<a name="l00305"></a>00305                 <span class="keyword">const</span> <a class="code" href="classbdm_1_1SettingResolver.html" title="This class serves to expand links used within configuration files.">SettingResolver</a> link( element );
213<a name="l00306"></a>00306
214<a name="l00307"></a>00307                 assert_type(link.<a class="code" href="classbdm_1_1SettingResolver.html#adfcd0a81d025c52c8335b6aea07b498" title="Reference to a resolved link or to the original Setting in the case it does not contain...">result</a>,Setting::TypeList);
215<a name="l00308"></a>00308
216<a name="l00309"></a>00309                 <span class="keywordtype">int</span> len = link.<a class="code" href="classbdm_1_1SettingResolver.html#adfcd0a81d025c52c8335b6aea07b498" title="Reference to a resolved link or to the original Setting in the case it does not contain...">result</a>.getLength();
217<a name="l00310"></a>00310                 array_to_load.set_length( len );
218<a name="l00311"></a>00311                 <span class="keywordflow">if</span>( len == 0 ) <span class="keywordflow">return</span>;
219<a name="l00312"></a>00312                 
220<a name="l00313"></a>00313                 <span class="keywordflow">for</span>( <span class="keywordtype">int</span> i=0; i &lt; len; i++ )
221<a name="l00314"></a>00314                         from_setting( array_to_load(i), link.<a class="code" href="classbdm_1_1SettingResolver.html#adfcd0a81d025c52c8335b6aea07b498" title="Reference to a resolved link or to the original Setting in the case it does not contain...">result</a>[i] );
222<a name="l00315"></a>00315         }
223<a name="l00316"></a>00316
224<a name="l00317"></a>00317 <span class="keyword">protected</span>:
225<a name="l00319"></a><a class="code" href="classbdm_1_1UI.html#d60234c0673f345424329894b9b0cef8">00319</a>         <a class="code" href="classbdm_1_1UI.html#d60234c0673f345424329894b9b0cef8" title="Default constructor for internal use only, see.">UI</a>( <span class="keyword">const</span> <span class="keywordtype">string</span>&amp; class_name, <span class="keyword">const</span> type_info * <span class="keyword">const</span> class_type_info )
226<a name="l00320"></a>00320         {       
227<a name="l00321"></a>00321                 MappedUI::add_class( class_name, class_type_info, <span class="keyword">this</span> );
228<a name="l00322"></a>00322         }
229<a name="l00323"></a>00323
230<a name="l00324"></a>00324 <span class="keyword">public</span>:
231<a name="l00325"></a>00325
232<a name="l00329"></a>00329
233<a name="l00331"></a><a class="code" href="classbdm_1_1UI.html#dda27449f8bd19d54db9ccfb2644e908">00331</a>         <span class="keyword">template</span>&lt;<span class="keyword">class</span> T&gt; <span class="keyword">static</span> T* <a class="code" href="classbdm_1_1UI.html#dda27449f8bd19d54db9ccfb2644e908" title="The new instance of type T* is constructed and initialized with values stored in...">build</a>( <span class="keyword">const</span> Setting &amp;element, <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;name )
234<a name="l00332"></a>00332         {                       
235<a name="l00333"></a>00333                 T* instance;
236<a name="l00334"></a>00334                 from_setting&lt;T&gt;( instance, to_child_setting( element, name ) );
237<a name="l00335"></a>00335                 <span class="keywordflow">return</span> instance;
238<a name="l00336"></a>00336         }
239<a name="l00338"></a><a class="code" href="classbdm_1_1UI.html#f0eccc7bbe4b680f3e1cb84b455a1125">00338</a>         <span class="keyword">template</span>&lt;<span class="keyword">class</span> T&gt; <span class="keyword">static</span> T* <a class="code" href="classbdm_1_1UI.html#dda27449f8bd19d54db9ccfb2644e908" title="The new instance of type T* is constructed and initialized with values stored in...">build</a>( <span class="keyword">const</span> Setting &amp;element, <span class="keyword">const</span> <span class="keywordtype">int</span> index )
240<a name="l00339"></a>00339         {
241<a name="l00340"></a>00340                 T* instance;
242<a name="l00341"></a>00341                 from_setting&lt;T&gt;( instance, to_child_setting( element, index ) );
243<a name="l00342"></a>00342                 <span class="keywordflow">return</span> instance;
244<a name="l00343"></a>00343         }
245<a name="l00345"></a><a class="code" href="classbdm_1_1UI.html#6e2da6a142fecf5f21e0bb86a7211cb4">00345</a>         <span class="keyword">template</span>&lt;<span class="keyword">class</span> T&gt; <span class="keyword">static</span> T* <a class="code" href="classbdm_1_1UI.html#dda27449f8bd19d54db9ccfb2644e908" title="The new instance of type T* is constructed and initialized with values stored in...">build</a>( <span class="keyword">const</span> Setting &amp;element )
246<a name="l00346"></a>00346         {
247<a name="l00347"></a>00347                 T* instance;
248<a name="l00348"></a>00348                 from_setting&lt;T&gt;( instance,  element );
249<a name="l00349"></a>00349                 <span class="keywordflow">return</span> instance;
250<a name="l00350"></a>00350         }
251<a name="l00352"></a>00352
252<a name="l00356"></a>00356
253<a name="l00358"></a><a class="code" href="classbdm_1_1UI.html#652bfd23f5052e4f1cb317057d74a3e2">00358</a>         <span class="keyword">template</span>&lt;<span class="keyword">class</span> T&gt; <span class="keyword">static</span> <span class="keywordtype">void</span> <span class="keyword">get</span>( T &amp;instance, <span class="keyword">const</span> Setting &amp;element, <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;name )
254<a name="l00359"></a>00359         {
255<a name="l00360"></a>00360                 from_setting( instance, to_child_setting( element, name ) );
256<a name="l00361"></a>00361         }
257<a name="l00362"></a>00362
258<a name="l00364"></a><a class="code" href="classbdm_1_1UI.html#3d04bb3d7dbcf0da0b4d5d3d5b7df51a">00364</a>         <span class="keyword">template</span>&lt;<span class="keyword">class</span> T&gt; <span class="keyword">static</span> <span class="keywordtype">void</span> <span class="keyword">get</span>( T &amp;instance, <span class="keyword">const</span> Setting &amp;element, <span class="keyword">const</span> <span class="keywordtype">int</span> index )
259<a name="l00365"></a>00365         {
260<a name="l00366"></a>00366                 from_setting( instance, to_child_setting( element, index ) );
261<a name="l00367"></a>00367         }
262<a name="l00368"></a>00368
263<a name="l00370"></a><a class="code" href="classbdm_1_1UI.html#25747ac6d0232aa7102dbb316f65ddce">00370</a>         <span class="keyword">template</span>&lt;<span class="keyword">class</span> T&gt; <span class="keyword">static</span> <span class="keywordtype">void</span> <span class="keyword">get</span>( T &amp;instance, <span class="keyword">const</span> Setting &amp;element  )
264<a name="l00371"></a>00371         {
265<a name="l00372"></a>00372                 from_setting( instance, element );
266<a name="l00373"></a>00373         }
267<a name="l00375"></a>00375
268<a name="l00379"></a>00379
269<a name="l00381"></a><a class="code" href="classbdm_1_1UI.html#00bb5f2a328d272b0a3ffbda1a902d54">00381</a>         <span class="keyword">template</span>&lt;<span class="keyword">class</span> T&gt; <span class="keyword">static</span> <span class="keywordtype">void</span> <span class="keyword">get</span>( Array&lt;T&gt; &amp;array_to_load, <span class="keyword">const</span> Setting &amp;element, <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;name )
270<a name="l00382"></a>00382         {
271<a name="l00383"></a>00383                 from_setting( array_to_load, to_child_setting( element, name ) );
272<a name="l00384"></a>00384         }
273<a name="l00385"></a>00385
274<a name="l00387"></a><a class="code" href="classbdm_1_1UI.html#b6a224b6aea027e167d3d565b39144e0">00387</a>         <span class="keyword">template</span>&lt;<span class="keyword">class</span> T&gt; <span class="keyword">static</span> <span class="keywordtype">void</span> <span class="keyword">get</span>( Array&lt;T&gt; &amp;array_to_load, <span class="keyword">const</span> Setting &amp;element, <span class="keyword">const</span> <span class="keywordtype">int</span> index )
275<a name="l00388"></a>00388         {
276<a name="l00389"></a>00389                 from_setting( array_to_load, to_child_setting( element, index ) );
277<a name="l00390"></a>00390         }
278<a name="l00391"></a>00391
279<a name="l00393"></a><a class="code" href="classbdm_1_1UI.html#4fc5efdc58e4e184218b6d5beeb5ceab">00393</a>         <span class="keyword">template</span>&lt;<span class="keyword">class</span> T&gt; <span class="keyword">static</span> <span class="keywordtype">void</span> <span class="keyword">get</span>( Array&lt;T&gt; &amp;array_to_load, <span class="keyword">const</span> Setting &amp;element  )
280<a name="l00394"></a>00394         {
281<a name="l00395"></a>00395                 from_setting( array_to_load, element );
282<a name="l00396"></a>00396         }
283<a name="l00398"></a>00398
284<a name="l00403"></a>00403
285<a name="l00405"></a><a class="code" href="classbdm_1_1UI.html#c83987949e6a9e79d6e093797ab7d917">00405</a>         <span class="keyword">template</span>&lt; <span class="keyword">class</span> T&gt; <span class="keyword">static</span> <span class="keywordtype">void</span> <a class="code" href="classbdm_1_1UI.html#c83987949e6a9e79d6e093797ab7d917" title="A root descendant instance is stored in the new child Setting appended to the passed...">save</a>( <span class="keyword">const</span> T * <span class="keyword">const</span> instance, Setting &amp;element, <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;name = <span class="stringliteral">""</span>)
286<a name="l00406"></a>00406         {
287<a name="l00407"></a>00407                 Setting &amp;<span class="keyword">set</span> = (name == <span class="stringliteral">""</span>) ? element.add( Setting::TypeGroup )                                                 
288<a name="l00408"></a>00408                                                                          : element.add( name, Setting::TypeGroup );             
289<a name="l00409"></a>00409
290<a name="l00410"></a>00410                 <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;class_name = MappedUI::retrieve_class_name( &amp;<span class="keyword">typeid</span>(*instance) );
291<a name="l00411"></a>00411                         
292<a name="l00412"></a>00412                 <span class="comment">// add attribute "class" </span>
293<a name="l00413"></a>00413                 Setting &amp;type = <span class="keyword">set</span>.add( <span class="stringliteral">"class"</span>, Setting::TypeString );
294<a name="l00414"></a>00414                 type = class_name;
295<a name="l00415"></a>00415
296<a name="l00416"></a>00416                 <span class="keywordflow">try</span>
297<a name="l00417"></a>00417                 {
298<a name="l00418"></a>00418                         instance-&gt;to_setting( <span class="keyword">set</span> );
299<a name="l00419"></a>00419                 }
300<a name="l00420"></a>00420                 <span class="keywordflow">catch</span>(SettingException xcptn)
301<a name="l00421"></a>00421                 {
302<a name="l00422"></a>00422                         <span class="keywordflow">throw</span> <a class="code" href="classbdm_1_1UIException.html" title="Exception prepared for reporting user-info errors which are always related to some...">UIException</a>( <span class="stringliteral">"the method "</span> + class_name + <span class="stringliteral">".to_setting(Setting&amp;) has thrown an SettingException. Try to correct this method"</span>, xcptn.getPath());
303<a name="l00423"></a>00423                 }       
304<a name="l00424"></a>00424         }
305<a name="l00425"></a>00425
306<a name="l00427"></a><a class="code" href="classbdm_1_1UI.html#4514f93573a9d9126c506d176fbd3163">00427</a>         <span class="keyword">template</span>&lt;<span class="keyword">class</span> T&gt; <span class="keyword">static</span> <span class="keywordtype">void</span> <a class="code" href="classbdm_1_1UI.html#c83987949e6a9e79d6e093797ab7d917" title="A root descendant instance is stored in the new child Setting appended to the passed...">save</a>( <span class="keyword">const</span> Array&lt;T&gt; &amp;array_to_save, Setting &amp;element, <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;name = <span class="stringliteral">""</span> )
307<a name="l00428"></a>00428         {
308<a name="l00429"></a>00429                 assert_type(element,Setting::TypeGroup);
309<a name="l00430"></a>00430                 Setting &amp;list = (name == <span class="stringliteral">""</span>) ? element.add( Setting::TypeList )                                                 
310<a name="l00431"></a>00431                                                                          : element.add( name, Setting::TypeList );             
311<a name="l00432"></a>00432                 <span class="keywordflow">for</span>( <span class="keywordtype">int</span> i=0; i&lt;array_to_save.length(); i++ )
312<a name="l00433"></a>00433                         <a class="code" href="classbdm_1_1UI.html#c83987949e6a9e79d6e093797ab7d917" title="A root descendant instance is stored in the new child Setting appended to the passed...">save</a>( array_to_save(i), list );
313<a name="l00434"></a>00434         }
314<a name="l00435"></a>00435
315<a name="l00437"></a>00437         <span class="keyword">static</span> <span class="keywordtype">void</span> <a class="code" href="classbdm_1_1UI.html#c83987949e6a9e79d6e093797ab7d917" title="A root descendant instance is stored in the new child Setting appended to the passed...">save</a>( <span class="keyword">const</span> mat &amp;matrix, Setting &amp;element, <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;name = <span class="stringliteral">""</span> );
316<a name="l00438"></a>00438
317<a name="l00440"></a>00440         <span class="keyword">static</span> <span class="keywordtype">void</span> <a class="code" href="classbdm_1_1UI.html#c83987949e6a9e79d6e093797ab7d917" title="A root descendant instance is stored in the new child Setting appended to the passed...">save</a>( <span class="keyword">const</span> ivec &amp;vec, Setting &amp;element, <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;name = <span class="stringliteral">""</span> );
318<a name="l00441"></a>00441         
319<a name="l00443"></a>00443         <span class="keyword">static</span> <span class="keywordtype">void</span> <a class="code" href="classbdm_1_1UI.html#c83987949e6a9e79d6e093797ab7d917" title="A root descendant instance is stored in the new child Setting appended to the passed...">save</a>( <span class="keyword">const</span> vec &amp;vector, Setting &amp;element, <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;name = <span class="stringliteral">""</span> );
320<a name="l00444"></a>00444
321<a name="l00446"></a>00446         <span class="keyword">static</span> <span class="keywordtype">void</span> <a class="code" href="classbdm_1_1UI.html#c83987949e6a9e79d6e093797ab7d917" title="A root descendant instance is stored in the new child Setting appended to the passed...">save</a>( <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;str, Setting &amp;element, <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;name = <span class="stringliteral">""</span> );
322<a name="l00447"></a>00447
323<a name="l00449"></a>00449         <span class="keyword">static</span> <span class="keywordtype">void</span> <a class="code" href="classbdm_1_1UI.html#c83987949e6a9e79d6e093797ab7d917" title="A root descendant instance is stored in the new child Setting appended to the passed...">save</a>( <span class="keyword">const</span> <span class="keywordtype">int</span> &amp;integer, Setting &amp;element, <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;name = <span class="stringliteral">""</span> );
324<a name="l00450"></a>00450
325<a name="l00452"></a>00452         <span class="keyword">static</span> <span class="keywordtype">void</span> <a class="code" href="classbdm_1_1UI.html#c83987949e6a9e79d6e093797ab7d917" title="A root descendant instance is stored in the new child Setting appended to the passed...">save</a>( <span class="keyword">const</span> <span class="keywordtype">double</span> &amp;real, Setting &amp;element, <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;name = <span class="stringliteral">""</span> );     
326<a name="l00454"></a>00454
327<a name="l00455"></a>00455 };
328<a name="l00456"></a>00456
329<a name="l00457"></a>00457
330<a name="l00459"></a><a class="code" href="classbdm_1_1ParticularUI.html">00459</a> <span class="keyword">template</span>&lt;<span class="keyword">typename</span> T&gt; <span class="keyword">class </span><a class="code" href="classbdm_1_1ParticularUI.html" title="The only UI descendant class which is not intended for direct use. It should be accessed...">ParticularUI</a> : <span class="keyword">private</span> <a class="code" href="classbdm_1_1UI.html" title="UI is an abstract class and it is intended for internal purposes only.">UI</a>
331<a name="l00460"></a>00460 {
332<a name="l00461"></a>00461 <span class="keyword">private</span>:
333<a name="l00463"></a>00463         <a class="code" href="classbdm_1_1ParticularUI.html" title="The only UI descendant class which is not intended for direct use. It should be accessed...">ParticularUI&lt;T&gt;</a>( <span class="keyword">const</span> <span class="keywordtype">string</span> &amp;class_name) : <a class="code" href="classbdm_1_1UI.html#d60234c0673f345424329894b9b0cef8" title="Default constructor for internal use only, see.">UI</a>( class_name, &amp;<span class="keyword">typeid</span>(T) )
334<a name="l00464"></a><a class="code" href="classbdm_1_1ParticularUI.html#18a208b7549160ae6aeb884dc2bcd90f">00464</a>         {};
335<a name="l00465"></a>00465
336<a name="l00466"></a>00466 <span class="keyword">public</span>:
337<a name="l00468"></a>00468         <span class="keyword">static</span> <span class="keyword">const</span> <a class="code" href="classbdm_1_1ParticularUI.html" title="The only UI descendant class which is not intended for direct use. It should be accessed...">ParticularUI&lt;T&gt;</a>&amp; <a class="code" href="classbdm_1_1ParticularUI.html#18a208b7549160ae6aeb884dc2bcd90f" title="The only instance of this class (each type T has its own instance) which is used...">factory</a>
338<a name="l00469"></a>00469
339<a name="l00471"></a><a class="code" href="classbdm_1_1ParticularUI.html#a14fea8c7372a3d0a736e4ed0b617702">00471</a>         <a class="code" href="classbdm_1_1root.html" title="Root class of BDM objects.">root</a>* <a class="code" href="classbdm_1_1ParticularUI.html#a14fea8c7372a3d0a736e4ed0b617702" title="A method returning a brand new instance of class T, this method is the reason why...">new_instance</a>()<span class="keyword"> const</span>
340<a name="l00472"></a>00472 <span class="keyword">        </span>{
341<a name="l00473"></a>00473                 <span class="keywordflow">return</span> <span class="keyword">new</span> T();
342<a name="l00474"></a>00474         }
343<a name="l00475"></a>00475 };
344<a name="l00476"></a>00476
345<a name="l00477"></a>00477 }
346<a name="l00478"></a>00478
347<a name="l00479"></a>00479 <span class="preprocessor">#endif // #ifndef USER_INFO_H</span>
348</pre></div></div>
349<hr size="1"><address style="text-align: right;"><small>Generated on Wed Jun 24 21:53:04 2009 for mixpp by&nbsp;
350<a href="http://www.doxygen.org/index.html">
351<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
352</body>
353</html>
Note: See TracBrowser for help on using the browser.