bpp::AttributesTools Class Reference

Some functions to deal with attributes, i.e. parameters passed to a program/method. More...

#include <Bpp/Utils/AttributesTools.h>

Collaboration diagram for bpp::AttributesTools:

Public Member Functions
	AttributesTools ()
virtual	~AttributesTools ()

Static Public Member Functions
static std::vector< std::string >	getVector (int argc, char *argv[])
	Get attributes a vector of strings from command line arguments. More...
static std::map< std::string, std::string >	getAttributesMap (const std::vector< std::string > &argv, const std::string &delimiter="=")
	Get an attribute map from a vector of arguments. More...
static void	getAttributesMap (const std::vector< std::string > &argv, std::map< std::string, std::string > &am, const std::string &delimiter="=")
	Get an attribute map from a vector of arguments. More...
static std::map< std::string, std::string >	getAttributesMapFromFile (const std::string &file, const std::string &delimiter)
	Get an attribute map from a file. More...
static void	getAttributesMapFromFile (const std::string &file, std::map< std::string, std::string > &params, const std::string &delimiter)
	Get an attribute map from a file. More...
static void	actualizeAttributesMap (std::map< std::string, std::string > &attMap, const std::map< std::string, std::string > &atts)
	Actualizes an attribute map with another. More...
static void	resolveVariables (std::map< std::string, std::string > &am, char varCode='$', char varBeg='(', char varEnd=')')
	Resolve the variables. More...
static std::map< std::string, std::string >	parseOptions (int args, char **argv)
	Global function that reads all parameters from command line and files, and set the values in a map. More...

Static Private Member Functions
static std::string	removeComments (const std::string &s, const std::string &begin, const std::string &end)
	Remove comments from a string. More...

Static Private Attributes
static std::vector< std::string >	vParam_

Detailed Description

Some functions to deal with attributes, i.e. parameters passed to a program/method.

These methods allows you to retrieve attributes from command line arguments or from a file. The underlying syntax is attributeName = argument . Here the delimiter char is '=', but another character may be used.

In files, shell comments: # my comment line here , C comments: / * my comment block here * / (but multiline not supported!) and C++ comments: // my comment line here are allowed, and ignored while parsing.

Lines may be broken, using the bash character '\' at the end of the line:

optionfile=/home/foo/\
   bar.txt

will be read as

optionfile=/home/foo/bar.txt

Attributes are stored as a map<string, string>, with attributes names as keys, and arguments as values.

Here is an example of use. This piece of code typically is at the begining of the main function. It uses the FileTools and ApplicationTools classes, for checking file existence and displaying messages respectively.

// Get the parameters from command line:
map<string, string> cmdParams = AttributesTools::getAttributesMap(
    AttributesTools::getVector(argc, argv), "=");
 
// Look for a specified file with parameters:
int main(int argc, char *argv[]) {
  map<string, string> params;
  if(cmdParams.find("param") != cmdParams.end()) {
    string file = cmdParams["param"];
    if(!FileTools::fileExists(file)) {
      ApplicationTools::displayError("Parameter file not found.");
      exit(-1);
    } else {
      params = AttributesTools::getAttributesMapFromFile(file, "=");
      // Actualize attributes with the ones passed to command line:
      AttributesTools::actualizeAttributesMap(params, cmdParams);
    }
  } else {
    params = cmdParams;
  }
...

These pieces of code does the following:

• get all parameters from the command line and store them in a map,
• check if some parameter is called 'param' or 'params'. If so, look for the file given as value and try to read some parameters from it.
• If an parameter file was found, update the parameter in it with those from the command line. This implies that when a parameter is found in both the command line and the option file, the value from the command line will be retained.

Support for variable is also available. A variable character is specified (typically '$()') and may be used to de-reference any argument. For instance,

data=LSU
file=$(data).out

will be equivalent to

data=LSU
file=LSU.out

Definition at line 129 of file AttributesTools.h.

Constructor & Destructor Documentation

AttributesTools()

bpp::AttributesTools::AttributesTools ( )

inline

Definition at line 140 of file AttributesTools.h.

~AttributesTools()

virtual bpp::AttributesTools::~AttributesTools ( )

inlinevirtual

Definition at line 141 of file AttributesTools.h.

Member Function Documentation

actualizeAttributesMap()

void AttributesTools::actualizeAttributesMap ( std::map< std::string, std::string > &  attMap, const std::map< std::string, std::string > &  atts  )

static

Actualizes an attribute map with another.

All fields in map 2 will be added to map 1. If two attributes have the same name, then map 1 value will be overwritten.

Parameters

attMap	The attributes map.
atts	The attributes to add to the map.

Definition at line 169 of file AttributesTools.cpp.

getAttributesMap() [1/2]

std::map< std::string, std::string > AttributesTools::getAttributesMap ( const std::vector< std::string > &  argv, const std::string &  delimiter = "="  )

static

Get an attribute map from a vector of arguments.

This method also resolve all variable calls.

Parameters

argv	The vector of arguments.
delimiter	The string that separates attribute names from arguments (for instance '=').

Returns

The attribute map.

Definition at line 78 of file AttributesTools.cpp.

getAttributesMap() [2/2]

void AttributesTools::getAttributesMap ( const std::vector< std::string > &  argv, std::map< std::string, std::string > &  am, const std::string &  delimiter = "="  )

static

Get an attribute map from a vector of arguments.

This method also resolve all variable calls.

Parameters

argv	The vector of arguments.
am	The attribute map to fill.
delimiter	The string that separates attribute names from arguments (for instance '=').

Definition at line 89 of file AttributesTools.cpp.

References bpp::TextTools::removeWhiteSpaces().

getAttributesMapFromFile() [1/2]

std::map< std::string, std::string > AttributesTools::getAttributesMapFromFile ( const std::string &  file, const std::string &  delimiter  )

static

Get an attribute map from a file.

Parameters

file	The file with all arguments.
delimiter	The string that separates attribute names from arguments (for instance '=').

Returns

An attribute map.

Definition at line 158 of file AttributesTools.cpp.

getAttributesMapFromFile() [2/2]

void AttributesTools::getAttributesMapFromFile ( const std::string &  file, std::map< std::string, std::string > &  params, const std::string &  delimiter  )

static

Get an attribute map from a file.

Parameters

file	The file with all arguments.
params	An attribute map to fill.
delimiter	The string that separates attribute names from arguments (for instance '=').

Definition at line 145 of file AttributesTools.cpp.

getVector()

std::vector< std::string > AttributesTools::getVector ( int  argc, char *  argv[]  )

static

Get attributes a vector of strings from command line arguments.

Parameters

argc	The number of arguments.
argv	The array with all arguments.

Returns

A vector with all arguments as strings.

Definition at line 64 of file AttributesTools.cpp.

parseOptions()

std::map< std::string, std::string > AttributesTools::parseOptions ( int  args, char **  argv  )

static

Global function that reads all parameters from command line and files, and set the values in a map.

Parameters

args	Number of arguments, as passed to the main function.
argv	Array of values, as passed to the main function.

Returns

An attributes map.

Exceptions

Exception

in case an option file is not found.

Definition at line 252 of file AttributesTools.cpp.

Referenced by bpp::BppApplication::BppApplication().

removeComments()

std::string AttributesTools::removeComments ( const std::string &  s, const std::string &  begin, const std::string &  end  )

staticprivate

Remove comments from a string.

Parameters

s	The string to parse.
begin	Comments front delimiter.
end	Comments end delimiter.

Definition at line 223 of file AttributesTools.cpp.

resolveVariables()

void AttributesTools::resolveVariables ( std::map< std::string, std::string > &  am, char  varCode = '$', char  varBeg = '(', char  varEnd = ')'  )

static

Resolve the variables.

If used prior to the actualizeAttributesMap, this function will make the variables 'local', whereas using them after will make them 'global'.

Parameters

am	The attributes map.
varCode	The code that defines variable recalls.
varBeg	Variables begin name code.
varEnd	Variables end name code.

Exceptions

Exception

If there is a syntax error.

Definition at line 181 of file AttributesTools.cpp.

References bpp::TextTools::toString().

Member Data Documentation

vParam_

std::vector< std::string > AttributesTools::vParam_

staticprivate

Definition at line 137 of file AttributesTools.h.

---

The documentation for this class was generated from the following files:

• Bpp/Utils/AttributesTools.h
• Bpp/Utils/AttributesTools.cpp