<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html><head><meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"> <title>GNU CommonC++: cmdlineopt.cpp</title> <link href="doxygen.css" rel="stylesheet" type="text/css"> <link href="tabs.css" rel="stylesheet" type="text/css"> </head><body> <!-- Generated by Doxygen 1.4.6 --> <div class="tabs"> <ul> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="namespaces.html"><span>Namespaces</span></a></li> <li><a href="classes.html"><span>Classes</span></a></li> <li><a href="files.html"><span>Files</span></a></li> <li><a href="pages.html"><span>Related Pages</span></a></li> <li><a href="examples.html"><span>Examples</span></a></li> </ul></div> <h1>cmdlineopt.cpp</h1><div class="fragment"><pre class="fragment"><a name="l00001"></a>00001 <span class="comment">// Copyright (C) 2001 Gianni Mariani</span> <a name="l00002"></a>00002 <span class="comment">//</span> <a name="l00003"></a>00003 <span class="comment">// This program is free software; you can redistribute it and/or modify</span> <a name="l00004"></a>00004 <span class="comment">// it under the terms of the GNU General Public License as published by</span> <a name="l00005"></a>00005 <span class="comment">// the Free Software Foundation; either version 2 of the License, or</span> <a name="l00006"></a>00006 <span class="comment">// (at your option) any later version.</span> <a name="l00007"></a>00007 <span class="comment">//</span> <a name="l00008"></a>00008 <span class="comment">// This program is distributed in the hope that it will be useful,</span> <a name="l00009"></a>00009 <span class="comment">// but WITHOUT ANY WARRANTY; without even the implied warranty of</span> <a name="l00010"></a>00010 <span class="comment">// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the</span> <a name="l00011"></a>00011 <span class="comment">// GNU General Public License for more details.</span> <a name="l00012"></a>00012 <span class="comment">//</span> <a name="l00013"></a>00013 <span class="comment">// You should have received a copy of the GNU General Public License</span> <a name="l00014"></a>00014 <span class="comment">// along with this program; if not, write to the Free Software</span> <a name="l00015"></a>00015 <span class="comment">// Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.</span> <a name="l00016"></a>00016 <span class="comment">//</span> <a name="l00017"></a>00017 <span class="comment">// As a special exception to the GNU General Public License, permission is</span> <a name="l00018"></a>00018 <span class="comment">// granted for additional uses of the text contained in its release</span> <a name="l00019"></a>00019 <span class="comment">// of Common C++.</span> <a name="l00020"></a>00020 <span class="comment">//</span> <a name="l00021"></a>00021 <span class="comment">// The exception is that, if you link the Common C++ library with other</span> <a name="l00022"></a>00022 <span class="comment">// files to produce an executable, this does not by itself cause the</span> <a name="l00023"></a>00023 <span class="comment">// resulting executable to be covered by the GNU General Public License.</span> <a name="l00024"></a>00024 <span class="comment">// Your use of that executable is in no way restricted on account of</span> <a name="l00025"></a>00025 <span class="comment">// linking the Common C++ library code into it.</span> <a name="l00026"></a>00026 <span class="comment">//</span> <a name="l00027"></a>00027 <span class="comment">// This exception does not however invalidate any other reasons why</span> <a name="l00028"></a>00028 <span class="comment">// the executable file might be covered by the GNU General Public License.</span> <a name="l00029"></a>00029 <span class="comment">//</span> <a name="l00030"></a>00030 <span class="comment">// This exception applies only to the code released under the</span> <a name="l00031"></a>00031 <span class="comment">// name Common C++. If you copy code from other releases into a copy of</span> <a name="l00032"></a>00032 <span class="comment">// Common C++, as the General Public License permits, the exception does</span> <a name="l00033"></a>00033 <span class="comment">// not apply to the code that you add in this way. To avoid misleading</span> <a name="l00034"></a>00034 <span class="comment">// anyone as to the status of such modified files, you must delete</span> <a name="l00035"></a>00035 <span class="comment">// this exception notice from them.</span> <a name="l00036"></a>00036 <span class="comment">//</span> <a name="l00037"></a>00037 <span class="comment">// If you write modifications of your own for Common C++, it is your choice</span> <a name="l00038"></a>00038 <span class="comment">// whether to permit this exception to apply to your modifications.</span> <a name="l00039"></a>00039 <span class="comment">// If you do not wish that, delete this exception notice.</span> <a name="l00040"></a>00040 <span class="comment">//</span> <a name="l00041"></a>00041 <a name="l00042"></a>00042 <a name="l00043"></a>00043 <span class="comment">//</span> <a name="l00044"></a>00044 <span class="comment">// Example for Common C++ the command line parser interface.</span> <a name="l00045"></a>00045 <span class="comment">//</span> <a name="l00046"></a>00046 <span class="comment">// </span> <a name="l00047"></a>00047 <span class="comment">// This exmaple code shows how to use the command line parser provided by</span> <a name="l00048"></a>00048 <span class="comment">// CommonC++. The command line parser provides an interface which is</span> <a name="l00049"></a>00049 <span class="comment">// "object oriented" such that command line parameters are true "objects".</span> <a name="l00050"></a>00050 <span class="comment">//</span> <a name="l00051"></a>00051 <span class="comment">// Each command line option needs to be created. By defining "CommandOption"s</span> <a name="l00052"></a>00052 <span class="comment">// statically, the C++ constructor is called when the objects are loaded and</span> <a name="l00053"></a>00053 <span class="comment">// before the "main" function is called. The constructor links itself to</span> <a name="l00054"></a>00054 <span class="comment">// a list of other CommandOptionXXX in the list provided. If no</span> <a name="l00055"></a>00055 <span class="comment">// list is specified in the constructor, a default one is used. Because of</span> <a name="l00056"></a>00056 <span class="comment">// the undefined nature as to the order in which constructors are called,</span> <a name="l00057"></a>00057 <span class="comment">// no assumption as to the order in which the CommandOptionXXX constructors</span> <a name="l00058"></a>00058 <span class="comment">// are called should be made.</span> <a name="l00059"></a>00059 <span class="comment">//</span> <a name="l00060"></a>00060 <span class="comment">// CommandOptionXXX classes can be used to derive specialized parameter</span> <a name="l00061"></a>00061 <span class="comment">// classes that are specific to applications. The second example shows</span> <a name="l00062"></a>00062 <span class="comment">// just how this can be done.</span> <a name="l00063"></a>00063 <span class="comment">//</span> <a name="l00064"></a>00064 <a name="l00065"></a>00065 <span class="comment">//</span> <a name="l00066"></a>00066 <span class="comment">// Include the CommandOption definitions</span> <a name="l00067"></a>00067 <span class="comment">//</span> <a name="l00068"></a>00068 <span class="preprocessor">#include <<a class="code" href="common_8h.html">cc++/common.h</a>></span> <a name="l00069"></a>00069 <a name="l00070"></a>00070 <span class="preprocessor">#include <iostream></span> <a name="l00071"></a>00071 <a name="l00072"></a>00072 <span class="preprocessor">#ifdef CCXX_NAMESPACES</span> <a name="l00073"></a>00073 <span class="preprocessor"></span><span class="keyword">using namespace </span>std; <a name="l00074"></a>00074 <span class="keyword">using namespace </span>ost; <a name="l00075"></a>00075 <span class="preprocessor">#endif </span> <a name="l00076"></a>00076 <span class="preprocessor"></span> <a name="l00077"></a>00077 <span class="comment">//</span> <a name="l00078"></a>00078 <span class="comment">// The following definition of options all use the list header</span> <a name="l00079"></a>00079 <span class="comment">// defaultCommandOptionList (which is specified as the value of the</span> <a name="l00080"></a>00080 <span class="comment">// default parameter in the constructor. This convention would</span> <a name="l00081"></a>00081 <span class="comment">// allow other object files to link into the same list and add parameters</span> <a name="l00082"></a>00082 <span class="comment">// to the command line of this executable.</span> <a name="l00083"></a>00083 <a name="l00084"></a>00084 <a name="_a5"></a><a class="code" href="classost_1_1_command_option_arg.html">CommandOptionArg</a> test_option1( <a name="l00085"></a>00085 <span class="stringliteral">"test_option1"</span>, <span class="stringliteral">"p"</span>, <span class="stringliteral">"This option takes an argument"</span>, <span class="keyword">true</span> <a name="l00086"></a>00086 ); <a name="l00087"></a>00087 <a name="l00088"></a>00088 <a name="_a6"></a><a class="code" href="classost_1_1_command_option_no_arg.html">CommandOptionNoArg</a> test_noarg( <a name="l00089"></a>00089 <span class="stringliteral">"test_noarg"</span>, <span class="stringliteral">"b"</span>, <span class="stringliteral">"This option does not take an argument"</span> <a name="l00090"></a>00090 ); <a name="l00091"></a>00091 <a name="l00092"></a>00092 <a class="code" href="classost_1_1_command_option_no_arg.html">CommandOptionNoArg</a> helparg( <a name="l00093"></a>00093 <span class="stringliteral">"help"</span>, <span class="stringliteral">"?"</span>, <span class="stringliteral">"Print help usage"</span> <a name="l00094"></a>00094 ); <a name="l00095"></a>00095 <a name="l00096"></a>00096 <a name="_a7"></a><a class="code" href="classost_1_1_command_option_collect.html">CommandOptionCollect</a> restoargs( <a name="l00097"></a>00097 0, 0, <span class="stringliteral">"Collect all the parameters"</span>, <span class="keyword">true</span> <a name="l00098"></a>00098 ); <a name="l00099"></a>00099 <a name="l00100"></a>00100 <a name="l00101"></a>00101 <span class="comment">//</span> <a name="l00102"></a>00102 <span class="comment">// Normally this would me the regular main(). In this example</span> <a name="l00103"></a>00103 <span class="comment">// this processes the first command option list.</span> <a name="l00104"></a>00104 <span class="comment">//</span> <a name="l00105"></a>00105 <span class="keywordtype">int</span> Example_main( <span class="keywordtype">int</span> argc, <span class="keywordtype">char</span> ** argv ) <a name="l00106"></a>00106 { <a name="l00107"></a>00107 <a name="l00108"></a>00108 <span class="comment">// Create a CommandOptionParse object. This takes the</span> <a name="l00109"></a>00109 <span class="comment">// defaultCommandOptionList and parses the command line arguments.</span> <a name="l00110"></a>00110 <span class="comment">// </span> <a name="l00111"></a>00111 <a name="_a8"></a><a class="code" href="classost_1_1_command_option_parse.html">CommandOptionParse</a> * args = <a name="a9"></a><a class="code" href="namespaceost.html#9c8722a3e68ba930b72211f47eacc5eb">makeCommandOptionParse</a>( <a name="l00112"></a>00112 argc, argv, <a name="l00113"></a>00113 <span class="stringliteral">"CommonC++ command like option interface. This is example\n"</span> <a name="l00114"></a>00114 <span class="stringliteral">" code only."</span> <a name="l00115"></a>00115 ); <a name="l00116"></a>00116 <a name="l00117"></a>00117 <span class="comment">// If the user requested help then suppress all the usage error</span> <a name="l00118"></a>00118 <span class="comment">// messages.</span> <a name="l00119"></a>00119 <span class="keywordflow">if</span> ( helparg.numSet ) { <a name="l00120"></a>00120 cerr << args-><a name="a10"></a><a class="code" href="classost_1_1_command_option_parse.html#7dc375ddeff083528d143a1ffdb67e16">printUsage</a>(); <a name="l00121"></a>00121 ::exit(0); <a name="l00122"></a>00122 } <a name="l00123"></a>00123 <a name="l00124"></a>00124 <span class="comment">// Print usage your way.</span> <a name="l00125"></a>00125 <span class="keywordflow">if</span> ( args-><a name="a11"></a><a class="code" href="classost_1_1_command_option_parse.html#f8f0828a668ba000ea6ecc4de1d2c5b3">argsHaveError</a>() ) { <a name="l00126"></a>00126 cerr << args-><a name="a12"></a><a class="code" href="classost_1_1_command_option_parse.html#f2176dfc5ec12e3b4fb9f39334f5173a">printErrors</a>(); <a name="l00127"></a>00127 cerr << args-><a class="code" href="classost_1_1_command_option_parse.html#7dc375ddeff083528d143a1ffdb67e16">printUsage</a>(); <a name="l00128"></a>00128 ::exit(1); <a name="l00129"></a>00129 } <a name="l00130"></a>00130 <a name="l00131"></a>00131 <span class="comment">// Go off and run any option specific task</span> <a name="l00132"></a>00132 args-><a name="a13"></a><a class="code" href="classost_1_1_command_option_parse.html#060afd8cbb6e8395191cef1cb68520ea">performTask</a>(); <a name="l00133"></a>00133 <a name="l00134"></a>00134 <span class="comment">// print all the -p options</span> <a name="l00135"></a>00135 <span class="keywordflow">for</span> ( <span class="keywordtype">int</span> i = 0; i < test_option1.numValue; i ++ ) { <a name="l00136"></a>00136 cerr << <span class="stringliteral">"test_option1 = "</span> << test_option1.values[ i ] << endl; <a name="l00137"></a>00137 } <a name="l00138"></a>00138 <a name="l00139"></a>00139 <span class="comment">// print all the other options.</span> <a name="l00140"></a>00140 <span class="keywordflow">for</span> ( <span class="keywordtype">int</span> i = 0; i < restoargs.numValue; i ++ ) { <a name="l00141"></a>00141 cerr << <span class="stringliteral">"restoargs "</span> << i << <span class="stringliteral">" : "</span> << restoargs.values[ i ] << endl; <a name="l00142"></a>00142 } <a name="l00143"></a>00143 <a name="l00144"></a>00144 <span class="keyword">delete</span> args; <a name="l00145"></a>00145 <a name="l00146"></a>00146 <span class="keywordflow">return</span> 0; <a name="l00147"></a>00147 } <a name="l00148"></a>00148 <a name="l00149"></a>00149 <a name="l00150"></a>00150 <span class="comment">// </span> <a name="l00151"></a>00151 <span class="comment">// This shows how to build a second option list. The example is similar to</span> <a name="l00152"></a>00152 <span class="comment">// the first as well as it shows how to derive a new command object.</span> <a name="l00153"></a>00153 <span class="comment">//</span> <a name="l00154"></a>00154 <a name="l00155"></a>00155 <a name="_a14"></a><a class="code" href="classost_1_1_command_option.html">CommandOption</a> * TestList = 0; <a name="l00156"></a>00156 <a name="l00157"></a>00157 <span class="keyword">extern</span> <a name="_a15"></a><a class="code" href="classost_1_1_command_option_rest.html">CommandOptionRest</a> test_restoargs; <a name="l00158"></a>00158 <a name="l00159"></a>00159 <a name="l00160"></a>00160 <span class="preprocessor">#include <unistd.h></span> <a name="l00161"></a>00161 <span class="preprocessor">#include <sys/types.h></span> <a name="l00162"></a>00162 <span class="preprocessor">#include <sys/stat.h></span> <a name="l00163"></a>00163 <span class="preprocessor">#include <fcntl.h></span> <a name="l00164"></a>00164 <span class="preprocessor">#include <strstream></span> <a name="l00165"></a>00165 <span class="preprocessor">#include <errno.h></span> <a name="l00166"></a>00166 <span class="preprocessor">#include <<a class="code" href="string_8h.html">string.h</a>></span> <a name="l00167"></a>00167 <span class="preprocessor">#include <stdlib.h></span> <a name="l00168"></a>00168 <span class="preprocessor">#include <sys/wait.h></span> <a name="l00169"></a>00169 <a name="l00170"></a>00170 <a name="l00171"></a>00171 <span class="comment">//</span> <a name="l00172"></a>00172 <span class="comment">// This is a parameter class derived from CommandOptionArg that takes</span> <a name="l00173"></a>00173 <span class="comment">// a file name parameter and detects wether the file is accessible</span> <a name="l00174"></a>00174 <span class="comment">// flagging an error if the file is inaccessible to read.</span> <a name="l00175"></a>00175 <span class="comment">//</span> <a name="l00176"></a>00176 <span class="keyword">class </span>file_option : <span class="keyword">public</span> <a class="code" href="classost_1_1_command_option_arg.html">CommandOptionArg</a> { <a name="l00177"></a>00177 <span class="keyword">public</span>: <a name="l00178"></a>00178 <a name="l00179"></a>00179 <span class="comment">// the constructor calls the regular CommandOptionArg constructor</span> <a name="l00180"></a>00180 <span class="comment">// and all should be well.</span> <a name="l00181"></a>00181 file_option( <a name="l00182"></a>00182 <span class="keyword">const</span> <span class="keywordtype">char</span> * in_option_name, <a name="l00183"></a>00183 <span class="keyword">const</span> <span class="keywordtype">char</span> * in_option_letter, <a name="l00184"></a>00184 <span class="keyword">const</span> <span class="keywordtype">char</span> * in_description, <a name="l00185"></a>00185 <span class="keywordtype">bool</span> in_required = <span class="keyword">false</span>, <a name="l00186"></a>00186 <a class="code" href="classost_1_1_command_option.html">CommandOption</a> ** pp_next = & <a name="a16"></a><a class="code" href="namespaceost.html#3b701311bbf7cf16f954820e316f5766">defaultCommandOptionList</a> <a name="l00187"></a>00187 ) <a name="l00188"></a>00188 : <a class="code" href="classost_1_1_command_option_arg.html">CommandOptionArg</a>( <a name="l00189"></a>00189 in_option_name, <a name="l00190"></a>00190 in_option_letter, <a name="l00191"></a>00191 in_description, <a name="l00192"></a>00192 in_required, <a name="l00193"></a>00193 pp_next <a name="l00194"></a>00194 ) <a name="l00195"></a>00195 { <a name="l00196"></a>00196 } <a name="l00197"></a>00197 <a name="l00198"></a>00198 <span class="comment">//</span> <a name="l00199"></a>00199 <span class="comment">// When parsing is done check if the file is accessible and register</span> <a name="l00200"></a>00200 <span class="comment">// an error with the CommandOptionParse object to let it know so.</span> <a name="l00201"></a>00201 <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a name="a17"></a><a class="code" href="classost_1_1_command_option.html#1cc99afcc775ca21d16c38a0661839a2">parseDone</a>( <a class="code" href="classost_1_1_command_option_parse.html">CommandOptionParse</a> * cop ) <a name="l00202"></a>00202 { <a name="l00203"></a>00203 <span class="keywordflow">if</span> ( numValue ) { <a name="l00204"></a>00204 <span class="keywordflow">if</span> ( ::access( values[ numValue - 1 ], R_OK ) ) { <a name="l00205"></a>00205 <span class="keywordtype">int</span> errno_s = errno; <a name="l00206"></a>00206 strstream msg; <a name="l00207"></a>00207 msg << <span class="stringliteral">"Error: "</span> << optionName << <span class="stringliteral">" '"</span> << values[ numValue - 1 ]; <a name="l00208"></a>00208 msg << <span class="stringliteral">"' : "</span> << ::strerror( errno_s ); <a name="l00209"></a>00209 <a name="l00210"></a>00210 cop-><a name="a18"></a><a class="code" href="classost_1_1_command_option_parse.html#1ca17c61a4e4c8f40102cfafed61702a">registerError</a>( msg.str() ); <a name="l00211"></a>00211 } <a name="l00212"></a>00212 } <a name="l00213"></a>00213 } <a name="l00214"></a>00214 <a name="l00215"></a>00215 <span class="comment">//</span> <a name="l00216"></a>00216 <span class="comment">// Open said file. Do some operations on things - like open the file.</span> <a name="l00217"></a>00217 <span class="keywordtype">int</span> OpenFile() <a name="l00218"></a>00218 { <a name="l00219"></a>00219 <span class="comment">// Should put in way more error handling here ...</span> <a name="l00220"></a>00220 return ::open( values[ numValue - 1 ], O_RDONLY ); <a name="l00221"></a>00221 } <a name="l00222"></a>00222 <a name="l00223"></a>00223 <span class="comment">//</span> <a name="l00224"></a>00224 <span class="comment">// The most elaborate way to spit the contents of a file</span> <a name="l00225"></a>00225 <span class="comment">// to standard output.</span> <a name="l00226"></a>00226 pid_t pid; <a name="l00227"></a>00227 <span class="keyword">virtual</span> <span class="keywordtype">void</span> <a name="a19"></a><a class="code" href="classost_1_1_command_option.html#f52fe62b7a0d3c40b726fa2447cb3b78">performTask</a>( <a class="code" href="classost_1_1_command_option_parse.html">CommandOptionParse</a> * cop ) <a name="l00228"></a>00228 { <a name="l00229"></a>00229 pid = ::fork(); <a name="l00230"></a>00230 <a name="l00231"></a>00231 <span class="keywordflow">if</span> ( pid ) { <a name="l00232"></a>00232 <span class="keywordflow">return</span>; <a name="l00233"></a>00233 } <a name="l00234"></a>00234 <a name="l00235"></a>00235 <span class="keywordtype">int</span> fd = OpenFile(); <a name="l00236"></a>00236 <span class="keywordflow">if</span> ( fd < 0 ) { <a name="l00237"></a>00237 <span class="keywordtype">int</span> errno_s = errno; <a name="l00238"></a>00238 cerr <a name="l00239"></a>00239 << <span class="stringliteral">"Error: '"</span> <a name="l00240"></a>00240 << values[ numValue - 1 ] <a name="l00241"></a>00241 << <span class="stringliteral">"' : "</span> <a name="l00242"></a>00242 << ::strerror( errno_s ) <a name="l00243"></a>00243 ; <a name="l00244"></a>00244 <a name="l00245"></a>00245 ::exit( 1 ); <a name="l00246"></a>00246 } <a name="l00247"></a>00247 dup2(fd, 0); <a name="l00248"></a>00248 ::execvp( test_restoargs.<a name="a20"></a><a class="code" href="classost_1_1_command_option_with_arg.html#5ccc2d9deb4a248d8414193385a1fc09">values</a>[0], (<span class="keywordtype">char</span>**) test_restoargs.<a class="code" href="classost_1_1_command_option_with_arg.html#5ccc2d9deb4a248d8414193385a1fc09">values</a> ); <a name="l00249"></a>00249 ::exit(1); <a name="l00250"></a>00250 } <a name="l00251"></a>00251 <a name="l00252"></a>00252 ~file_option() <a name="l00253"></a>00253 { <a name="l00254"></a>00254 <span class="keywordflow">if</span> ( pid <= 0 ) <span class="keywordflow">return</span>; <a name="l00255"></a>00255 <span class="keywordtype">int</span> status;<a name="a21"></a><a class="code" href="namespaceost.html#24c7774639b3768bdd45b65a296f6369"></a> <a name="l00256"></a>00256 <a class="code" href="namespaceost.html#24c7774639b3768bdd45b65a296f6369"> ::wait</a>(&status); <a name="l00257"></a>00257 } <a name="l00258"></a>00258 }; <a name="l00259"></a>00259 <a name="l00260"></a>00260 <a name="l00261"></a>00261 <span class="comment">//</span> <a name="l00262"></a>00262 <span class="comment">// This is the linked list head for the options in the second example.</span> <a name="l00263"></a>00263 <span class="comment">// Note that the first example used the default value defined in the</span> <a name="l00264"></a>00264 <span class="comment">// method. Here it is explicitly specified as TestList in all the following</span> <a name="l00265"></a>00265 <span class="comment">// CommandOption constructors.</span> <a name="l00266"></a>00266 <a name="l00267"></a>00267 file_option test_file( <a name="l00268"></a>00268 <span class="stringliteral">"test_file"</span>, <span class="stringliteral">"f"</span>, <span class="stringliteral">"Filename to read from"</span>, <span class="keyword">true</span>, &TestList <a name="l00269"></a>00269 ); <a name="l00270"></a>00270 <a name="l00271"></a>00271 <a class="code" href="classost_1_1_command_option_no_arg.html">CommandOptionNoArg</a> test_xnoarg( <a name="l00272"></a>00272 <span class="stringliteral">"test_xnoarg"</span>, <span class="stringliteral">"b"</span>, <span class="stringliteral">"This option does not take an argument"</span>, <span class="keyword">false</span>, &TestList <a name="l00273"></a>00273 ); <a name="l00274"></a>00274 <a name="l00275"></a>00275 <a class="code" href="classost_1_1_command_option_no_arg.html">CommandOptionNoArg</a> test_helparg( <a name="l00276"></a>00276 <span class="stringliteral">"help"</span>, <span class="stringliteral">"?"</span>, <span class="stringliteral">"Print help usage"</span>, <span class="keyword">false</span>, &TestList <a name="l00277"></a>00277 ); <a name="l00278"></a>00278 <a name="l00279"></a>00279 <a class="code" href="classost_1_1_command_option_rest.html">CommandOptionRest</a> test_restoargs( <a name="l00280"></a>00280 0, 0, <span class="stringliteral">"Command to be executed"</span>, <span class="keyword">true</span>, &TestList <a name="l00281"></a>00281 ); <a name="l00282"></a>00282 <a name="l00283"></a>00283 <span class="comment">//</span> <a name="l00284"></a>00284 <span class="comment">// in most apps this would be the regular "main" function.</span> <a name="l00285"></a>00285 <span class="keywordtype">int</span> Test_main( <span class="keywordtype">int</span> argc, <span class="keywordtype">char</span> ** argv ) <a name="l00286"></a>00286 { <a name="l00287"></a>00287 <a class="code" href="classost_1_1_command_option_parse.html">CommandOptionParse</a> * args = <a class="code" href="namespaceost.html#9c8722a3e68ba930b72211f47eacc5eb">makeCommandOptionParse</a>( <a name="l00288"></a>00288 argc, argv, <a name="l00289"></a>00289 <span class="stringliteral">"Command line parser X test.\n"</span> <a name="l00290"></a>00290 <span class="stringliteral">" This example is executed when the command ends in 'x'\n"</span> <a name="l00291"></a>00291 <span class="stringliteral">" It shows how the -f parameter can be specialized.\n"</span>, <a name="l00292"></a>00292 TestList <a name="l00293"></a>00293 ); <a name="l00294"></a>00294 <a name="l00295"></a>00295 <span class="comment">// If the user requested help then suppress all the usage error</span> <a name="l00296"></a>00296 <span class="comment">// messages.</span> <a name="l00297"></a>00297 <span class="keywordflow">if</span> ( test_helparg.numSet ) { <a name="l00298"></a>00298 cerr << args-><a class="code" href="classost_1_1_command_option_parse.html#7dc375ddeff083528d143a1ffdb67e16">printUsage</a>(); <a name="l00299"></a>00299 ::exit(0); <a name="l00300"></a>00300 } <a name="l00301"></a>00301 <a name="l00302"></a>00302 <span class="comment">// Print usage your way.</span> <a name="l00303"></a>00303 <span class="keywordflow">if</span> ( args-><a class="code" href="classost_1_1_command_option_parse.html#f8f0828a668ba000ea6ecc4de1d2c5b3">argsHaveError</a>() ) { <a name="l00304"></a>00304 cerr << args-><a class="code" href="classost_1_1_command_option_parse.html#f2176dfc5ec12e3b4fb9f39334f5173a">printErrors</a>(); <a name="l00305"></a>00305 cerr << <span class="stringliteral">"Get help by --help\n"</span>; <a name="l00306"></a>00306 ::exit(1); <a name="l00307"></a>00307 } <a name="l00308"></a>00308 <a name="l00309"></a>00309 <span class="comment">// Go off and run any option specific task</span> <a name="l00310"></a>00310 args-><a class="code" href="classost_1_1_command_option_parse.html#060afd8cbb6e8395191cef1cb68520ea">performTask</a>(); <a name="l00311"></a>00311 <a name="l00312"></a>00312 <span class="keywordflow">for</span> ( <span class="keywordtype">int</span> i = 0; i < test_file.numValue; i ++ ) { <a name="l00313"></a>00313 cerr << <span class="stringliteral">"test_file = "</span> << test_file.values[ i ] << endl; <a name="l00314"></a>00314 } <a name="l00315"></a>00315 <a name="l00316"></a>00316 <span class="keywordflow">for</span> ( <span class="keywordtype">int</span> i = 0; i < test_restoargs.<a name="a22"></a><a class="code" href="classost_1_1_command_option_with_arg.html#1fdb4121e6a385dd52e6599338019ce7">numValue</a>; i ++ ) { <a name="l00317"></a>00317 cerr << <span class="stringliteral">"test_restoargs "</span> << i << <span class="stringliteral">" : "</span> << test_restoargs.<a class="code" href="classost_1_1_command_option_with_arg.html#5ccc2d9deb4a248d8414193385a1fc09">values</a>[ i ] << endl; <a name="l00318"></a>00318 } <a name="l00319"></a>00319 <a name="l00320"></a>00320 <span class="keyword">delete</span> args; <a name="l00321"></a>00321 <a name="l00322"></a>00322 <span class="keywordflow">return</span> 0; <a name="l00323"></a>00323 } <a name="l00324"></a>00324 <a name="l00325"></a>00325 <a name="l00326"></a>00326 <span class="comment">//</span> <a name="l00327"></a>00327 <span class="comment">// This switches behaviour of this executable depending of wether it is</span> <a name="l00328"></a>00328 <span class="comment">// invoked with a command ending in "x". This is mimicking for example</span> <a name="l00329"></a>00329 <span class="comment">// the behaviour of bunzip2 and bzip2. These executables are THE SAME</span> <a name="l00330"></a>00330 <span class="comment">// file i.e.</span> <a name="l00331"></a>00331 <span class="comment">// 0 lrwxrwxrwx 1 root root 5 Oct 11 14:04 /usr/bin/bunzip2 -> bzip2*</span> <a name="l00332"></a>00332 <span class="comment">// and the behaviour is determined by the executable name.</span> <a name="l00333"></a>00333 <span class="comment">//</span> <a name="l00334"></a>00334 <span class="comment">// This example is way more complex than the way most people will end up</span> <a name="l00335"></a>00335 <span class="comment">// using feature.</span> <a name="l00336"></a>00336 <a name="l00337"></a>00337 <span class="keywordtype">int</span> main( <span class="keywordtype">int</span> argc, <span class="keywordtype">char</span> ** argv ) <a name="l00338"></a>00338 { <a name="l00339"></a>00339 <a name="l00340"></a>00340 <span class="keywordtype">int</span> i = ::strlen( argv[ 0 ] ); <a name="l00341"></a>00341 <a name="l00342"></a>00342 <span class="comment">// determine which real "main" function do I call</span> <a name="l00343"></a>00343 <span class="keywordflow">if</span> ( argv[ 0 ][ i - 1 ] == <span class="charliteral">'x'</span> ) { <a name="l00344"></a>00344 <span class="keywordflow">return</span> Test_main( argc, argv ); <a name="l00345"></a>00345 } <span class="keywordflow">else</span> { <a name="l00346"></a>00346 <span class="keywordflow">return</span> Example_main( argc, argv ); <a name="l00347"></a>00347 } <a name="l00348"></a>00348 <a name="l00349"></a>00349 } </pre></div> <hr size="1"><address style="align: right;"><small>Generated on Mon Jun 19 10:50:55 2006 for GNU CommonC++ by <a href="http://www.doxygen.org/index.html"> <img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.4.6 </small></address> </body> </html>