A Discrete-Event Network Simulator
API
command-line-example.cc
Go to the documentation of this file.
1/* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
2/*
3 * Copyright (c) 2013 Lawrence Livermore National Laboratory
4 *
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License version 2 as
7 * published by the Free Software Foundation;
8 *
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
13 *
14 * You should have received a copy of the GNU General Public License
15 * along with this program; if not, write to the Free Software
16 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17 *
18 * Author: Peter D. Barnes, Jr. <pdbarnes@llnl.gov>
19 */
20
21#include <iostream>
22#include <iomanip>
23#include <string>
24
25#include "ns3/core-module.h"
26
34using namespace ns3;
35
36namespace {
37
42std::string g_cbArg = "cbArg default";
43
51bool SetCbArg (std::string val)
52{
53 g_cbArg = val;
54 return true;
55}
56
57} // unnamed namespace
58
59
60int main (int argc, char *argv[])
61{
62
63 int intArg = 1;
64 bool boolArg = false;
65 std::string strArg = "strArg default";
66 // Attribute path
67 const std::string attrClass = "ns3::RandomVariableStream";
68 const std::string attrName = "Antithetic";
69 const std::string attrPath = attrClass + "::" + attrName;
70 // Non-option arguments
71 int nonOpt1 = 1;
72 int nonOpt2 = 1;
73
74 // Cache the initial values. Normally one wouldn't do this,
75 // but we want to demonstrate that CommandLine has changed them.
76 const int intDef = intArg;
77 const bool boolDef = boolArg;
78 const std::string strDef = strArg;
79 const std::string cbDef = g_cbArg;
80 // Look up default value for attribute
81 const TypeId tid = TypeId::LookupByName (attrClass);
82 std::string attrDef;
83 {
85 tid.LookupAttributeByName (attrName, &info);
86 attrDef = info.originalInitialValue->SerializeToString (info.checker);
87 }
88 const int nonOpt1Def = nonOpt1;
89 const int nonOpt2Def = nonOpt2;
90
91
92 CommandLine cmd (__FILE__);
93 cmd.Usage ("CommandLine example program.\n"
94 "\n"
95 "This little program demonstrates how to use CommandLine.");
96 cmd.AddValue ("intArg", "an int argument", intArg);
97 cmd.AddValue ("boolArg", "a bool argument", boolArg);
98 cmd.AddValue ("strArg", "a string argument", strArg);
99 cmd.AddValue ("anti", attrPath);
100 cmd.AddValue ("cbArg", "a string via callback", MakeCallback (SetCbArg));
101 cmd.AddNonOption ("nonOpt1", "first non-option", nonOpt1);
102 cmd.AddNonOption ("nonOpt2", "second non-option", nonOpt2);
103 cmd.Parse (argc, argv);
104
105 // Show initial values:
106 std::cout << std::endl;
107 std::cout << cmd.GetName () << ":" << std::endl;
108
109 //Print the source version used to build this example
110 std::cout << "Program Version: ";
111 cmd.PrintVersion (std::cout);
112 std::cout << std::endl;
113
114 std::cout << "Initial values:" << std::endl;
115
116 std::cout << std::left << std::setw (10) << "intArg:"
117 << intDef
118 << std::endl;
119 std::cout << std::setw (10) << "boolArg:"
120 << std::boolalpha << boolDef << std::noboolalpha
121 << std::endl;
122
123 std::cout << std::setw (10) << "strArg:"
124 << "\"" << strDef << "\""
125 << std::endl;
126 std::cout << std::setw (10) << "anti:"
127 << "\"" << attrDef << "\""
128 << std::endl;
129 std::cout << std::setw (10) << "cbArg:"
130 << "\"" << cbDef << "\""
131 << std::endl;
132 std::cout << std::left << std::setw (10) << "nonOpt1:"
133 << nonOpt1Def
134 << std::endl;
135 std::cout << std::left << std::setw (10) << "nonOpt2:"
136 << nonOpt2Def
137 << std::endl;
138 std::cout << std::endl;
139
140
141 // Show final values
142 std::cout << "Final values:" << std::endl;
143 std::cout << std::left << std::setw (10) << "intArg:"
144 << intArg
145 << std::endl;
146 std::cout << std::setw (10) << "boolArg:"
147 << std::boolalpha << boolArg << std::noboolalpha
148 << std::endl;
149
150 std::cout << std::setw (10) << "strArg:"
151 << "\"" << strArg << "\""
152 << std::endl;
153
154 // Look up new default value for attribute
155 {
157 tid.LookupAttributeByName (attrName, &info);
158
159 std::cout << std::setw (10) << "anti:"
160 << "\""
161 << info.initialValue->SerializeToString (info.checker)
162 << "\""
163 << std::endl;
164 }
165 std::cout << std::setw (10) << "cbArg:"
166 << "\"" << g_cbArg << "\""
167 << std::endl;
168 std::cout << std::left << std::setw (10) << "nonOpt1:"
169 << nonOpt1
170 << std::endl;
171 std::cout << std::left << std::setw (10) << "nonOpt2:"
172 << nonOpt2
173 << std::endl;
174 std::cout << std::left << "Number of extra non-option arguments:"
175 << cmd.GetNExtraNonOptions ()
176 << std::endl;
177
178 for (std::size_t i = 0; i < cmd.GetNExtraNonOptions (); ++i)
179 {
180 std::cout << std::left << std::setw (10) << "extra:"
181 << "\"" << cmd.GetExtraNonOption (i) << "\""
182 << std::endl;
183 }
184
185
186 return 0;
187}
Parse command-line arguments.
Definition: command-line.h:229
a unique identifier for an interface.
Definition: type-id.h:59
bool LookupAttributeByName(std::string name, struct AttributeInformation *info) const
Find an Attribute by name, retrieving the associated AttributeInformation.
Definition: type-id.cc:882
bool SetCbArg(std::string val)
Function to illustrate command line arguments handled by a Callback function.
std::string g_cbArg
Global variable to illustrate command line arguments handled by a Callback function.
Every class exported by the ns3 library is enclosed in the ns3 namespace.
Callback< R, Ts... > MakeCallback(R(T::*memPtr)(Ts...), OBJ objPtr)
Build Callbacks for class method members which take varying numbers of arguments and potentially retu...
Definition: callback.h:1648
cmd
Definition: second.py:35
Attribute implementation.
Definition: type-id.h:78