command-line.h

Go to the documentation of this file.

/* -*- Mode:C++; c-file-style:"gnu"; indent-tabs-mode:nil; -*- */
/*
 * Copyright (c) 2008 INRIA
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 as
 * published by the Free Software Foundation;
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 * Authors: Mathieu Lacage <mathieu.lacage@sophia.inria.fr>
 */
#ifndef COMMAND_LINE_H
#define COMMAND_LINE_H

#include <string>
#include <sstream>
#include <vector>

#include "callback.h"
#include "nstime.h"

namespace ns3 {

class CommandLine
{
public:
  CommandLine (void);
  CommandLine (const std::string filename);
  CommandLine (const CommandLine &cmd);
  CommandLine &operator = (const CommandLine &cmd);
  ~CommandLine ();

  void Usage (const std::string usage);

  template <typename T>
  void AddValue (const std::string &name,
                 const std::string &help,
                 T &value);

  typedef bool (* Callback) (const std::string value);

  void AddValue (const std::string &name,
                 const std::string &help,
                 ns3::Callback<bool, std::string> callback,
                 const std::string defaultValue = "");


  void AddValue (const std::string &name,
                 const std::string &attributePath);

  template <typename T>
  void AddNonOption (const std::string name, const std::string help, T & value);

  std::string GetExtraNonOption (std::size_t i) const;

  std::size_t GetNExtraNonOptions (void) const;

  void Parse (int argc, char *argv[]);

  void Parse (std::vector<std::string> args);

  std::string GetName () const;

  void PrintHelp (std::ostream &os) const;

  std::string GetVersion () const;

  void PrintVersion (std::ostream &os) const;

private:

  class Item
  {
  public:
    std::string m_name;       
    std::string m_help;       
    virtual ~Item ();         
    virtual bool Parse (const std::string value) = 0;
    virtual bool HasDefault () const;
    virtual std::string GetDefault () const = 0;
  };  // class Item

  template <typename T>
  class UserItem : public Item
  {
  public:
    // Inherited
    virtual bool Parse (const std::string value);
    bool HasDefault () const;
    std::string GetDefault () const;

    T *m_valuePtr;            
    std::string m_default;    
  };  // class UserItem

  class StringItem : public Item
  {
  public:
    // Inherited
    bool Parse (const std::string value);
    bool HasDefault (void) const;
    std::string GetDefault (void) const;

    std::string m_value;     
  };  // class StringItem

  class CallbackItem : public Item
  {
  public:
    // Inherited
    bool HasDefault (void) const;
    std::string GetDefault (void) const;

    virtual bool Parse (const std::string value);
    ns3::Callback<bool, std::string> m_callback;  
    std::string m_default;  
  };  // class CallbackItem


  bool HandleOption (const std::string & param) const;

  bool HandleNonOption (const std::string &value);

  void HandleArgument (const std::string &name, const std::string &value) const;
  static bool HandleAttribute (const std::string name, const std::string value);

  void PrintGlobals (std::ostream &os) const;
  void PrintAttributes (std::ostream &os, const std::string &type) const;
  void PrintGroup (std::ostream &os, const std::string &group) const;
  void PrintTypeIds (std::ostream &os) const;
  void PrintGroups (std::ostream &os) const;
  void Copy (const CommandLine &cmd);
  void Clear (void);
  void PrintDoxygenUsage (void) const;

  typedef std::vector<Item *> Items;    
  Items m_options;                      
  Items m_nonOptions;                   
  std::size_t m_NNonOptions;            
  std::size_t m_nonOptionCount;         
  std::string m_usage;                  
  std::string m_shortName;              
};  // class CommandLine


namespace CommandLineHelper {

template <typename T>
bool UserItemParse (const std::string value, T & val);
template <>
bool UserItemParse<bool> (const std::string value, bool & val);
template <>
bool UserItemParse<uint8_t> (const std::string value, uint8_t & val);

template <typename T> std::string GetDefault       (const T & val);
template <>           std::string GetDefault<bool> (const bool & val);
template <>           std::string GetDefault<Time> (const Time & val);
}  // namespace CommandLineHelper


} // namespace ns3


/********************************************************************
 *  Implementation of the templates declared above.
 ********************************************************************/

namespace ns3 {

template <typename T>
void
CommandLine::AddValue (const std::string &name,
                       const std::string &help,
                       T &value)
{
  UserItem<T> *item = new UserItem<T> ();
  item->m_name = name;
  item->m_help = help;
  item->m_valuePtr = &value;

  std::stringstream ss;
  ss << value;
  ss >> item->m_default;

  m_options.push_back (item);
}

template <typename T>
void
CommandLine::AddNonOption (const std::string name,
                           const std::string help,
                           T & value)
{
  UserItem<T> *item = new UserItem<T> ();
  item->m_name = name;
  item->m_help = help;
  item->m_valuePtr = &value;

  std::stringstream ss;
  ss << value;
  ss >> item->m_default;
  m_nonOptions.push_back (item);
  ++m_NNonOptions;

}

template <typename T>
bool
CommandLine::UserItem<T>::HasDefault () const
{
  return true;
}

template <typename T>
std::string
CommandLine::UserItem<T>::GetDefault () const
{
  return CommandLineHelper::GetDefault<T> (*m_valuePtr);
}

template <typename T>
std::string
CommandLineHelper::GetDefault (const T & val)
{
  std::ostringstream oss;
  oss << val;
  return oss.str ();
}

template <typename T>
bool
CommandLine::UserItem<T>::Parse (const std::string value)
{
  return CommandLineHelper::UserItemParse<T> (value, *m_valuePtr);
}

template <typename T>
bool
CommandLineHelper::UserItemParse (const std::string value, T & val)
{
  std::istringstream iss;
  iss.str (value);
  iss >> val;
  return !iss.bad () && !iss.fail ();
}

std::ostream & operator << (std::ostream & os, const CommandLine & cmd);

} // namespace ns3

#endif /* COMMAND_LINE_H */