GetPot - A class for parsing command line arguments and configuration files. 更多...

#include <getpot.h>

类
struct	ltstr
	helper functor for creating sets of C-style strings 更多...

struct	variable
	Variable to be specified on the command line or in input files. 更多...

Public 成员函数
	GetPot ()
	constructors, destructor, assignment operator 更多...

	GetPot (const GetPot &)

	GetPot (const int argc_, const char const argv_, const char *FieldSeparator=0x0)

	GetPot (const char FileName, const char CommentStart=0x0, const char CommentEnd=0x0, const char FieldSeparator=0x0)

	GetPot (const std::string &FileName, const std::string &CommentStart=std::string("#"), const std::string &CommentEnd=std::string("\n"), const std::string &FieldSeparator=std::string(" \t\n"))

	GetPot (std::istream &FileStream, const std::string &CommentStart=std::string("#"), const std::string &CommentEnd=std::string("\n"), const std::string &FieldSeparator=std::string(" \t\n"))
	This constructor is mainly for testing. 更多...

	~GetPot ()

GetPot &	operator= (const GetPot &)

void	parse_command_line (const int argc_, const char const argv_, const char *FieldSeparator=0x0)
	Re-initialization methods. 更多...

void	parse_input_file (const std::string &FileName, const std::string &CommentStart=std::string("#"), const std::string &CommentEnd=std::string("\n"), const std::string &FieldSeparator=std::string(" \t\n"))

void	parse_input_stream (std::istream &FileStream, const std::string &FileName=std::string("ParsedFromStream"), const std::string &CommentStart=std::string("#"), const std::string &CommentEnd=std::string("\n"), const std::string &FieldSeparator=std::string(" \t\n"))

void	absorb (const GetPot &Other)
	absorbing contents of another GetPot object 更多...

void	clear_requests ()
	for ufo detection: recording requested arguments, options etc. 更多...

void	disable_request_recording ()

void	enable_request_recording ()

const char *	operator[] (unsigned Idx) const
	direct access to command line arguments 更多...

template<typename T >
T	get (unsigned Idx, const T &Default) const

const char *	get (unsigned Idx, const char *Default) const

unsigned	size () const

bool	options_contain (const char *FlagList) const
	flags 更多...

bool	argument_contains (unsigned Idx, const char *FlagList) const

bool	have_variable (const char *VarName) const
	variables 更多...

bool	have_variable (const std::string &VarName) const

bool	have_section (const char *section_name) const
	Check for a section name. 更多...

bool	have_section (const std::string &section_name) const
	Check for a section name. 更多...

template<typename T >
T	operator() (const char *VarName, const T &Default) const
	scalar values 更多...

template<typename T >
T	operator() (const std::string &VarName, const T &Default) const

const char *	operator() (const char VarName, const char Default) const

const char *	operator() (const std::string &VarName, const char *Default) const

template<typename T >
T	operator() (const char *VarName, const T &Default, unsigned Idx) const
	vectors 更多...

template<typename T >
T	operator() (const std::string &VarName, const T &Default, unsigned Idx) const

const char *	operator() (const char VarName, const char Default, unsigned Idx) const

const char *	operator() (const std::string &VarName, const char *Default, unsigned Idx) const

template<typename T >
T	get_value_no_default (const char *VarName, const T &Default) const
	access variables, but error out if not present scalar values 更多...

template<typename T >
T	get_value_no_default (const std::string &VarName, const T &Default) const

const char *	get_value_no_default (const char VarName, const char Default) const

const char *	get_value_no_default (const std::string &VarName, const char *Default) const

template<typename T >
T	get_value_no_default (const char *VarName, const T &Default, unsigned Idx) const
	vectors 更多...

template<typename T >
T	get_value_no_default (const std::string &VarName, const T &Default, unsigned Idx) const

const char *	get_value_no_default (const char VarName, const char Default, unsigned Idx) const

const char *	get_value_no_default (const std::string &VarName, const char *Default, unsigned Idx) const

template<typename T >
void	set (const char *VarName, const T &Value, const bool Requested=true)
	setting variables i) from outside of GetPot (considering prefix etc.) ii) from inside, use '_set_variable()' below 更多...

template<typename T >
void	set (const std::string &VarName, const T &Value, const bool Requested=true)

void	set (const char VarName, const char Value, const bool Requested=true)

void	set (const std::string &VarName, const char *Value, const bool Requested=true)

unsigned	vector_variable_size (const char *VarName) const

unsigned	vector_variable_size (const std::string &VarName) const

STRING_VECTOR	get_variable_names () const

STRING_VECTOR	get_section_names () const

STRING_VECTOR	get_subsection_names (const std::string &section_name) const

std::set< std::string >	get_overridden_variables () const

void	set_prefix (const char *Prefix)
	cursor oriented functions 更多...

bool	search_failed () const

void	disable_loop ()
	enable/disable search for an option in loop 更多...

void	enable_loop ()

void	reset_cursor ()
	reset cursor to position '1' 更多...

void	init_multiple_occurrence ()

bool	search (const char *option)
	search for a certain option and set cursor to position 更多...

bool	search (const std::string &option)

bool	search (unsigned No, const char *P,...)

template<typename T >
T	next (const T &Default)
	get argument at cursor++ 更多...

const char *	next (const char *Default)

template<typename T >
T	follow (const T &Default, const char *Option)
	search for option and get argument at cursor++ 更多...

const char *	follow (const char Default, const char Option)

template<typename T >
T	follow (const T &Default, unsigned No, const char *Option,...)
	search for one of the given options and get argument that follows it 更多...

const char *	follow (const char Default, unsigned No, const char Option,...)

template<typename T >
T	direct_follow (const T &Default, const char *Option)
	directly followed arguments 更多...

const char *	direct_follow (const char Default, const char Option)

void	reset_nominus_cursor ()
	nominus arguments 更多...

STRING_VECTOR	nominus_vector () const

unsigned	nominus_size () const

const char *	next_nominus ()

std::string	next_nominus_string ()

STRING_VECTOR	unidentified_arguments (unsigned Number, const char *Known,...) const
	unidentified flying objects 更多...

STRING_VECTOR	unidentified_arguments (const std::set< std::string > &Knowns) const

STRING_VECTOR	unidentified_arguments (const std::vector< std::string > &Knowns) const

STRING_VECTOR	unidentified_arguments () const

STRING_VECTOR	unidentified_options (unsigned Number, const char *Known,...) const

STRING_VECTOR	unidentified_options (const std::set< std::string > &Knowns) const

STRING_VECTOR	unidentified_options (const std::vector< std::string > &Knowns) const

STRING_VECTOR	unidentified_options () const

std::string	unidentified_flags (const char *Known, int ArgumentNumber) const

STRING_VECTOR	unidentified_variables (unsigned Number, const char *Known,...) const

STRING_VECTOR	unidentified_variables (const std::set< std::string > &Knowns) const

STRING_VECTOR	unidentified_variables (const std::vector< std::string > &Knowns) const

STRING_VECTOR	unidentified_variables () const

STRING_VECTOR	unidentified_sections (unsigned Number, const char *Known,...) const

STRING_VECTOR	unidentified_sections (const std::set< std::string > &Knowns) const

STRING_VECTOR	unidentified_sections (const std::vector< std::string > &Knowns) const

STRING_VECTOR	unidentified_sections () const

STRING_VECTOR	unidentified_nominuses (unsigned Number, const char *Known,...) const

STRING_VECTOR	unidentified_nominuses (const std::set< std::string > &Knowns) const

STRING_VECTOR	unidentified_nominuses (const std::vector< std::string > &Knowns) const

STRING_VECTOR	unidentified_nominuses () const

std::set< std::string >	get_requested_arguments () const
	Accessors for requested variables. 更多...

std::set< std::string >	get_requested_variables () const

std::set< std::string >	get_requested_sections () const

int	print (std::ostream &out_stream=std::cout) const
	output 更多...

int	print (const char *custom_prefix, std::ostream &out_stream=std::cout, unsigned int skip_count=1) const
	Print everything after skipping skip_count arguments, with a custom prefix. 更多...

template<>
std::string	_convert_to_type (const std::string &String, const std::string &) const

template<>
std::string	_convert_to_type_no_default (const char *, const std::string &String, const std::string &) const

template<typename T >
T	get (unsigned int Idx, const T &Default) const

template<typename T >
T	follow (const T &Default, unsigned int No, const char *P,...)

template<typename T >
T	operator() (const char *VarName, const T &Default, unsigned int Idx) const

template<typename T >
T	operator() (const std::string &VarName, const T &Default, unsigned int Idx) const

template<typename T >
T	get_value_no_default (const char *VarName, const T &Default, unsigned int Idx) const

template<typename T >
T	get_value_no_default (const std::string &VarName, const T &Default, unsigned int Idx) const

Private 成员函数
void	_basic_initialization ()

const char *	_internal_managed_copy (const std::string &Arg) const
	some functions return a char pointer to a temporarily existing string this function adds them to our container 更多...

void	_record_argument_request (const std::string &Arg) const
	if an argument is requested record it and the 'tag' the section branch to which it belongs. 更多...

void	_record_variable_request (const std::string &Arg) const

void	_set_variable (const std::string &VarName, const std::string &Value, const bool Requested)
	helper functions 更多...

void	_parse_argument_vector (const STRING_VECTOR &ARGV)
	produce three basic data vectors: 更多...

const variable *	_find_variable (const char *) const
	helpers for argument list processing 更多...

const variable *	_request_variable (const char *) const
	search (and record request) for a variable in 'variables' array 更多...

const char *	_match_starting_string (const char *StartString)
	support finding directly followed arguments 更多...

bool	_check_flags (const std::string &Str, const char *FlagList) const
	support search for flags in a specific argument 更多...

template<typename T >
T	_convert_to_type (const std::string &String, const T &Default) const
	type conversion if possible 更多...

std::string	_convert_to_type (const std::string &String, const char *Default) const

template<typename T >
T	_convert_to_type_no_default (const char *VarName, const std::string &String, const T &Default) const

std::string	_convert_to_type_no_default (const char VarName, const std::string &String, const char Default) const

const std::string	_get_remaining_string (const std::string &String, const std::string &Start) const
	prefix extraction 更多...

bool	_search_string_vector (const STRING_VECTOR &Vec, const std::string &Str) const
	search for a specific string 更多...

void	_skip_whitespace (std::istream &istr)
	helpers to parse input file create an argument vector based on data found in an input file, i.e. 更多...

const std::string	_get_next_token (std::istream &istr)

const std::string	_get_string (std::istream &istr)

const std::string	_get_until_closing_bracket (std::istream &istr)

const std::string	_get_until_closing_square_bracket (std::istream &istr)

STRING_VECTOR	_read_in_stream (std::istream &istr)

std::string	_process_section_label (const std::string &Section, STRING_VECTOR &section_stack)

std::string	_DBE_expand_string (const std::string &str)
	dollar bracket expressions 更多...

std::string	_DBE_expand (const std::string &str)

const GetPot::variable *	_DBE_get_variable (const std::string &str)

STRING_VECTOR	_DBE_get_expr_list (const std::string &str, const unsigned ExpectedNumber)

template<>
bool	_convert_to_type (const std::string &String, const bool &Default) const

template<>
bool	_convert_to_type_no_default (const char *VarName, const std::string &String, const bool &) const

静态 Private 成员函数
template<typename T >
static std::string	_convert_from_type (const T &Value)

static STRING_VECTOR	_get_section_tree (const std::string &FullPath)
	cuts a variable name into a tree of sub-sections. 更多...

Private 属性
std::string	prefix
	member variables 更多...

std::string	section

STRING_VECTOR	section_list

STRING_VECTOR	argv
	argument vector 更多...

unsigned	cursor

bool	search_loop_f

bool	search_failed_f

std::set< std::string >	overridden_vars

int	nominus_cursor
	nominus vector 更多...

std::vector< unsigned >	idx_nominus

std::vector< variable >	variables
	variables (arguments of the form "variable=value") 更多...

std::string	_comment_start
	comment delimiters 更多...

std::string	_comment_end

std::string	_field_separator
	field separator (separating elements of a vector) 更多...

	GETPOT_MUTEX_DECLARE
	we have some mutable non-thread-safe members, but we want to be able to call const member functions from multiple threads at once, so we'll wrap access to mutable objects in a mutex. 更多...

std::set< const char *, ltstr >	_internal_string_container
	some functions return a char pointer to a string created on the fly. 更多...

std::set< std::string >	_requested_arguments
	keeping track about arguments that are requested, so that the UFO detection can be simplified 更多...

std::set< std::string >	_requested_variables

std::set< std::string >	_requested_sections

bool	request_recording_f

详细描述

GetPot - A class for parsing command line arguments and configuration files.

作者: Frank R. Schaefer

日期: (C) 2001-2002

在文件 getpot.h 第 154 行定义.

构造及析构函数说明

GETPOT_NAMESPACE::GetPot::GetPot ( )

inline

constructors, destructor, assignment operator

在文件 getpot.h 第 744 行定义.

参考 _basic_initialization().

                :
   prefix(),
   section(),
   section_list(),
   argv(),
   cursor(),
   search_loop_f(),
   search_failed_f(),
   nominus_cursor(),
   idx_nominus(),
   variables(),
   _comment_start(),
   _comment_end(),
   _field_separator(),
 #if !defined(GETPOT_DISABLE_MUTEX)
   _getpot_mtx(),
 #endif
   _internal_string_container(),
   _requested_arguments(),
   _requested_variables(),
   _requested_sections(),
   request_recording_f()
 {
   _basic_initialization();
 }

GETPOT_NAMESPACE::GetPot::GetPot ( const GetPot & Other )

inline

在文件 getpot.h 第 977 行定义.

参考 _internal_string_container.

                                   :
   prefix(Other.prefix),
   section(Other.section),
   section_list(Other.section_list),
   argv(Other.argv),
   cursor(Other.cursor),
   search_loop_f(Other.search_loop_f),
   search_failed_f(Other.search_failed_f),
   overridden_vars(),
   nominus_cursor(Other.nominus_cursor),
   idx_nominus(Other.idx_nominus),
   variables(Other.variables),
   _comment_start(Other._comment_start),
   _comment_end(Other._comment_end),
   _field_separator(Other._field_separator),
   // #if !defined(GETPOT_DISABLE_MUTEX)
   //   _getpot_mtx(Other._getpot_mtx),
   // #endif
   _internal_string_container(),
   _requested_arguments(Other._requested_arguments),
   _requested_variables(Other._requested_variables),
   _requested_sections(Other._requested_sections),
   request_recording_f(Other.request_recording_f)
 {
   std::set<const char*,ltstr>::const_iterator it =
     Other._internal_string_container.begin();
 
   const std::set<const char*,ltstr>::const_iterator end =
     Other._internal_string_container.end();
 
   for (; it != end; ++it)
     {
       const char* otherstr = *it;
       char* newcopy = new char[strlen(otherstr)+1];
       strncpy(newcopy, otherstr, strlen(otherstr)+1);
       this->_internal_string_container.insert(newcopy);
     }
 }

GETPOT_NAMESPACE::GetPot::GetPot	(	const int	argc_,
		const char const	argv_,
		const char *	FieldSeparator = `0x0`
	)

inline

在文件 getpot.h 第 773 行定义.

参考 parse_command_line().

                                              :
   // leave 'char**' non-const to honor less capable compilers ...
   prefix(),
   section(),
   section_list(),
   argv(),
   cursor(),
   search_loop_f(),
   search_failed_f(),
   nominus_cursor(),
   idx_nominus(),
   variables(),
   _comment_start(),
   _comment_end(),
   _field_separator(),
 #if !defined(GETPOT_DISABLE_MUTEX)
   _getpot_mtx(),
 #endif
   _internal_string_container(),
   _requested_arguments(),
   _requested_variables(),
   _requested_sections(),
   request_recording_f()
 {
   this->parse_command_line(argc_, argv_, FieldSeparator);
 }

GETPOT_NAMESPACE::GetPot::GetPot	(	const char *	FileName,
		const char *	CommentStart = `0x0`,
		const char *	CommentEnd = `0x0`,
		const char *	FieldSeparator = `0x0`
	)

inline

在文件 getpot.h 第 834 行定义.

参考 parse_input_file().

                                             :
   prefix(),
   section(),
   section_list(),
   argv(),
   cursor(),
   search_loop_f(),
   search_failed_f(),
   nominus_cursor(),
   idx_nominus(),
   variables(),
   _comment_start(),
   _comment_end(),
   _field_separator(),
 #if !defined(GETPOT_DISABLE_MUTEX)
   _getpot_mtx(),
 #endif
   _internal_string_container(),
   _requested_arguments(),
   _requested_variables(),
   _requested_sections(),
   request_recording_f()
 {
   const std::string& StrCommentStart   = CommentStart   ? CommentStart   : std::string("#");
   const std::string& StrCommentEnd     = CommentEnd     ? CommentEnd     : std::string("\n");
   const std::string& StrFieldSeparator = FieldSeparator ? FieldSeparator : std::string(" \t\n");
   this->parse_input_file(FileName, StrCommentStart, StrCommentEnd, StrFieldSeparator);
 }

GETPOT_NAMESPACE::GetPot::GetPot	(	const std::string &	FileName,
		const std::string &	CommentStart = `std::string("#")`,
		const std::string &	CommentEnd = `std::string("\n")`,
		const std::string &	FieldSeparator = `std::string(" \t\n")`
	)

inline

在文件 getpot.h 第 868 行定义.

参考 parse_input_file().

                                                 :
   prefix(),
   section(),
   section_list(),
   argv(),
   cursor(),
   search_loop_f(),
   search_failed_f(),
   nominus_cursor(),
   idx_nominus(),
   variables(),
   _comment_start(),
   _comment_end(),
   _field_separator(),
 #if !defined(GETPOT_DISABLE_MUTEX)
   _getpot_mtx(),
 #endif
   _internal_string_container(),
   _requested_arguments(),
   _requested_variables(),
   _requested_sections(),
   request_recording_f()
 {
   this->parse_input_file(FileName, CommentStart, CommentEnd, FieldSeparator);
 }

GETPOT_NAMESPACE::GetPot::GetPot	(	std::istream &	FileStream,
		const std::string &	CommentStart = `std::string("#")`,
		const std::string &	CommentEnd = `std::string("\n")`,
		const std::string &	FieldSeparator = `std::string(" \t\n")`
	)

inline

This constructor is mainly for testing.

The std::string based constructor should be preferred.

在文件 getpot.h 第 913 行定义.

参考 parse_input_stream().

                                                 :
   prefix(),
   section(),
   section_list(),
   argv(),
   cursor(),
   search_loop_f(),
   search_failed_f(),
   nominus_cursor(),
   idx_nominus(),
   variables(),
   _comment_start(),
   _comment_end(),
   _field_separator(),
 #if !defined(GETPOT_DISABLE_MUTEX)
   _getpot_mtx(),
 #endif
   _internal_string_container(),
   _requested_arguments(),
   _requested_variables(),
   _requested_sections(),
   request_recording_f()
 {
   this->parse_input_stream(FileStream,
                            std::string("ParsedFromStream"),// We don't have a filename here
                            CommentStart, CommentEnd, FieldSeparator);
 }

GETPOT_NAMESPACE::GetPot::~GetPot ( )

inline

在文件 getpot.h 第 1019 行定义.

参考 _internal_string_container.

 {
   // may be some return strings had to be created, delete now !
   std::set<const char*, ltstr>::const_iterator        it = _internal_string_container.begin();
   const std::set<const char*, ltstr>::const_iterator end = _internal_string_container.end();
   for (; it != end; ++it)
     delete [] *it;
 }

成员函数说明

void GETPOT_NAMESPACE::GetPot::_basic_initialization ( )

inlineprivate

在文件 getpot.h 第 721 行定义.

参考 _comment_end, _comment_start, _field_separator, cursor, nominus_cursor, prefix, request_recording_f, search_failed_f, search_loop_f , 以及 section.

参考自 GetPot(), parse_command_line() , 以及 parse_input_stream().

 {
   cursor = 0;
   nominus_cursor = -1;
   search_failed_f = true;
   search_loop_f = true;
   prefix = "";
   section = "";
 
   // automatic request recording for later ufo detection
   request_recording_f = true;
 
   // comment start and end strings
   _comment_start = std::string("#");
   _comment_end   = std::string("\n");
 
   // default: separate vector elements by whitespaces
   _field_separator = " \t\n";
 }

bool GETPOT_NAMESPACE::GetPot::_check_flags	(	const std::string &	Str,
		const char *	FlagList
	)		const

inlineprivate

support search for flags in a specific argument

在文件 getpot.h 第 2158 行定义.

参考自 argument_contains() , 以及 options_contain().

 {
   for (const char* p=FlagList; *p != '\0' ; p++)
     if (Str.find(*p) != std::string::npos)
       return true; // found something
   return false;
 }

template<typename T >

static std::string GETPOT_NAMESPACE::GetPot::_convert_from_type ( const T & Value )

inlinestaticprivate

在文件 getpot.h 第 691 行定义.

参考自 _DBE_expand().

   {
     std::ostringstream out_string;
     out_string << Value;
     return out_string.str();
   }

template<typename T >

T GETPOT_NAMESPACE::GetPot::_convert_to_type	(	const std::string &	String,
		const T &	Default
	)		const

inlineprivate

type conversion if possible

在文件 getpot.h 第 1569 行定义.

参考自 _DBE_expand(), direct_follow(), get(), next() , 以及 operator()().

 {
   std::istringstream in_string(String);
   T retval;
   in_string >> retval;
   if (in_string.fail())
     retval = Default;
   return retval;
 }

std::string GETPOT_NAMESPACE::GetPot::_convert_to_type	(	const std::string &	String,
		const char *	Default
	)		const

inlineprivate

在文件 getpot.h 第 1593 行定义.

 {
   return String;
 }

template<>

std::string GETPOT_NAMESPACE::GetPot::_convert_to_type	(	const std::string &	String,
		const std::string &
	)		const

inline

在文件 getpot.h 第 1584 行定义.

 {
   return String;
 }

template<>

bool GETPOT_NAMESPACE::GetPot::_convert_to_type	(	const std::string &	String,
		const bool &	Default
	)		const

inlineprivate

在文件 getpot.h 第 1603 行定义.

 {
   std::string newstring(String);
   //std::transform(newstring.begin(), newstring.end(), newstring.begin(), std::toupper);
   for (unsigned int i=0; i<newstring.length(); ++i)
     newstring[i] = getpot_cast_int<char>(toupper(newstring[i]));
 
   // "true"/"True"/"TRUE" should work
   if (newstring.find("TRUE")!=std::string::npos)
     return true;
 
   if (newstring.find("FALSE")!=std::string::npos)
     return false;
 
   // And if we don't find that, let's search for an integer and use C unsigned
   // int->bool conversion before giving up; i.e. a user could specify "0" for
   // false or "1" for true
   std::istringstream in_string(String);
   unsigned int retval;
   in_string >> retval;
   if (in_string.fail())
     return Default;
 
   return retval;
 }

template<typename T >

T GETPOT_NAMESPACE::GetPot::_convert_to_type_no_default	(	const char *	VarName,
		const std::string &	String,
		const T &	Default
	)		const

inlineprivate

在文件 getpot.h 第 1634 行定义.

参考自 get_value_no_default().

 {
   std::istringstream in_string(String);
   T retval;
   in_string >> retval;
   if (in_string.fail())
     {
       getpot_cerr <<"ERROR: Input value for variable "<<VarName<<" is of the wrong type."<<std::endl;
       getpot_cerr <<"       value = "<<String<<" expected type = "<<typeid(T).name()<<std::endl;
       getpot_error();
     }
   return retval;
 }

std::string GETPOT_NAMESPACE::GetPot::_convert_to_type_no_default	(	const char *	VarName,
		const std::string &	String,
		const char *	Default
	)		const

inlineprivate

在文件 getpot.h 第 1662 行定义.

 {
   return String;
 }

template<>

std::string GETPOT_NAMESPACE::GetPot::_convert_to_type_no_default	(	const char *	,
		const std::string &	String,
		const std::string &
	)		const

inline

在文件 getpot.h 第 1653 行定义.

 {
   return String;
 }

template<>

bool GETPOT_NAMESPACE::GetPot::_convert_to_type_no_default	(	const char *	VarName,
		const std::string &	String,
		const bool &
	)		const

inlineprivate

在文件 getpot.h 第 1672 行定义.

 {
   std::string newstring(String);
   //std::transform(newstring.begin(), newstring.end(), newstring.begin(), std::toupper);
   for (unsigned int i=0; i<newstring.length(); ++i)
     {
       newstring[i]=getpot_cast_int<char>(toupper(newstring[i]));
     }
 
   // "true"/"True"/"TRUE" should work
   if (newstring.find("TRUE")!=std::string::npos)
     return true;
 
   if (newstring.find("FALSE")!=std::string::npos)
     return false;
 
   // And if we don't find that, let's search for an integer and use C unsigned
   // int->bool conversion before giving up; i.e. a user could specify "0" for
   // false or "1" for true
   std::istringstream in_string(String);
   unsigned int retval;
   in_string >> retval;
   if (in_string.fail())
     {
       getpot_cerr <<"ERROR: Input value for variable "<<VarName<<" is of the wrong type."<<std::endl;
       getpot_cerr <<"       value = "<<String<<" expected type = "<<typeid(bool).name()<<std::endl;
       getpot_error();
     }
 
   return retval;
 }

std::string GETPOT_NAMESPACE::GetPot::_DBE_expand ( const std::string & str )

inlineprivate

在文件 getpot.h 第 2929 行定义.

参考 _convert_from_type(), _convert_to_type(), _DBE_get_expr_list(), _DBE_get_variable(), std::abs(), GETPOT_NAMESPACE::GetPot::variable::name, GETPOT_NAMESPACE::GetPot::variable::original, size() , 以及 std::sqrt().

参考自 _DBE_expand_string() , 以及 _DBE_get_expr_list().

 {
   // ${: } pure text
   if (expr[0] == ':')
     return expr.substr(1);
 
   // ${& expr expr ... } text concatenation
   else if (expr[0] == '&')
     {
       const STRING_VECTOR A = _DBE_get_expr_list(expr.substr(1), 1);
 
       STRING_VECTOR::const_iterator it = A.begin();
       std::string result = *it++;
       for (; it != A.end(); ++it) result += *it;
 
       return result;
     }
 
   // ${<-> expr expr expr} text replacement
   else if (expr.length() >= 3 && expr.substr(0, 3) == "<->")
     {
       STRING_VECTOR A = _DBE_get_expr_list(expr.substr(3), 3);
       size_t tmp = 0;
       const size_t L = A[1].length();
 
       while ((tmp = A[0].find(A[1])) != std::string::npos)
         A[0].replace(tmp, L, A[2]);
 
       return A[0];
     }
 
   // ${=func [expr...] } function evaluation
   else if (expr.length() >= 2 &&
            expr.substr(0, 1) == "=" &&
            expr.substr(0, 2) != "==")
     {
       size_t funcnamestart = expr.find_first_not_of(" \t", 1);
       if (funcnamestart != std::string::npos)
         {
           size_t funcnameend = expr.find_first_of(" \t",funcnamestart);
           std::string funcname = expr.substr(funcnamestart,
                                              funcnameend-funcnamestart);
           if (funcname == "log")
             {
               STRING_VECTOR A =
                 _DBE_get_expr_list(expr.substr(funcnameend), 1);
               double arg = _convert_to_type(A[0], 0.0);
               return _convert_from_type(std::log(arg));
             }
           else if (funcname == "log10")
             {
               STRING_VECTOR A =
                 _DBE_get_expr_list(expr.substr(funcnameend), 1);
               double arg = _convert_to_type(A[0], 0.0);
               return _convert_from_type(std::log10(arg));
             }
           else if (funcname == "exp")
             {
               STRING_VECTOR A =
                 _DBE_get_expr_list(expr.substr(funcnameend), 1);
               double arg = _convert_to_type(A[0], 0.0);
               return _convert_from_type(std::exp(arg));
             }
           else if (funcname == "sin")
             {
               STRING_VECTOR A =
                 _DBE_get_expr_list(expr.substr(funcnameend), 1);
               double arg = _convert_to_type(A[0], 0.0);
               return _convert_from_type(std::sin(arg));
             }
           else if (funcname == "cos")
             {
               STRING_VECTOR A =
                 _DBE_get_expr_list(expr.substr(funcnameend), 1);
               double arg = _convert_to_type(A[0], 0.0);
               return _convert_from_type(std::cos(arg));
             }
           else if (funcname == "tan")
             {
               STRING_VECTOR A =
                 _DBE_get_expr_list(expr.substr(funcnameend), 1);
               double arg = _convert_to_type(A[0], 0.0);
               return _convert_from_type(std::tan(arg));
             }
           else if (funcname == "asin")
             {
               STRING_VECTOR A =
                 _DBE_get_expr_list(expr.substr(funcnameend), 1);
               double arg = _convert_to_type(A[0], 0.0);
               return _convert_from_type(std::asin(arg));
             }
           else if (funcname == "acos")
             {
               STRING_VECTOR A =
                 _DBE_get_expr_list(expr.substr(funcnameend), 1);
               double arg = _convert_to_type(A[0], 0.0);
               return _convert_from_type(std::acos(arg));
             }
           else if (funcname == "atan")
             {
               STRING_VECTOR A =
                 _DBE_get_expr_list(expr.substr(funcnameend), 1);
               double arg = _convert_to_type(A[0], 0.0);
               return _convert_from_type(std::atan(arg));
             }
           else if (funcname == "atan2")
             {
               STRING_VECTOR A =
                 _DBE_get_expr_list(expr.substr(funcnameend), 2);
               double arg1 = _convert_to_type(A[0], 0.0);
               double arg2 = _convert_to_type(A[1], 0.0);
               return _convert_from_type(std::atan2(arg1, arg2));
             }
           else if (funcname == "sinh")
             {
               STRING_VECTOR A =
                 _DBE_get_expr_list(expr.substr(funcnameend), 1);
               double arg = _convert_to_type(A[0], 0.0);
               return _convert_from_type(std::sinh(arg));
             }
           else if (funcname == "cosh")
             {
               STRING_VECTOR A =
                 _DBE_get_expr_list(expr.substr(funcnameend), 1);
               double arg = _convert_to_type(A[0], 0.0);
               return _convert_from_type(std::cosh(arg));
             }
           else if (funcname == "tanh")
             {
               STRING_VECTOR A =
                 _DBE_get_expr_list(expr.substr(funcnameend), 1);
               double arg = _convert_to_type(A[0], 0.0);
               return _convert_from_type(std::tanh(arg));
             }
 #ifdef HAVE_INVERSE_HYPERBOLIC_SINE
           else if (funcname == "asinh")
             {
               STRING_VECTOR A =
                 _DBE_get_expr_list(expr.substr(funcnameend), 1);
               double arg = _convert_to_type(A[0], 0.0);
               return _convert_from_type(std::asinh(arg));
             }
 #endif
 #ifdef HAVE_INVERSE_HYPERBOLIC_COSINE
           else if (funcname == "acosh")
             {
               STRING_VECTOR A =
                 _DBE_get_expr_list(expr.substr(funcnameend), 1);
               double arg = _convert_to_type(A[0], 0.0);
               return _convert_from_type(std::acosh(arg));
             }
 #endif
 #ifdef HAVE_INVERSE_HYPERBOLIC_TANGENT
           else if (funcname == "atanh")
             {
               STRING_VECTOR A =
                 _DBE_get_expr_list(expr.substr(funcnameend), 1);
               double arg = _convert_to_type(A[0], 0.0);
               return _convert_from_type(std::atanh(arg));
             }
 #endif
           else if (funcname == "sqrt")
             {
               STRING_VECTOR A =
                 _DBE_get_expr_list(expr.substr(funcnameend), 1);
               double arg = _convert_to_type(A[0], 0.0);
               return _convert_from_type(std::sqrt(arg));
             }
           else if (funcname == "abs")
             {
               STRING_VECTOR A =
                 _DBE_get_expr_list(expr.substr(funcnameend), 1);
               double arg = _convert_to_type(A[0], 0.0);
               return _convert_from_type(std::abs(arg));
             }
           else if (funcname == "max")
             {
               STRING_VECTOR A =
                 _DBE_get_expr_list(expr.substr(funcnameend), 1);
               STRING_VECTOR::const_iterator it = A.begin();
               double result = _convert_to_type(*it++, 0.0);
               for (; it != A.end(); ++it)
                 result = std::max(result, _convert_to_type(*it, 0.0));
               return _convert_from_type(result);
             }
           else if (funcname == "min")
             {
               STRING_VECTOR A =
                 _DBE_get_expr_list(expr.substr(funcnameend), 1);
               STRING_VECTOR::const_iterator it = A.begin();
               double result = _convert_to_type(*it++, 0.0);
               for (; it != A.end(); ++it)
                 result = std::min(result, _convert_to_type(*it, 0.0));
               return _convert_from_type(result);
             }
           else if (funcname == "ceil")
             {
               STRING_VECTOR A =
                 _DBE_get_expr_list(expr.substr(funcnameend), 1);
               double arg = _convert_to_type(A[0], 0.0);
               return _convert_from_type(std::ceil(arg));
             }
           else if (funcname == "floor")
             {
               STRING_VECTOR A =
                 _DBE_get_expr_list(expr.substr(funcnameend), 1);
               double arg = _convert_to_type(A[0], 0.0);
               return _convert_from_type(std::floor(arg));
             }
           else if (funcname == "fmod")
             {
               STRING_VECTOR A =
                 _DBE_get_expr_list(expr.substr(funcnameend), 2);
               double arg1 = _convert_to_type(A[0], 0.0);
               double arg2 = _convert_to_type(A[1], 0.0);
               return _convert_from_type(std::fmod(arg1, arg2));
             }
           else if (funcname == "srand")
             {
               STRING_VECTOR A =
                 _DBE_get_expr_list(expr.substr(funcnameend), 1);
               unsigned int arg = _convert_to_type(A[0], 0u);
               std::srand(arg);
               return A[0];
             }
           // ${=rand range} with default range==RAND_MAX
           else if (funcname == "rand")
             {
               if (funcnameend >= expr.length() ||
                   expr.find_first_not_of(" \t", funcnameend) == std::string::npos)
                 return _convert_from_type(std::rand());
 
               STRING_VECTOR A =
                 _DBE_get_expr_list(expr.substr(funcnameend), 1);
               unsigned int range = _convert_to_type(A[0],0u);
               if (!range)
                 return _convert_from_type(0);
               const unsigned int x = (RAND_MAX + 1u) / range;
               const unsigned int y = x * range;
               unsigned int returnval;
               do
                 {
                   returnval = rand();
                 } while (returnval >= y);
               return _convert_from_type(returnval / x);
             }
           else if (funcname == "time")
             return _convert_from_type(std::time(NULL));
           else
             {
               getpot_cerr << "ERROR: unrecognized function "
                           << funcname << std::endl;
               getpot_error();
             }
         }
     }
 
   // ${+ ...}, ${- ...}, ${* ...}, ${/ ...} expressions
   else if (expr[0] == '+')
     {
       STRING_VECTOR A = _DBE_get_expr_list(expr.substr(1), 2);
       STRING_VECTOR::const_iterator it = A.begin();
       double result = _convert_to_type(*it++, 0.0);
       for (; it != A.end(); ++it)
         result += _convert_to_type(*it, 0.0);
 
       return _convert_from_type(result);
     }
   else if (expr[0] == '-')
     {
       STRING_VECTOR A = _DBE_get_expr_list(expr.substr(1), 2);
       STRING_VECTOR::const_iterator it = A.begin();
       double result = _convert_to_type(*it++, 0.0);
       for (; it != A.end(); ++it)
         result -= _convert_to_type(*it, 0.0);
 
       return _convert_from_type(result);
     }
   else if (expr[0] == '*')
     {
       STRING_VECTOR A = _DBE_get_expr_list(expr.substr(1), 2);
       STRING_VECTOR::const_iterator it = A.begin();
       double result = _convert_to_type(*it++, 0.0);
       for (; it != A.end(); ++it)
         result *= _convert_to_type(*it, 0.0);
 
       return _convert_from_type(result);
     }
   else if (expr[0] == '/')
     {
       STRING_VECTOR A = _DBE_get_expr_list(expr.substr(1), 2);
       STRING_VECTOR::const_iterator it = A.begin();
       double result = _convert_to_type(*it++, 0.0);
       if (result == 0)
         return "0.0";
 
       for (; it != A.end(); ++it)
         {
           const double Q = _convert_to_type(*it, 0.0);
           result /= Q;
         }
       return _convert_from_type(result);
     }
 
   // ${^ ... } power expressions
   else if (expr[0] == '^')
     {
       STRING_VECTOR A = _DBE_get_expr_list(expr.substr(1), 2);
       STRING_VECTOR::const_iterator it = A.begin();
       double result = _convert_to_type(*it++, 0.0);
       for (; it != A.end(); ++it)
         result = pow(result, _convert_to_type(*it, 0.0));
       return _convert_from_type(result);
     }
 
   // ${==  } ${<=  } ${>= } comparisons (return the number of the first 'match'
   else if (expr.length() >= 2 &&
            (expr.substr(0,2) == "==" || expr.substr(0,2) == ">=" ||
             expr.substr(0,2) == "<=" || expr[0] == '>'           || expr[0] == '<'))
     {
       // differentiate between two and one sign operators
       unsigned op = 0;
       enum { EQ, GEQ, LEQ, GT, LT };
 
       if (expr.substr(0, 2) == "==")
         op = EQ;
 
       else if (expr.substr(0, 2) == ">=")
         op = GEQ;
 
       else if (expr.substr(0, 2) == "<=")
         op = LEQ;
 
       else if (expr[0] == '>')
         op = GT;
 
       else
         op = LT;
 
       STRING_VECTOR a;
       if (op == GT || op == LT)
         a = _DBE_get_expr_list(expr.substr(1), 2);
 
       else
         a = _DBE_get_expr_list(expr.substr(2), 2);
 
       std::string   x_orig = a[0];
       double   x = _convert_to_type(x_orig, 1e37);
       unsigned i = 1;
 
       STRING_VECTOR::const_iterator y_orig = a.begin();
       for (y_orig++; y_orig != a.end(); ++y_orig)
         {
           double y = _convert_to_type(*y_orig, 1e37);
 
           // set the strings as reference if one wasn't a number
           if (x == 1e37 || y == 1e37)
             {
               // it's a string comparison
               if ((op == EQ  && x_orig == *y_orig) || (op == GEQ && x_orig >= *y_orig) ||
                   (op == LEQ && x_orig <= *y_orig) || (op == GT  && x_orig >  *y_orig) ||
                   (op == LT  && x_orig <  *y_orig))
                 return _convert_from_type(i);
             }
           else
             {
               // it's a number comparison
               if ((op == EQ  && x == y) || (op == GEQ && x >= y) ||
                   (op == LEQ && x <= y) || (op == GT  && x >  y) ||
                   (op == LT  && x <  y))
                 return _convert_from_type(i);
             }
           i++;
         }
 
       // nothing fulfills the condition => return 0
       return "0";
     }
 
   // ${?? expr expr} select
   else if (expr.length() >= 2 && expr.substr(0, 2) == "??")
     {
       STRING_VECTOR a = _DBE_get_expr_list(expr.substr(2), 2);
       double x = _convert_to_type(a[0], 1e37);
 
       // last element is always the default argument
       if (x == 1e37 || x < 0 || x >= double(a.size() - 1))
         return a[a.size()-1];
 
       // round x to closest integer
       return a[int(x+0.5)];
     }
 
   // ${? expr expr expr} if then else conditions
   else if (expr[0] == '?')
     {
       STRING_VECTOR a = _DBE_get_expr_list(expr.substr(1), 2);
 
       if (_convert_to_type(a[0], 0.0) == 1.0)
         return a[1];
 
       else if (a.size() > 2)
         return a[2];
     }
   // ${! expr} maxro expansion
   else if (expr[0] == '!')
     {
       const GetPot::variable* Var = _DBE_get_variable(expr.substr(1));
       // error
       if (Var->name == "")
         return std::string(Var->original);
 
       const STRING_VECTOR A = _DBE_get_expr_list(Var->original, 2);
       return A[0];
     }
   // ${@: } - string subscription
   else if (expr.length() >= 2 && expr.substr(0,2) == "@:")
     {
       const STRING_VECTOR A = _DBE_get_expr_list(expr.substr(2), 2);
       double x = _convert_to_type(A[1], 1e37);
 
       // last element is always the default argument
       if (x == 1e37 || x < 0 || x >= double(A[0].size() - 1))
         return "<<1st index out of range>>";
 
       if (A.size() > 2)
         {
           double y = _convert_to_type(A[2], 1e37);
           if (y != 1e37 && y > 0 && y <= double(A[0].size() - 1) && y > x)
             return A[0].substr(int(x+0.5), int(y+1.5) - int(x+0.5));
 
           else if (y == -1)
             return A[0].substr(int(x+0.5));
 
           return "<<2nd index out of range>>";
         }
       else
         {
           char* tmp = new char[2];
           tmp[0] = A[0][int(x+0.5)]; tmp[1] = '\0';
           std::string result(tmp);
           delete [] tmp;
           return result;
         }
     }
   // ${@ } - vector subscription
   else if (expr[0] == '@')
     {
       STRING_VECTOR          A   = _DBE_get_expr_list(expr.substr(1), 2);
       const GetPot::variable* Var = _DBE_get_variable(A[0]);
       // error
       if (Var->name == "")
         {
           // make a copy of the string if an error occurred
           // (since the error variable is a static variable inside get_variable())
           return std::string(Var->original);
         }
 
       double x = _convert_to_type(A[1], 1e37);
 
       // last element is always the default argument
       if (x == 1e37 || x < 0 || x >= double(Var->value.size()))
         return "<<1st index out of range>>";
 
       if (A.size() > 2)
         {
           double y = _convert_to_type(A[2], 1e37);
           int    begin = int(x+0.5);
           int    end = 0;
           if (y != 1e37 && y > 0 && y <= double(Var->value.size()) && y > x)
             end = int(y+1.5);
           else if (y == -1)
             end = int(Var->value.size());
           else
             return "<<2nd index out of range>>";
 
           std::string result = *(Var->get_element(begin));
           for (int i = begin+1; i < end; i++)
             result += std::string(" ") + *(Var->get_element(i));
           return result;
         }
       else
         return *(Var->get_element(int(x+0.5)));
     }
 
   const STRING_VECTOR    A = _DBE_get_expr_list(expr, 1);
   const GetPot::variable* B = _DBE_get_variable(A[0]);
 
   // make a copy of the string if an error occurred
   // (since the error variable is a static variable inside get_variable())
   if (B->name == "")
     return std::string(B->original);
 
   // (psuggs@pobox.com mentioned to me the warning MSVC++6.0 produces
   //  with:  else return B->original (thanks))
   return B->original;
 }

std::string GETPOT_NAMESPACE::GetPot::_DBE_expand_string ( const std::string & str )

inlineprivate

dollar bracket expressions

在文件 getpot.h 第 2771 行定义.

参考 _DBE_expand().

参考自 _parse_argument_vector().

 {
   // Parses for closing operators '${ }' and expands them letting
   // white spaces and other letters as they are.
   std::string   new_string = "";
   unsigned open_brackets = 0;
   unsigned first = 0;
   for (unsigned i = 0;  i<str.size(); i++)
     {
       if (i + 2 < str.size() && str.substr(i, 2) == "${")
         {
           if (open_brackets == 0)
             first = i+2;
           open_brackets++;
         }
       else if (str[i] == '}' && open_brackets > 0)
         {
           open_brackets -= 1;
           if (open_brackets == 0)
             {
               const std::string Replacement = _DBE_expand(str.substr(first, i - first));
               new_string += Replacement;
             }
         }
       else if (open_brackets == 0)
         new_string += str[i];
     }
   return new_string;
 }

STRING_VECTOR GETPOT_NAMESPACE::GetPot::_DBE_get_expr_list	(	const std::string &	str,
		const unsigned	ExpectedNumber
	)

inlineprivate

在文件 getpot.h 第 2804 行定义.

参考 _DBE_expand().

参考自 _DBE_expand().

 {
   // ensures that the resulting vector has the expected number
   // of arguments, but they may contain an error message
   std::string str = str_;
   // Separates expressions by non-bracketed whitespaces, expands them
   // and puts them into a list.
 
   unsigned i=0;
   // (1) eat initial whitespaces
   for (; i < str.size(); i++)
     if (!std::isspace(str[i]))
       break;
 
   STRING_VECTOR   expr_list;
   unsigned         open_brackets = 0;
   std::vector<unsigned> start_idx;
   unsigned         start_new_string = i;
   unsigned         l = (unsigned)(str.size());
 
   // (2) search for ${ } expressions ...
   while (i < l)
     {
       const char letter = str[i];
       // whitespace -> end of expression
       if (std::isspace(letter) && open_brackets == 0)
         {
           expr_list.push_back(str.substr(start_new_string, i - start_new_string));
           bool no_breakout_f = true;
           for (i++; i < l ; i++)
             {
               if (!std::isspace(str[i]))
                 {
                   no_breakout_f = false;
                   start_new_string = i;
                   break;
                 }
             }
 
           if (no_breakout_f)
             {
               // end of expression list
               if (expr_list.size() < ExpectedNumber)
                 {
                   const std::string   pre_tmp("<< ${ }: missing arguments>>");
                   STRING_VECTOR tmp(ExpectedNumber - expr_list.size(), pre_tmp);
                   expr_list.insert(expr_list.end(), tmp.begin(), tmp.end());
                 }
               return expr_list;
             }
         }
 
       // dollar-bracket expression
       if (str.length() >= i+2 && str.substr(i, 2) == "${")
         {
           open_brackets++;
           start_idx.push_back(i+2);
         }
 
       else if (letter == '}' && open_brackets > 0)
         {
           int start = start_idx[start_idx.size()-1];
           start_idx.pop_back();
           const std::string Replacement = _DBE_expand(str.substr(start, i-start));
           if (start - 3 < (int)0)
             str = Replacement + str.substr(i+1);
           else
             str = str.substr(0, start-2) + Replacement + str.substr(i+1);
           l = (int)(str.size());
           i = start + (int)(Replacement.size()) - 3;
           open_brackets--;
         }
       i++;
     }
 
   // end of expression list
   expr_list.push_back(str.substr(start_new_string, i-start_new_string));
 
   if (expr_list.size() < ExpectedNumber)
     {
       const std::string   pre_tmp("<< ${ }: missing arguments>>");
       STRING_VECTOR tmp(ExpectedNumber - expr_list.size(), pre_tmp);
       expr_list.insert(expr_list.end(), tmp.begin(), tmp.end());
     }
 
   return expr_list;
 }

const GetPot::variable * GETPOT_NAMESPACE::GetPot::_DBE_get_variable ( const std::string & str )

inlineprivate

在文件 getpot.h 第 2895 行定义.

参考 _request_variable(), GETPOT_NAMESPACE::GetPot::variable::original, prefix , 以及 section.

参考自 _DBE_expand().

 {
   static GetPot::variable ev;
   std::string secure_Prefix = prefix;
 
   prefix = section;
   // (1) first search in currently active section
   const GetPot::variable* var = _request_variable(VarName.c_str());
   if (var != 0)
     {
       prefix = secure_Prefix;
       return var;
     }
 
   // (2) search in root name space
   prefix = "";
   var = _request_variable(VarName.c_str());
   if (var != 0)
     {
       prefix = secure_Prefix;
       return var;
     }
 
   prefix = secure_Prefix;
 
   // error occurred => variable name == ""
   ev.original = "<<${ } variable '";
   ev.original += VarName + "' undefined>>";
   return &ev;
 }

const GetPot::variable * GETPOT_NAMESPACE::GetPot::_find_variable ( const char * VarName ) const

inlineprivate

helpers for argument list processing

search for a variable in 'variables' array

在文件 getpot.h 第 2658 行定义.

参考 prefix , 以及 variables.

参考自 _request_variable() , 以及 _set_variable().

 {
   const std::string Name = prefix + VarName;
 
   std::vector<variable>::const_iterator it = variables.begin();
   for (; it != variables.end(); ++it)
     {
       if ((*it).name == Name)
         return &(*it);
     }
   return 0;
 }

const std::string GETPOT_NAMESPACE::GetPot::_get_next_token ( std::istream & istr )

inlineprivate

在文件 getpot.h 第 1368 行定义.

参考 _get_string(), _get_until_closing_bracket() , 以及 _get_until_closing_square_bracket().

参考自 _read_in_stream().

 {
   // get next concatenates string token. consider quotes that embrace
   // whitespaces
   std::string token;
   int    tmp = 0;
   while (true)
     {
       int last_letter = tmp;
       tmp = istr.get();
 
       if (tmp == '=')
         {
           // Always break at '='.
           // This separates '=' at the beginning of a word into its own word.
           token += getpot_cast_int<char>(tmp);
           return token;
         }
 
       else if (tmp == EOF || ((tmp == ' ' || tmp == '\t' || tmp == '\n') && last_letter != '\\'))
         return token;
 
       else if (tmp == '\'' && last_letter != '\\')
         {
           // QUOTES: un-backslashed quotes => it's a string
           token += _get_string(istr);
           continue;
         }
 
       else if (tmp == '{' && last_letter == '$')
         {
           token += '{' + _get_until_closing_bracket(istr);
           continue;
         }
 
       else if (tmp == '[')
         {
           token += '[' + _get_until_closing_square_bracket(istr);
           continue;
         }
 
       else if (tmp == '$' && last_letter == '\\')
         {
           token += getpot_cast_int<char>(tmp); tmp = 0;  //  so that last_letter will become = 0, not '$';
           continue;
         }
 
       else if (tmp == '\\' && last_letter != '\\')
         continue;              // don't append un-backslashed backslashes
 
       token += getpot_cast_int<char>(tmp);
     }
 }

const std::string GETPOT_NAMESPACE::GetPot::_get_remaining_string	(	const std::string &	String,
		const std::string &	Start
	)		const

inlineprivate

prefix extraction

在文件 getpot.h 第 1739 行定义.

参考自 argument_contains(), get_variable_names(), next(), options_contain(), unidentified_arguments(), unidentified_flags(), unidentified_nominuses(), unidentified_options(), unidentified_sections() , 以及 unidentified_variables().

 {
   if (Start == "")
     return String;
 
   // note: java.lang.String: substring(a,b) = from a to b-1
   //        C++ string:      substr(a,b)    = from a to a + b
   if (String.find(Start) == 0)
     return String.substr(Start.length());
 
   else
     return "";
 }

static STRING_VECTOR GETPOT_NAMESPACE::GetPot::_get_section_tree ( const std::string & FullPath )

inlinestaticprivate

cuts a variable name into a tree of sub-sections.

this is requested for recording requested sections when dealing with 'ufo' detection.

在文件 getpot.h 第 702 行定义.

参考自 _record_argument_request() , 以及 _record_variable_request().

   {
     STRING_VECTOR   result;
     for (std::size_t pos = 0; pos != FullPath.size(); ++pos)
       {
         if (FullPath[pos] == '/')
           result.push_back(FullPath.substr(0,pos));
       }
 
     return result;
   }

const std::string GETPOT_NAMESPACE::GetPot::_get_string ( std::istream & istr )

inlineprivate

在文件 getpot.h 第 1425 行定义.

参考自 _get_next_token().

 {
   // parse input until next matching '
   std::string str;
   int    tmp = 0;
   while (true)
     {
       int last_letter = tmp;
       tmp = istr.get();
       if (tmp == EOF)
         return str;
 
       // un-backslashed quotes => it's the end of the string
       else if (tmp == '\'' && last_letter != '\\')
         return str;
 
       else if (tmp == '\\' && last_letter != '\\')
         continue; // don't append
 
       str += getpot_cast_int<char>(tmp);
     }
 }

const std::string GETPOT_NAMESPACE::GetPot::_get_until_closing_bracket ( std::istream & istr )

inlineprivate

在文件 getpot.h 第 1451 行定义.

参考自 _get_next_token().

 {
   // parse input until next matching }
   std::string str = "";
   int    tmp = 0;
   int    brackets = 1;
   while (true)
     {
       int last_letter = tmp;
       tmp = istr.get();
       if (tmp == EOF)
         return str;
 
       else if (tmp == '{' && last_letter == '$')
         brackets += 1;
 
       else if (tmp == '}')
         {
           brackets -= 1;
           // un-backslashed brackets => it's the end of the string
           if (brackets == 0)
             return str + '}';
 
           else if (tmp == '\\' && last_letter != '\\')
             continue;  // do not append an unbackslashed backslash
         }
       str += getpot_cast_int<char>(tmp);
     }
 }

const std::string GETPOT_NAMESPACE::GetPot::_get_until_closing_square_bracket ( std::istream & istr )

inlineprivate

在文件 getpot.h 第 1484 行定义.

参考自 _get_next_token().

 {
   // parse input until next matching ]
   std::string str = "";
   int    brackets = 1;
   while (true)
     {
       int tmp = istr.get();
       if (tmp == EOF)
         return str;
 
       else if (tmp == '[')
         brackets += 1;
 
       else if (tmp == ']')
         {
           brackets -= 1;
           if (brackets == 0)
             return str + ']';
         }
 
       str += getpot_cast_int<char>(tmp);
     }
 }

const char * GETPOT_NAMESPACE::GetPot::_internal_managed_copy ( const std::string & Arg ) const

inlineprivate

some functions return a char pointer to a temporarily existing string this function adds them to our container

在文件 getpot.h 第 1707 行定义.

参考 _internal_string_container.

参考自 direct_follow(), follow(), get_value_no_default(), next(), next_nominus() , 以及 operator()().

 {
   const char* arg = Arg.c_str();
 
   // Get a lock before touching anything mutable
   SCOPED_MUTEX;
 
   // See if there's already an identical string saved
   std::set<const char*,ltstr>::const_iterator it =
     _internal_string_container.find(arg);
 
   // If so, return it
   if (it != _internal_string_container.end())
     return *it;
 
   // Otherwise, create a new one
   const std::size_t bufsize = strlen(arg)+1;
   char* newcopy = new char[bufsize];
   strncpy(newcopy, arg, bufsize);
   _internal_string_container.insert(newcopy);
   return newcopy;
 }

const char * GETPOT_NAMESPACE::GetPot::_match_starting_string ( const char * StartString )

inlineprivate

support finding directly followed arguments

在文件 getpot.h 第 2060 行定义.

参考 argv, cursor, search_failed_f , 以及 search_loop_f.

参考自 direct_follow().

 {
   const unsigned N =
     getpot_cast_int<unsigned>(strlen(StartString));
   unsigned       OldCursor = cursor;
 
   if (OldCursor >= argv.size())
     OldCursor = getpot_cast_int<unsigned>(argv.size() - 1);
   search_failed_f = true;
 
   // (*) first loop from cursor position until end
   for (unsigned c = cursor; c < argv.size(); c++)
     {
       if (strncmp(StartString, argv[c].c_str(), N) == 0)
         {
           cursor = c;
           search_failed_f = false;
           return &(argv[c].c_str()[N]);
         }
     }
 
   if (!search_loop_f)
     return NULL;
 
   // (*) second loop from 0 to old cursor position
   for (unsigned c = 1; c < OldCursor; c++)
     {
       if (strncmp(StartString, argv[c].c_str(), N) == 0)
         {
           cursor = c;
           search_failed_f = false;
           return &(argv[c].c_str()[N]);
         }
     }
   return 0;
 }

void GETPOT_NAMESPACE::GetPot::_parse_argument_vector ( const STRING_VECTOR & ARGV )

inlineprivate

produce three basic data vectors:

argument vector
nominus vector
variable dictionary

在文件 getpot.h 第 1131 行定义.

参考 _comment_end, _comment_start, _DBE_expand_string(), _field_separator, _process_section_label(), _requested_arguments, _set_variable(), argv, idx_nominus, parse_input_file(), request_recording_f, section , 以及 section_list.

参考自 parse_command_line() , 以及 parse_input_stream().

 {
   if (ARGV.empty())
     return;
 
   // build internal databases:
   //   1) array with no-minus arguments (usually used as filenames)
   //   2) variable assignments:
   //             'variable name' '=' number | string
   STRING_VECTOR                 section_stack;
   STRING_VECTOR::const_iterator it = ARGV.begin();
 
 
   section = "";
 
   // -- do not parse the first argument, so that this parsing source
   // name is not interpreted a s a nominus or so.  If we already
   // have parsed arguments, don't bother adding another parsing
   // source name
   if (argv.empty())
     argv.push_back(*it);
   ++it;
 
   // -- loop over remaining arguments
   for (; it != ARGV.end(); ++it)
     {
       std::string arg = *it;
 
       if (arg.length() == 0)
         continue;
 
       // -- [section] labels and [include file] directives
       if (arg.length() > 1 && arg[0] == '[' && arg[arg.length()-1] == ']')
         {
 
           // Is this an include file directive?
           std::size_t include_pos = arg.find("include ", 1);
           if (include_pos != std::string::npos)
             {
 
               const std::string includefile =
                 _DBE_expand_string(arg.substr(9, arg.length()-9-include_pos));
 
               this->parse_input_file
                 (includefile, _comment_start, _comment_end, _field_separator);
             }
 
           else
             {
               // (*) sections are considered 'requested arguments'
               if (request_recording_f)
                 {
                   // Get a lock before touching anything mutable
                   SCOPED_MUTEX;
 
                   _requested_arguments.insert(arg);
                 }
 
               const std::string Name = _DBE_expand_string(arg.substr(1, arg.length()-2));
               section = _process_section_label(Name, section_stack);
               // new section --> append to list of sections
               if (find(section_list.begin(), section_list.end(), section) == section_list.end())
                 if (section.length() != 0) section_list.push_back(section);
               argv.push_back(arg);
             }
         }
       else
         {
           arg = section + _DBE_expand_string(arg);
           argv.push_back(arg);
         }
 
       // -- separate array for nominus arguments
       if (arg[0] != '-')
         idx_nominus.push_back(getpot_cast_int<unsigned>(argv.size()-1));
 
       // -- variables: does arg contain a '=' operator ?
       const std::size_t equals_pos = arg.find_first_of('=');
       if (equals_pos != std::string::npos)
         {
           // (*) record for later ufo detection
           //     arguments carrying variables are always treated as 'requested' arguments.
           //     unrequested variables have to be detected with the ufo-variable
           //     detection routine.
           if (request_recording_f)
             {
               // Get a lock before touching anything mutable
               SCOPED_MUTEX;
 
               _requested_arguments.insert(arg);
             }
 
           // => arg (from start to '=') = Name of variable
           //        (from '=' to end)   = value of variable
           _set_variable(arg.substr(0,equals_pos),
                         arg.substr(equals_pos+1), false);
         }
     }
 }

std::string GETPOT_NAMESPACE::GetPot::_process_section_label	(	const std::string &	Section,
		STRING_VECTOR &	section_stack
	)

inlineprivate

在文件 getpot.h 第 1512 行定义.

参考自 _parse_argument_vector().

 {
   std::string sname = Section;
   //  1) subsection of actual section ('./' prefix)
   if (sname.length() >= 2 && sname.substr(0, 2) == "./")
     sname = sname.substr(2);
 
   //  2) subsection of parent section ('../' prefix)
   else if (sname.length() >= 3 && sname.substr(0, 3) == "../")
     {
       do
         {
           if (section_stack.end() != section_stack.begin())
             section_stack.pop_back();
           sname = sname.substr(3);
         } while (sname.substr(0, 3) == "../");
     }
 
   // 3) subsection of the root-section
   else
     // [] => back to root section
     section_stack.erase(section_stack.begin(), section_stack.end());
 
   if (sname != "")
     {
       // parse section name for 'slashes'
       unsigned i=0;
       while (i < sname.length())
         {
           if (sname[i] == '/')
             {
               section_stack.push_back(sname.substr(0,i));
               if (i+1 < sname.length())
                 sname = sname.substr(i+1);
               i = 0;
             }
           else
             i++;
         }
       section_stack.push_back(sname);
     }
 
   std::string section_label = "";
   if (!section_stack.empty())
     {
       victorate(std::string, section_stack, it)
         section_label += *it + "/";
     }
   return section_label;
 }

STRING_VECTOR GETPOT_NAMESPACE::GetPot::_read_in_stream ( std::istream & istr )

inlineprivate

在文件 getpot.h 第 1234 行定义.

参考 _comment_start, _get_next_token() , 以及 _skip_whitespace().

参考自 parse_input_stream().

 {
   STRING_VECTOR  brute_tokens;
   while (istr)
     {
       _skip_whitespace(istr);
       const std::string Token = _get_next_token(istr);
       // Allow 'keyword =' to parse with an empty string as value.
       // Only break at EOF.
       // if (Token.length() == 0 || Token[0] == EOF) break;
       if (Token[0] == EOF)
         break;
       brute_tokens.push_back(Token);
     }
 
   // -- reduce expressions of token1'='token2 to a single
   //    string 'token1=token2'
   // -- copy everything into 'argv'
   // -- arguments preceded by something like '[' name ']' (section)
   //    produce a second copy of each argument with a prefix '[name]argument'
   unsigned i1 = 0;
   unsigned i2 = 1;
   unsigned i3 = 2;
 
   STRING_VECTOR  arglist;
   while (i1 < brute_tokens.size())
     {
       // 1) concatenate 'abcdef' '=' 'efgasdef' to 'abcdef=efgasdef'
       // note: java.lang.String: substring(a,b) = from a to b-1
       //        C++ string:      substr(a,b)    = from a to a + b
       std::string result;
       if (i2 < brute_tokens.size() && brute_tokens[i2] == "=")
         {
           if (i3 >= brute_tokens.size())
             result = brute_tokens[i1] + brute_tokens[i2];
           else
             result = brute_tokens[i1] + brute_tokens[i2] + brute_tokens[i3];
           i1 = i3+1; i2 = i3+2; i3 = i3+3;
         }
       else if (i2 < brute_tokens.size() &&
                brute_tokens[i2].length() > 0 &&
                brute_tokens[i2][0] == '=')
         {
           // This case should not be hit if '=' at the beginning of a word
           //   is always separated into its own word
           result = brute_tokens[i1] + brute_tokens[i2];
           i1 = i3; i2 = i3+1; i3 = i3+2;
         }
       else if (i2 < brute_tokens.size() && brute_tokens[i1][brute_tokens[i1].size()-1] == '=')
         {
           result = brute_tokens[i1] + brute_tokens[i2];
           i1 = i3; i2 = i3+1; i3 = i3+2;
         }
       else
         {
           result = brute_tokens[i1];
           i1=i2; i2=i3; i3++;
         }
 
       // Now strip out any comment
       size_t comment_start_loc = result.find(_comment_start, 0);
       if (comment_start_loc != std::string::npos)
         result = result.substr(0, comment_start_loc);
 
       arglist.push_back(result);
     }
   return arglist;
 }

void GETPOT_NAMESPACE::GetPot::_record_argument_request ( const std::string & Arg ) const

inlineprivate

if an argument is requested record it and the 'tag' the section branch to which it belongs.

Caution: both functions mark the sections as 'tagged'. These are "const" functions but they do modify the mutable requested* members

在文件 getpot.h 第 2457 行定义.

参考 _get_section_tree(), _requested_arguments, _requested_sections, request_recording_f , 以及 section.

参考自 argument_contains(), direct_follow(), next(), next_nominus(), next_nominus_string(), nominus_vector() , 以及 search().

 {
   if (!request_recording_f)
     return;
 
   // Get a lock before touching anything mutable
   SCOPED_MUTEX;
 
   // (*) record requested variable for later ufo detection
   _requested_arguments.insert(Name);
 
   // (*) record considered section for ufo detection
   STRING_VECTOR      STree = _get_section_tree(Name);
   victorate(std::string, STree, it)
     if (_requested_sections.find(*it) == _requested_sections.end())
       if (section.length() != 0)
         _requested_sections.insert(*it);
 }

void GETPOT_NAMESPACE::GetPot::_record_variable_request ( const std::string & Arg ) const

inlineprivate

在文件 getpot.h 第 2479 行定义.

参考 _get_section_tree(), _requested_sections, _requested_variables, request_recording_f , 以及 section.

参考自 _request_variable().

 {
   if (!request_recording_f)
     return;
 
   // Get a lock before touching anything mutable
   SCOPED_MUTEX;
 
   // (*) record requested variable for later ufo detection
   _requested_variables.insert(Name);
 
   // (*) record considered section for ufo detection
   STRING_VECTOR      STree = _get_section_tree(Name);
   victorate(std::string, STree, it)
     if (_requested_sections.find(*it) == _requested_sections.end())
       if (section.length() != 0)
         _requested_sections.insert(*it);
 }

const GetPot::variable * GETPOT_NAMESPACE::GetPot::_request_variable ( const char * VarName ) const

inlineprivate

search (and record request) for a variable in 'variables' array

在文件 getpot.h 第 2674 行定义.

参考 _find_variable() , 以及 _record_variable_request().

参考自 _DBE_get_variable(), _set_variable(), get_value_no_default(), have_variable(), operator()() , 以及 vector_variable_size().

 {
   // (*) record requested variable for later ufo detection
   this->_record_variable_request(VarName);
 
   return this->_find_variable(VarName);
 }

bool GETPOT_NAMESPACE::GetPot::_search_string_vector	(	const STRING_VECTOR &	Vec,
		const std::string &	Str
	)		const

inlineprivate

search for a specific string

在文件 getpot.h 第 3434 行定义.

 {
   victorate(std::string, VecStr, itk)
     {
       if (*itk == Str)
         return true;
     }
   return false;
 }

void GETPOT_NAMESPACE::GetPot::_set_variable	(	const std::string &	VarName,
		const std::string &	Value,
		const bool	Requested
	)

inlineprivate

helper functions

set variable from inside GetPot (no prefix considered)

在文件 getpot.h 第 2503 行定义.

参考 _field_separator, _find_variable(), _request_variable(), overridden_vars , 以及 variables.

参考自 _parse_argument_vector() , 以及 set().

 {
   const GetPot::variable* Var = Requested ?
     _request_variable(VarName.c_str()) :
     _find_variable(VarName.c_str());
   if (Var == 0)
     variables.push_back(variable(VarName.c_str(), Value.c_str(), _field_separator.c_str()));
   else
     {
       overridden_vars.insert(VarName.c_str());
       (const_cast<GetPot::variable*>(Var))->take(Value.c_str(), _field_separator.c_str());
     }
 }

void GETPOT_NAMESPACE::GetPot::_skip_whitespace ( std::istream & istr )

inlineprivate

helpers to parse input file create an argument vector based on data found in an input file, i.e.

: 1) delete comments (in between '_comment_start' '_comment_end') 2) contract assignment expressions, such as my-variable = '007 J. B.' into my-variable='007 J. B.' 3) interpret sections like '[../my-section]' etc.

在文件 getpot.h 第 1306 行定义.

参考 _comment_end , 以及 _comment_start.

参考自 _read_in_stream().

 {
   // find next non-whitespace while deleting comments
   int tmp = istr.get();
   do {
     // -- search a non whitespace
     while (std::isspace(tmp))
       {
         tmp = istr.get();
         if (!istr)
           return;
       }
 
     // -- look if characters match the comment starter string
     for (unsigned i=0; i<_comment_start.length() ; i++)
       {
         if (tmp != _comment_start[i])
           {
             // -- one step more backwards, since 'tmp' already at non-whitespace
             istr.unget();
             return;
           }
 
         // RHS: Why is this here?  It breaks on empty comments
         //    tmp = istr.get();
         //    if (!istr) { istr.unget(); return; }
       }
     // 'tmp' contains last character of _comment_starter
 
     // -- comment starter found -> search for comment ender
     unsigned match_no=0;
     while (true)
       {
         tmp = istr.get();
         if (!istr)
           {
             istr.unget();
             return;
           }
 
         if (tmp == _comment_end[match_no])
           {
             match_no++;
             if (match_no == _comment_end.length())
               {
                 istr.unget();
                 break; // shuffle more whitespace, end of comment found
               }
           }
         else
           match_no = 0;
       }
 
     tmp = istr.get();
 
   } while (istr);
   istr.unget();
 }

void GETPOT_NAMESPACE::GetPot::absorb ( const GetPot & Other )

inline

absorbing contents of another GetPot object

在文件 getpot.h 第 1088 行定义.

参考 _requested_arguments, _requested_sections, _requested_variables, argv, request_recording_f , 以及 variables.

 {
   if (&Other == this)
     return;
 
   // variables that are not influenced by absorption:
   //               _comment_start
   //               _comment_end
   //               cursor
   //               nominus_cursor
   //               search_failed
   //               idx_nominus
   //               search_loop_f
   argv      = Other.argv;
   variables = Other.variables;
 
   if (request_recording_f)
     {
       // Get a lock before touching anything mutable
       SCOPED_MUTEX;
 
       _requested_arguments.insert(Other._requested_arguments.begin(), Other._requested_arguments.end());
       _requested_variables.insert(Other._requested_variables.begin(), Other._requested_variables.end());
       _requested_sections.insert(Other._requested_sections.begin(), Other._requested_sections.end());
     }
 }

bool GETPOT_NAMESPACE::GetPot::argument_contains	(	unsigned	Idx,
		const char *	FlagList
	)		const

inline

在文件 getpot.h 第 2123 行定义.

参考 _check_flags(), _get_remaining_string(), _record_argument_request(), argv , 以及 prefix.

 {
   if (Idx >= argv.size())
     return false;
 
   // (*) record requested of argument for later ufo-detection
   //     an argument that is checked for flags is considered to be 'requested'
   _record_argument_request(argv[Idx]);
 
   if (prefix == "")
     // search argument for any flag in flag list
     return _check_flags(argv[Idx], FlagList);
 
   // if a prefix is set, then the argument index is the index
   //   inside the 'namespace'
   // => only check list of arguments that start with prefix
   unsigned no_matches = 0;
   for (unsigned i=0; i<argv.size(); i++)
     {
       const std::string Remain = _get_remaining_string(argv[i], prefix);
       if (Remain != "")
         {
           no_matches += 1;
           if (no_matches == Idx)
             return _check_flags(Remain, FlagList);
         }
     }
 
   // no argument in this namespace
   return false;
 }

void GETPOT_NAMESPACE::GetPot::clear_requests ( )

inline

for ufo detection: recording requested arguments, options etc.

在文件 getpot.h 第 1118 行定义.

参考 _requested_arguments, _requested_sections , 以及 _requested_variables.

 {
   // Get a lock before touching anything mutable
   SCOPED_MUTEX;
 
   _requested_arguments.clear();
   _requested_variables.clear();
   _requested_sections.clear();
 }

template<typename T >

T GETPOT_NAMESPACE::GetPot::direct_follow	(	const T &	Default,
		const char *	Option
	)

inline

directly followed arguments

在文件 getpot.h 第 2031 行定义.

参考 _convert_to_type(), _match_starting_string(), _record_argument_request(), argv , 以及 cursor.

参考自 direct_follow().

 {
   const char* FollowStr = _match_starting_string(Option);
 
   // (*) record requested of argument for later ufo-detection
   _record_argument_request(std::string(Option) + FollowStr);
 
   if (FollowStr == 0)
     return Default;
 
   if (++cursor >= argv.size())
     cursor = getpot_cast_int<unsigned>(argv.size());
   return _convert_to_type(FollowStr, Default);
 }

const char * GETPOT_NAMESPACE::GetPot::direct_follow	(	const char *	Default,
		const char *	Option
	)

inline

在文件 getpot.h 第 2049 行定义.

参考 _internal_managed_copy() , 以及 direct_follow().

 {
   return _internal_managed_copy(direct_follow(std::string(Default), Option));
 }

void GETPOT_NAMESPACE::GetPot::disable_loop ( )

inline

enable/disable search for an option in loop

在文件 getpot.h 第 361 行定义.

参考 search_loop_f.

参考自 init_multiple_occurrence().

361 { search_loop_f = false; }

GETPOT_NAMESPACE::GetPot::search_loop_f

bool search_loop_f

Definition: getpot.h:518

void GETPOT_NAMESPACE::GetPot::disable_request_recording ( )

inline

在文件 getpot.h 第 210 行定义.

参考 request_recording_f.

210 { request_recording_f = false; }

GETPOT_NAMESPACE::GetPot::request_recording_f

bool request_recording_f

Definition: getpot.h:584

void GETPOT_NAMESPACE::GetPot::enable_loop ( )

inline

在文件 getpot.h 第 362 行定义.

参考 search_loop_f.

362 { search_loop_f = true; }

GETPOT_NAMESPACE::GetPot::search_loop_f

bool search_loop_f

Definition: getpot.h:518

void GETPOT_NAMESPACE::GetPot::enable_request_recording ( )

inline

在文件 getpot.h 第 211 行定义.

参考 request_recording_f.

211 { request_recording_f = true; }

GETPOT_NAMESPACE::GetPot::request_recording_f

bool request_recording_f

Definition: getpot.h:584

template<typename T >

T GETPOT_NAMESPACE::GetPot::follow	(	const T &	Default,
		const char *	Option
	)

inline

search for option and get argument at cursor++

在文件 getpot.h 第 1949 行定义.

参考 next() , 以及 search().

参考自 follow().

 {
   // (*) record requested of argument is entirely handled in 'search()' and 'next()'
   if (search(Option) == false)
     return Default;
 
   return next(Default);
 }

const char * GETPOT_NAMESPACE::GetPot::follow	(	const char *	Default,
		const char *	Option
	)

inline

在文件 getpot.h 第 1961 行定义.

参考 _internal_managed_copy() , 以及 follow().

 {
   return _internal_managed_copy(follow(std::string(Default), Option));
 }

template<typename T >

T GETPOT_NAMESPACE::GetPot::follow	(	const T &	Default,
		unsigned	No,
		const char *	Option,
			...
	)

inline

search for one of the given options and get argument that follows it

const char * GETPOT_NAMESPACE::GetPot::follow	(	const char *	Default,
		unsigned	No,
		const char *	Option,
			...
	)

inline

在文件 getpot.h 第 1999 行定义.

参考 next() , 以及 search().

 {
   // (*) record requested of argument is entirely handled in 'search()' and 'next()'
   if (No == 0)
     return Default;
 
   if (search(P) == true)
     return next(Default);
 
   va_list ap;
   va_start(ap, P);
   for (unsigned i=1; i<No; i++)
     {
       char* Opt = va_arg(ap, char *);
       if (search(Opt) == true)
         {
           va_end(ap);
           return next(Default);
         }
     }
   va_end(ap);
   return Default;
 }

template<typename T >

T GETPOT_NAMESPACE::GetPot::follow	(	const T &	Default,
		unsigned int	No,
		const char *	P,
			...
	)

inline

在文件 getpot.h 第 1972 行定义.

参考 next() , 以及 search().

 {
   // (*) record requested of argument is entirely handled in 'search()' and 'next()'
   if (No == 0)
     return Default;
 
   if (search(P) == true)
     return next(Default);
 
   va_list ap;
   va_start(ap, P);
   for (unsigned i=1; i<No; i++)
     {
       char* Opt = va_arg(ap, char *);
       if (search(Opt) == true)
         {
           va_end(ap);
           return next(Default);
         }
     }
   va_end(ap);
   return Default;
 }

template<typename T >

T GETPOT_NAMESPACE::GetPot::get	(	unsigned	Idx,
		const T &	Default
	)		const

inline

const char* GETPOT_NAMESPACE::GetPot::get	(	unsigned	Idx,
		const char *	Default
	)		const

inline

template<typename T >

T GETPOT_NAMESPACE::GetPot::get	(	unsigned int	Idx,
		const T &	Default
	)		const

inline

在文件 getpot.h 第 1886 行定义.

参考 _convert_to_type() , 以及 argv.

 {
   if (Idx >= argv.size())
     return Default;
   return _convert_to_type(argv[Idx], Default);
 }

std::set< std::string > GETPOT_NAMESPACE::GetPot::get_overridden_variables ( ) const

inline

在文件 getpot.h 第 2650 行定义.

参考 overridden_vars.

 {
   return overridden_vars;
 }

std::set< std::string > GETPOT_NAMESPACE::GetPot::get_requested_arguments ( ) const

inline

Accessors for requested variables.

在文件 getpot.h 第 3884 行定义.

参考 _requested_arguments.

 {
   return _requested_arguments;
 }

std::set< std::string > GETPOT_NAMESPACE::GetPot::get_requested_sections ( ) const

inline

在文件 getpot.h 第 3902 行定义.

参考 _requested_sections.

 {
   return _requested_sections;
 }

std::set< std::string > GETPOT_NAMESPACE::GetPot::get_requested_variables ( ) const

inline

在文件 getpot.h 第 3893 行定义.

参考 _requested_variables.

 {
   return _requested_variables;
 }

STRING_VECTOR GETPOT_NAMESPACE::GetPot::get_section_names ( ) const

inline

在文件 getpot.h 第 2592 行定义.

参考 section_list.

 {
   return section_list;
 }

STRING_VECTOR GETPOT_NAMESPACE::GetPot::get_subsection_names ( const std::string & section_name ) const

inline

在文件 getpot.h 第 2600 行定义.

参考 section_list.

 {
   // GetPot functions should understand user-provided section names
   // either with or without a trailing slash.
   const std::string full_prefix =
     *sec_prefix.rbegin() == '/' ? sec_prefix : sec_prefix + '/';
 
   const std::size_t full_prefix_len = full_prefix.size();
 
   // Subsections-of-subsections are in the section_list, so we'll be
   // adding subsections multiple times.  Using std::set as an
   // intermediate data structure helps us check for duplicates with
   // O(N log N) rather than O(N^2) cost.
   std::set<std::string> subsections;
 
   STRING_VECTOR returnval;
 
   for (STRING_VECTOR::const_iterator it = section_list.begin();
        it != section_list.end(); ++it)
     {
       const std::string & section_name = *it;
 
       // If this section name begins with the prefix
       if (section_name.compare(0, full_prefix_len, full_prefix) == 0)
         {
           const std::size_t next_slash_len =
             section_name.find('/', full_prefix_len);
 
           const std::string subsection_name =
             section_name.substr(full_prefix_len,
                                 next_slash_len - full_prefix_len);
 
           // If there is a subsection, and if this is the first time
           // we've seen it, add the prefix-less, postfix-less
           // subsection name.
           if (!subsection_name.empty() &&
               !subsections.count(subsection_name))
             {
               returnval.push_back(subsection_name);
               subsections.insert(subsection_name);
             }
         }
     }
 
   return returnval;
 }

template<typename T >

T GETPOT_NAMESPACE::GetPot::get_value_no_default	(	const char *	VarName,
		const T &	Default
	)		const

inline

access variables, but error out if not present scalar values

在文件 getpot.h 第 2369 行定义.

参考 _convert_to_type_no_default(), _request_variable() , 以及 GETPOT_NAMESPACE::GetPot::variable::original.

参考自 get_value_no_default().

 {
   // (*) recording of requested variables happens in '_request_variable()'
   const variable*  sv = _request_variable(VarName);
   if (sv == 0)
     {
       getpot_cerr << "ERROR: cannot find variable "<<VarName<<std::endl;
       getpot_error();
     }
   return _convert_to_type_no_default(VarName, sv->original, Default);
 }

template<typename T >

T GETPOT_NAMESPACE::GetPot::get_value_no_default	(	const std::string &	VarName,
		const T &	Default
	)		const

inline

在文件 getpot.h 第 2385 行定义.

参考 get_value_no_default().

 {
   return get_value_no_default(VarName.c_str(),Default);
 }

const char * GETPOT_NAMESPACE::GetPot::get_value_no_default	(	const char *	VarName,
		const char *	Default
	)		const

inline

在文件 getpot.h 第 2393 行定义.

参考 _internal_managed_copy() , 以及 get_value_no_default().

 {
   return _internal_managed_copy(get_value_no_default(VarName, std::string(Default)));
 }

const char * GETPOT_NAMESPACE::GetPot::get_value_no_default	(	const std::string &	VarName,
		const char *	Default
	)		const

inline

在文件 getpot.h 第 2401 行定义.

参考 get_value_no_default().

 {
   return get_value_no_default(VarName.c_str(),Default);
 }

template<typename T >

T GETPOT_NAMESPACE::GetPot::get_value_no_default	(	const char *	VarName,
		const T &	Default,
		unsigned	Idx
	)		const

inline

vectors

template<typename T >

T GETPOT_NAMESPACE::GetPot::get_value_no_default	(	const std::string &	VarName,
		const T &	Default,
		unsigned	Idx
	)		const

inline

const char* GETPOT_NAMESPACE::GetPot::get_value_no_default	(	const char *	VarName,
		const char *	Default,
		unsigned	Idx
	)		const

inline

const char* GETPOT_NAMESPACE::GetPot::get_value_no_default	(	const std::string &	VarName,
		const char *	Default,
		unsigned	Idx
	)		const

inline

template<typename T >

T GETPOT_NAMESPACE::GetPot::get_value_no_default	(	const char *	VarName,
		const T &	Default,
		unsigned int	Idx
	)		const

inline

在文件 getpot.h 第 2410 行定义.

参考 _convert_to_type_no_default(), _request_variable() , 以及 GETPOT_NAMESPACE::GetPot::variable::get_element().

 {
   // (*) recording of requested variables happens in '_request_variable()'
   const variable* sv = _request_variable(VarName);
   if (sv == 0)
     {
       getpot_cerr << "ERROR: cannot find variable "<<VarName<<std::endl;
       getpot_error();
     }
 
   const std::string*  element = sv->get_element(Idx);
   if (element == 0)
     {
       getpot_cerr << "ERROR: cannot find index "<<Idx<<" of variable "<<VarName<<std::endl;
       getpot_error();
     }
   return _convert_to_type_no_default(VarName, *element, Default);
 }

template<typename T >

T GETPOT_NAMESPACE::GetPot::get_value_no_default	(	const std::string &	VarName,
		const T &	Default,
		unsigned int	Idx
	)		const

inline

在文件 getpot.h 第 2433 行定义.

参考 get_value_no_default().

 {
   return get_value_no_default(VarName.c_str(), Default, Idx);
 }

STRING_VECTOR GETPOT_NAMESPACE::GetPot::get_variable_names ( ) const

inline

在文件 getpot.h 第 2576 行定义.

参考 _get_remaining_string(), prefix , 以及 variables.

 {
   STRING_VECTOR  result;
   std::vector<GetPot::variable>::const_iterator it = variables.begin();
   for (; it != variables.end(); ++it)
     {
       const std::string Tmp = _get_remaining_string((*it).name, prefix);
       if (Tmp != "")
         result.push_back(Tmp);
     }
   return result;
 }

bool GETPOT_NAMESPACE::GetPot::have_section ( const char * section_name ) const

inline

Check for a section name.

When querying, the section_name can be of the form Section1 or Section1/

Section1/Section2 or Section1/Section2/

etc.

在文件 getpot.h 第 2258 行定义.

 {
   std::string s = std::string(section_name);
   return this->have_section(s);
 }

bool GETPOT_NAMESPACE::GetPot::have_section ( const std::string & section_name ) const

inline

Check for a section name.

When querying, the section_name can be of the form Section1 or Section1/

Section1/Section2 or Section1/Section2/

etc.

在文件 getpot.h 第 2265 行定义.

参考 section_list.

 {
   const char slash('/');
 
   std::string::const_reverse_iterator it = section_name.rbegin();
 
   bool found_section = false;
 
   // Check if section_name ends with a "/". If not, append it for the search since
   // the section names are stored with a "/" at the end.
   if( (*it) != slash )
     // We need to use a linear search because we can't sort section_list
     // without violating some assumptions. See libMesh #481 for more discussion.
     found_section = ( std::find(section_list.begin(), section_list.end(), section_name+slash) != section_list.end() );
   else
     found_section = ( std::find(section_list.begin(), section_list.end(), section_name) != section_list.end() );
 
   return found_section;
 }

bool GETPOT_NAMESPACE::GetPot::have_variable ( const char * VarName ) const

inline

variables

check for a variable

在文件 getpot.h 第 2239 行定义.

参考 _request_variable().

参考自 have_variable().

 {
   const variable* sv = _request_variable(VarName);
 
   if (sv == 0)
     return false;
 
   return true;
 }

bool GETPOT_NAMESPACE::GetPot::have_variable ( const std::string & VarName ) const

inline

在文件 getpot.h 第 2252 行定义.

参考 have_variable().

 {
   return have_variable(VarName.c_str());
 }

void GETPOT_NAMESPACE::GetPot::init_multiple_occurrence ( )

inline

在文件 getpot.h 第 1864 行定义.

参考 disable_loop() , 以及 reset_cursor().

 {
   disable_loop();
   reset_cursor();
 }

template<typename T >

T GETPOT_NAMESPACE::GetPot::next ( const T & Default )

inline

get argument at cursor++

在文件 getpot.h 第 1916 行定义.

参考 _convert_to_type(), _get_remaining_string(), _record_argument_request(), argv, cursor, prefix , 以及 search_failed_f.

参考自 follow() , 以及 next().

 {
   if (search_failed_f)
     return Default;
   cursor++;
   if (cursor >= argv.size())
     {
       cursor = getpot_cast_int<unsigned>(argv.size());
       return Default;
     }
 
   // (*) record requested argument for later ufo detection
   _record_argument_request(argv[cursor]);
 
   const std::string Remain = _get_remaining_string(argv[cursor], prefix);
 
   return Remain != "" ? _convert_to_type(Remain, Default) : Default;
 }

const char * GETPOT_NAMESPACE::GetPot::next ( const char * Default )

inline

在文件 getpot.h 第 1938 行定义.

参考 _internal_managed_copy() , 以及 next().

 {
   return _internal_managed_copy(next(std::string(Default)));
 }

const char * GETPOT_NAMESPACE::GetPot::next_nominus ( )

inline

在文件 getpot.h 第 2192 行定义.

参考 _internal_managed_copy(), _record_argument_request(), argv, idx_nominus , 以及 nominus_cursor.

 {
   if (nominus_cursor < int(idx_nominus.size()) - 1)
     {
       const std::string Tmp = argv[idx_nominus[++nominus_cursor]];
 
       // (*) record for later ufo-detection
       _record_argument_request(Tmp);
 
       return _internal_managed_copy(Tmp);
     }
 
   return 0;
 }

std::string GETPOT_NAMESPACE::GetPot::next_nominus_string ( )

inline

在文件 getpot.h 第 2209 行定义.

参考 _record_argument_request(), argv, idx_nominus , 以及 nominus_cursor.

 {
   if (nominus_cursor < int(idx_nominus.size()) - 1)
     {
       const std::string Tmp = argv[idx_nominus[++nominus_cursor]];
 
       // (*) record for later ufo-detection
       _record_argument_request(Tmp);
 
       return Tmp;
     }
 
   return "";
 }

unsigned GETPOT_NAMESPACE::GetPot::nominus_size ( ) const

inline

在文件 getpot.h 第 414 行定义.

参考 idx_nominus.

414 { return getpot_cast_int<unsigned>(idx_nominus.size()); }

GETPOT_NAMESPACE::GetPot::idx_nominus

std::vector< unsigned > idx_nominus

Definition: getpot.h:526

STRING_VECTOR GETPOT_NAMESPACE::GetPot::nominus_vector ( ) const

inline

在文件 getpot.h 第 2173 行定义.

参考 _record_argument_request(), argv , 以及 idx_nominus.

 {
   STRING_VECTOR nv;
   std::vector<unsigned>::const_iterator it = idx_nominus.begin();
   for (; it != idx_nominus.end(); ++it)
     {
       nv.push_back(argv[*it]);
 
       // (*) record for later ufo-detection
       //     when a nominus vector is requested, the entire set of nominus arguments are
       //     tagged as 'requested'
       _record_argument_request(argv[*it]);
     }
   return nv;
 }

template<typename T >

T GETPOT_NAMESPACE::GetPot::operator()	(	const char *	VarName,
		const T &	Default
	)		const

inline

scalar values

在文件 getpot.h 第 2287 行定义.

参考 _convert_to_type(), _request_variable() , 以及 GETPOT_NAMESPACE::GetPot::variable::original.

参考自 operator()().

 {
   // (*) recording of requested variables happens in '_request_variable()'
   const variable*  sv = _request_variable(VarName);
 
   if (sv == 0)
     return Default;
 
   return _convert_to_type(sv->original, Default);
 }

template<typename T >

T GETPOT_NAMESPACE::GetPot::operator()	(	const std::string &	VarName,
		const T &	Default
	)		const

inline

在文件 getpot.h 第 2302 行定义.

参考 operator()().

 {
   return operator()(VarName.c_str(), Default);
 }

const char * GETPOT_NAMESPACE::GetPot::operator()	(	const char *	VarName,
		const char *	Default
	)		const

inline

在文件 getpot.h 第 2310 行定义.

参考 _internal_managed_copy().

 {
   return _internal_managed_copy(operator()(VarName, std::string(Default)));
 }

const char * GETPOT_NAMESPACE::GetPot::operator()	(	const std::string &	VarName,
		const char *	Default
	)		const

inline

在文件 getpot.h 第 2318 行定义.

参考 operator()().

 {
   return operator()(VarName.c_str(), Default);
 }

template<typename T >

T GETPOT_NAMESPACE::GetPot::operator()	(	const char *	VarName,
		const T &	Default,
		unsigned	Idx
	)		const

inline

vectors

template<typename T >

T GETPOT_NAMESPACE::GetPot::operator()	(	const std::string &	VarName,
		const T &	Default,
		unsigned	Idx
	)		const

inline

const char* GETPOT_NAMESPACE::GetPot::operator()	(	const char *	VarName,
		const char *	Default,
		unsigned	Idx
	)		const

inline

const char* GETPOT_NAMESPACE::GetPot::operator()	(	const std::string &	VarName,
		const char *	Default,
		unsigned	Idx
	)		const

inline

template<typename T >

T GETPOT_NAMESPACE::GetPot::operator()	(	const char *	VarName,
		const T &	Default,
		unsigned int	Idx
	)		const

inline

在文件 getpot.h 第 2327 行定义.

参考 _convert_to_type(), _request_variable() , 以及 GETPOT_NAMESPACE::GetPot::variable::get_element().

 {
   // (*) recording of requested variables happens in '_request_variable()'
   const variable* sv = _request_variable(VarName);
   if (sv == 0)
     return Default;
 
   const std::string*  element = sv->get_element(Idx);
   if (element == 0)
     return Default;
   return _convert_to_type(*element, Default);
 }

template<typename T >

T GETPOT_NAMESPACE::GetPot::operator()	(	const std::string &	VarName,
		const T &	Default,
		unsigned int	Idx
	)		const

inline

在文件 getpot.h 第 2344 行定义.

参考 operator()().

 {
   return operator()(VarName.c_str(), Default, Idx);
 }

GetPot & GETPOT_NAMESPACE::GetPot::operator= ( const GetPot & Other )

inline

在文件 getpot.h 第 1031 行定义.

参考 _comment_end, _comment_start, _field_separator, _internal_string_container, _requested_arguments, _requested_sections, _requested_variables, argv, cursor, idx_nominus, nominus_cursor, overridden_vars, prefix, request_recording_f, search_failed_f, search_loop_f, section, section_list , 以及 variables.

参考自 GETPOT_NAMESPACE::GetPot::variable::variable().

 {
   if (&Other == this)
     return *this;
 
   prefix               = Other.prefix;
   section              = Other.section;
   section_list         = Other.section_list;
   argv                 = Other.argv;
   cursor               = Other.cursor;
   search_loop_f        = Other.search_loop_f;
   search_failed_f      = Other.search_failed_f;
   nominus_cursor       = Other.nominus_cursor;
   overridden_vars      = Other.overridden_vars;
   idx_nominus          = Other.idx_nominus;
   variables            = Other.variables;
   _comment_start       = Other._comment_start;
   _comment_end         = Other._comment_end;
   _field_separator     = Other._field_separator;
   // #if !defined(GETPOT_DISABLE_MUTEX)
   //   _getpot_mtx          = Other._getpot_mtx;
   // #endif
   _requested_arguments = Other._requested_arguments;
   _requested_variables = Other._requested_variables;
   _requested_sections  = Other._requested_sections;
   request_recording_f  = Other.request_recording_f;
 
   std::set<const char*, ltstr>::const_iterator        my_it =
     _internal_string_container.begin();
   const std::set<const char*, ltstr>::const_iterator my_end =
     _internal_string_container.end();
 
   for (; my_it != my_end; ++my_it)
     delete [] *my_it;
 
   _internal_string_container.clear();
 
   std::set<const char*,ltstr>::const_iterator it =
     Other._internal_string_container.begin();
   const std::set<const char*,ltstr>::const_iterator end =
     Other._internal_string_container.end();
 
   for (; it != end; ++it)
     {
       const char* otherstr = *it;
       const std::size_t bufsize = strlen(otherstr)+1;
       char* newcopy = new char[bufsize];
       strncpy(newcopy, otherstr, bufsize);
       this->_internal_string_container.insert(newcopy);
     }
 
   return *this;
 }

const char * GETPOT_NAMESPACE::GetPot::operator[] ( unsigned Idx ) const

inline

direct access to command line arguments

在文件 getpot.h 第 1877 行定义.

参考 argv.

 {
   return idx<argv.size() ? argv[idx].c_str() : 0;
 }

bool GETPOT_NAMESPACE::GetPot::options_contain ( const char * FlagList ) const

inline

flags

在文件 getpot.h 第 2104 行定义.

参考 _check_flags(), _get_remaining_string(), argv , 以及 prefix.

 {
   // go through all arguments that start with a '-' (but not '--')
   std::string str;
   STRING_VECTOR::const_iterator it = argv.begin();
   for (; it != argv.end(); ++it)
     {
       str = _get_remaining_string(*it, prefix);
 
       if (str.length() >= 2 && str[0] == '-' && str[1] != '-')
         if (_check_flags(str, FlagList))
           return true;
     }
   return false;
 }

void GETPOT_NAMESPACE::GetPot::parse_command_line	(	const int	argc_,
		const char const	argv_,
		const char *	FieldSeparator = `0x0`
	)

inline

Re-initialization methods.

在文件 getpot.h 第 805 行定义.

参考 _basic_initialization(), _field_separator , 以及 _parse_argument_vector().

参考自 GetPot().

 {
   _basic_initialization();
 
   // if specified -> overwrite default string
   if (FieldSeparator)
     _field_separator = std::string(FieldSeparator);
 
   // -- make an internal copy of the argument list:
   STRING_VECTOR _apriori_argv;
   // -- for the sake of clarity: we do want to include the first
   //    argument of the first parsing source in the argument vector!
   //    it will not be a nominus argument, though. This gives us a
   //    minimum vector size of one which facilitates error checking
   //    in many functions. Also the user will be able to retrieve
   //    the name of his application or input file by "get[0]"
   _apriori_argv.push_back(std::string(argv_[0]));
   for (int i=1; i<argc_; i++)
     {
       std::string tmp(argv_[i]);   // recall the problem with temporaries,
       _apriori_argv.push_back(tmp);       // reference counting in argument lists ...
     }
   _parse_argument_vector(_apriori_argv);
 }

void GETPOT_NAMESPACE::GetPot::parse_input_file	(	const std::string &	FileName,
		const std::string &	CommentStart = `std::string("#")`,
		const std::string &	CommentEnd = `std::string("\n")`,
		const std::string &	FieldSeparator = `std::string(" \t\n")`
	)

inline

在文件 getpot.h 第 898 行定义.

参考 parse_input_stream().

参考自 _parse_argument_vector() , 以及 GetPot().

 {
   std::ifstream input(FileName.c_str());
 
   if (!input)
     getpot_file_error(FileName);
 
   this->parse_input_stream(input,FileName,CommentStart,CommentEnd,FieldSeparator);
 }

void GETPOT_NAMESPACE::GetPot::parse_input_stream	(	std::istream &	FileStream,
		const std::string &	FileName = `std::string("ParsedFromStream")`,
		const std::string &	CommentStart = `std::string("#")`,
		const std::string &	CommentEnd = `std::string("\n")`,
		const std::string &	FieldSeparator = `std::string(" \t\n")`
	)

inline

在文件 getpot.h 第 946 行定义.

参考 _basic_initialization(), _comment_end, _comment_start, _field_separator, _parse_argument_vector() , 以及 _read_in_stream().

参考自 GetPot() , 以及 parse_input_file().

 {
   _basic_initialization();
 
   // overwrite default strings
   _comment_start = std::string(CommentStart);
   _comment_end   = std::string(CommentEnd);
   _field_separator = FieldSeparator;
 
   STRING_VECTOR _apriori_argv;
   // -- the first element of the argument vector stores the name of
   //    the first parsing source; however, this element is not
   //    parsed for variable assignments or nominuses.
   //
   //    Regardless, we don't add more than one name to the argument
   //    vector. In this case, we're parsing from a stream, so we'll
   //    hardcode the "filename" to "ParsedFromStream"
   _apriori_argv.push_back(FileName);
 
   STRING_VECTOR args = _read_in_stream(FileStream);
   _apriori_argv.insert(_apriori_argv.begin()+1, args.begin(), args.end());
   _parse_argument_vector(_apriori_argv);
 }

int GETPOT_NAMESPACE::GetPot::print ( std::ostream & out_stream = std::cout ) const

inline

output

Print everything

在文件 getpot.h 第 2689 行定义.

参考 argv.

 {
   out_stream << "argc = " << argv.size() << std::endl;
   STRING_VECTOR::const_iterator it = argv.begin();
   for (; it != argv.end(); ++it)
     out_stream << *it << std::endl;
   out_stream << std::endl;
   return 1;
 }

int GETPOT_NAMESPACE::GetPot::print	(	const char *	custom_prefix,
		std::ostream &	out_stream = `std::cout`,
		unsigned int	skip_count = `1`
	)		const

inline

Print everything after skipping skip_count arguments, with a custom prefix.

skip_count defaults to 1 to handle the common "executable input_file" command line case.

在文件 getpot.h 第 2707 行定义.

参考 argv.

 {
   STRING_VECTOR::const_iterator it = argv.begin();
   it += skip_count;
   for (; it != argv.end(); ++it)
     {
       out_stream << custom_prefix;
       out_stream << *it << std::endl;
     }
   out_stream << std::endl;
   return 1;
 }

void GETPOT_NAMESPACE::GetPot::reset_cursor ( )

inline

reset cursor to position '1'

在文件 getpot.h 第 1855 行定义.

参考 cursor , 以及 search_failed_f.

参考自 init_multiple_occurrence().

 {
   search_failed_f = false;
   cursor = 0;
 }

void GETPOT_NAMESPACE::GetPot::reset_nominus_cursor ( )

inline

nominus arguments

在文件 getpot.h 第 2227 行定义.

参考 nominus_cursor.

 {
   nominus_cursor = -1;
 }

bool GETPOT_NAMESPACE::GetPot::search ( const char * option )

inline

search for a certain option and set cursor to position

在文件 getpot.h 第 1766 行定义.

参考 _record_argument_request(), argv, cursor, prefix, search_failed_f , 以及 search_loop_f.

参考自 follow() , 以及 search().

 {
   unsigned           OldCursor = cursor;
   const std::string  SearchTerm = prefix + Option;
 
   // (*) record requested arguments for later ufo detection
   _record_argument_request(SearchTerm);
 
   if (OldCursor >= argv.size())
     OldCursor = getpot_cast_int<unsigned>(argv.size() - 1);
   search_failed_f = true;
 
   // (*) first loop from cursor position until end
   for (unsigned c = cursor; c < argv.size(); c++)
     {
       if (argv[c] == SearchTerm)
         {
           cursor = c;
           search_failed_f = false;
           return true;
         }
     }
   if (!search_loop_f)
     return false;
 
   // (*) second loop from 0 to old cursor position
   for (unsigned c = 1; c <= OldCursor; c++)
     {
       if (argv[c] == SearchTerm)
         {
           cursor = c;
           search_failed_f = false;
           return true;
         }
     }
 
   // in case nothing is found the cursor stays where it was
   return false;
 }

bool GETPOT_NAMESPACE::GetPot::search ( const std::string & option )

inline

在文件 getpot.h 第 1757 行定义.

参考 search().

 {
   return search(Option.c_str());
 }

bool GETPOT_NAMESPACE::GetPot::search	(	unsigned	No,
		const char *	P,
			...
	)

inline

在文件 getpot.h 第 1809 行定义.

参考 _record_argument_request() , 以及 search().

 {
   // (*) recording the requested arguments happens in subroutine 'search'
   if (No == 0)
     return false;
 
   // search for the first argument
   if (search(P) == true)
     return true;
 
   // start interpreting variable argument list
   va_list ap;
   va_start(ap, P);
   unsigned i = 1;
   for (; i < No; i++)
     {
       char* Opt = va_arg(ap, char *);
       // (*) search records itself for later ufo detection
       if (search(Opt) == true)
         break;
     }
 
   if (i < No)
     {
       i++;
       // loop was left before end of array --> hit but
       // make sure that the rest of the search terms is marked
       // as requested.
       for (; i < No; i++)
         {
           char* Opt = va_arg(ap, char *);
           // (*) record requested arguments for later ufo detection
           _record_argument_request(Opt);
         }
       va_end(ap);
       return true;
     }
 
   va_end(ap);
   // loop was left normally --> no hit
   return false;
 }

bool GETPOT_NAMESPACE::GetPot::search_failed ( ) const

inline

在文件 getpot.h 第 356 行定义.

参考 search_failed_f.

356 { return search_failed_f; }

GETPOT_NAMESPACE::GetPot::search_failed_f

bool search_failed_f

Definition: getpot.h:519

template<typename T >

void GETPOT_NAMESPACE::GetPot::set	(	const char *	VarName,
		const T &	Value,
		const bool	Requested = `true`
	)

inline

setting variables i) from outside of GetPot (considering prefix etc.) ii) from inside, use '_set_variable()' below

在文件 getpot.h 第 2522 行定义.

参考 _set_variable().

参考自 set().

 {
   std::ostringstream string_value;
   string_value << Value;
   _set_variable(VarName, string_value.str().c_str(), Requested);
 }

template<typename T >

void GETPOT_NAMESPACE::GetPot::set	(	const std::string &	VarName,
		const T &	Value,
		const bool	Requested = `true`
	)

inline

在文件 getpot.h 第 2533 行定义.

参考 set().

 {
   set(VarName.c_str(), Value, Requested);
 }

void GETPOT_NAMESPACE::GetPot::set	(	const char *	VarName,
		const char *	Value,
		const bool	Requested = `true`
	)

inline

在文件 getpot.h 第 2541 行定义.

参考 _set_variable().

 {
   _set_variable(VarName, Value, Requested);
 }

void GETPOT_NAMESPACE::GetPot::set	(	const std::string &	VarName,
		const char *	Value,
		const bool	Requested = `true`
	)

inline

在文件 getpot.h 第 2549 行定义.

参考 set().

 {
   set(VarName.c_str(), Value, Requested);
 }

void GETPOT_NAMESPACE::GetPot::set_prefix ( const char * Prefix )

inline

cursor oriented functions

在文件 getpot.h 第 355 行定义.

参考 prefix.

355 { prefix = std::string(Prefix); }

GETPOT_NAMESPACE::GetPot::prefix

std::string prefix

member variables

Definition: getpot.h:509

unsigned GETPOT_NAMESPACE::GetPot::size ( ) const

inline

在文件 getpot.h 第 1906 行定义.

参考 argv.

参考自 _DBE_expand().

 {
   return getpot_cast_int<unsigned>(argv.size());
 }

STRING_VECTOR GETPOT_NAMESPACE::GetPot::unidentified_arguments	(	unsigned	Number,
		const char *	Known,
			...
	)		const

inline

unidentified flying objects

在文件 getpot.h 第 3447 行定义.

参考 unidentified_arguments().

 {
   std::set<std::string> known_arguments;
 
   // (1) create a vector of known arguments
   if (Number == 0)
     return STRING_VECTOR();
 
   va_list ap;
   va_start(ap, KnownArgument1);
   known_arguments.insert(std::string(KnownArgument1));
   for (unsigned i=1; i<Number; i++)
     known_arguments.insert(std::string(va_arg(ap, char *)));
   va_end(ap);
 
   return unidentified_arguments(known_arguments);
 }

STRING_VECTOR GETPOT_NAMESPACE::GetPot::unidentified_arguments ( const std::set< std::string > & Knowns ) const

inline

在文件 getpot.h 第 3487 行定义.

参考 _get_remaining_string(), argv , 以及 prefix.

 {
   STRING_VECTOR ufos;
   STRING_VECTOR::const_iterator it = argv.begin();
   ++it; // forget about argv[0] (application or filename)
   for (; it != argv.end(); ++it)
     {
       // -- argument belongs to prefixed section ?
       const std::string arg = _get_remaining_string(*it, prefix);
       if (arg == "")
         continue;
 
       // -- check if in list
       if (Knowns.find(arg) == Knowns.end())
         ufos.push_back(*it);
     }
   return ufos;
 }

STRING_VECTOR GETPOT_NAMESPACE::GetPot::unidentified_arguments ( const std::vector< std::string > & Knowns ) const

inline

在文件 getpot.h 第 3477 行定义.

参考 unidentified_arguments().

 {
   // We use set for efficiency, but want to support vector inputs for
   // backwards compatibility.
   return unidentified_arguments(std::set<std::string> (Knowns.begin(), Knowns.end()));
 }

STRING_VECTOR GETPOT_NAMESPACE::GetPot::unidentified_arguments ( ) const

inline

在文件 getpot.h 第 3469 行定义.

参考 _requested_arguments.

参考自 unidentified_arguments() , 以及 unidentified_options().

 {
   return unidentified_arguments(_requested_arguments);
 }

std::string GETPOT_NAMESPACE::GetPot::unidentified_flags	(	const char *	Known,
		int	ArgumentNumber = `-1`
	)		const

inline

在文件 getpot.h 第 3585 行定义.

参考 _get_remaining_string(), argv , 以及 prefix.

 {
   std::string         ufos;
   // STRING_VECTOR known_arguments;
   std::string         KFL(KnownFlagList);
 
   // (2) iteration over '-' arguments (options)
   if (ArgumentNumber == -1)
     {
       STRING_VECTOR::const_iterator it = argv.begin();
       ++it; // forget about argv[0] (application or filename)
       for (; it != argv.end(); ++it)
         {
           // -- argument belongs to prefixed section ?
           const std::string arg = _get_remaining_string(*it, prefix);
           if (arg == "") continue;
 
           // -- does arguments start with '-' (but not '--')
           if (arg.length() < 2)
             continue;
 
           else if (arg[0] != '-')
             continue;
 
           else if (arg[1] == '-')
             continue;
 
           // -- check out if flags inside option are contained in KnownFlagList
           const char* p=arg.c_str();
           p++; // skip starting minus
           for (; *p != '\0' ; p++)
             if (KFL.find(*p) == std::string::npos) ufos += *p;
         }
     }
   // (1) check specific argument
   else
     {
       // -- only check arguments that start with prefix
       int no_matches = 0;
       for (unsigned i=1; i<argv.size(); i++)
         {
           const std::string Remain = _get_remaining_string(argv[i], prefix);
           if (Remain != "")
             {
               no_matches++;
               if (no_matches == ArgumentNumber)
                 {
                   // -- the right argument number inside the section is found
                   // => check it for flags
                   const char* p = Remain.c_str();
                   p++; // skip starting minus
                   for (; *p != '\0' ; p++)
                     if (KFL.find(*p) == std::string::npos) ufos += *p;
                   return ufos;
                 }
             }
         }
     }
   return ufos;
 }

STRING_VECTOR GETPOT_NAMESPACE::GetPot::unidentified_nominuses	(	unsigned	Number,
		const char *	Known,
			...
	)		const

inline

在文件 getpot.h 第 3782 行定义.

参考 unidentified_nominuses().

 {
   std::set<std::string> known_nominuses;
 
   // create vector of known arguments
   if (Number == 0)
     return STRING_VECTOR();
 
   va_list ap;
   va_start(ap, Known);
   known_nominuses.insert(std::string(Known));
   for (unsigned i=1; i<Number; i++)
     {
       std::string tmp = std::string(va_arg(ap, char *));
       if (tmp.length() == 0)
         continue;
       known_nominuses.insert(tmp);
     }
   va_end(ap);
 
   return unidentified_nominuses(known_nominuses);
 }

STRING_VECTOR GETPOT_NAMESPACE::GetPot::unidentified_nominuses ( const std::set< std::string > & Knowns ) const

inline

在文件 getpot.h 第 3833 行定义.

参考 _get_remaining_string(), argv , 以及 prefix.

 {
   STRING_VECTOR ufos;
 
   // (2) iterate over all arguments
   STRING_VECTOR::const_iterator it = argv.begin();
   ++it; // forget about argv[0] (application or filename)
   for (; it != argv.end(); ++it)
     {
       // -- check if nominus part of prefix
       const std::string arg = _get_remaining_string(*it, prefix);
       if (arg == "")
         continue;
 
       if (arg.length() < 1)
         continue;
 
       // option ? --> not a nomius
       if (arg[0] == '-')
         continue;
 
       // section ? --> not a real nominus
       if (arg[0] == '[' && arg[arg.length()-1] == ']')
         continue;
 
       // variable definition ? --> not a real nominus
       bool continue_f = false;
       for (unsigned i=0; i<arg.length() ; i++)
         if (arg[i] == '=')
           {
             continue_f = true;
             break;
           }
 
       if (continue_f)
         continue;
 
       // real nominuses are compared with the given list
       if (Knowns.find(arg) == Knowns.end())
         ufos.push_back(*it);
     }
   return ufos;
 }

STRING_VECTOR GETPOT_NAMESPACE::GetPot::unidentified_nominuses ( const std::vector< std::string > & Knowns ) const

inline

在文件 getpot.h 第 3823 行定义.

参考 unidentified_nominuses().

 {
   // We use set for efficiency, but want to support vector inputs for
   // backwards compatibility.
   return unidentified_nominuses(std::set<std::string> (Knowns.begin(), Knowns.end()));
 }

STRING_VECTOR GETPOT_NAMESPACE::GetPot::unidentified_nominuses ( ) const

inline

在文件 getpot.h 第 3808 行定义.

参考 _requested_arguments.

参考自 unidentified_nominuses().

 {
   // -- every nominus is an argument.
   // -- the set of requested arguments contains the set of requested nominuss.
   // -- IF the set of requested arguments contains unrequested nominuss,
   //    THEN they were requested as 'follow' and 'next' arguments and not as real nominuses.
   //
   // => it is not necessary to separate requested nominus from the list
 
   return unidentified_nominuses(_requested_arguments);
 }

STRING_VECTOR GETPOT_NAMESPACE::GetPot::unidentified_options	(	unsigned	Number,
		const char *	Known,
			...
	)		const

inline

在文件 getpot.h 第 3509 行定义.

参考 unidentified_options().

 {
   std::set<std::string> known_options;
 
   // (1) create a vector of known arguments
   if (Number == 0)
     return STRING_VECTOR();
 
   va_list ap;
   va_start(ap, KnownOption1);
   known_options.insert(std::string(KnownOption1));
   for (unsigned i=1; i<Number; i++)
     known_options.insert(std::string(va_arg(ap, char *)));
   va_end(ap);
 
   return unidentified_options(known_options);
 }

STRING_VECTOR GETPOT_NAMESPACE::GetPot::unidentified_options ( const std::set< std::string > & Knowns ) const

inline

在文件 getpot.h 第 3555 行定义.

参考 _get_remaining_string(), argv , 以及 prefix.

 {
   STRING_VECTOR ufos;
   STRING_VECTOR::const_iterator it = argv.begin();
   ++it; // forget about argv[0] (application or filename)
   for (; it != argv.end(); ++it)
     {
       // -- argument belongs to prefixed section ?
       const std::string arg = _get_remaining_string(*it, prefix);
       if (arg == "")
         continue;
 
       // is argument really an option (starting with '-') ?
       if (arg.length() < 1 || arg[0] != '-')
         continue;
 
       if (Knowns.find(arg) == Knowns.end())
         ufos.push_back(*it);
     }
 
   return ufos;
 }

STRING_VECTOR GETPOT_NAMESPACE::GetPot::unidentified_options ( const std::vector< std::string > & Knowns ) const

inline

在文件 getpot.h 第 3545 行定义.

参考 unidentified_options().

 {
   // We use set for efficiency, but want to support vector inputs for
   // backwards compatibility.
   return unidentified_options(std::set<std::string> (Knowns.begin(), Knowns.end()));
 }

STRING_VECTOR GETPOT_NAMESPACE::GetPot::unidentified_options ( ) const

inline

在文件 getpot.h 第 3531 行定义.

参考 _requested_arguments , 以及 unidentified_arguments().

参考自 unidentified_options().

 {
   // -- every option is an argument.
   // -- the set of requested arguments contains the set of requested options.
   // -- IF the set of requested arguments contains unrequested options,
   //    THEN they were requested as 'follow' and 'next' arguments and not as real options.
   //
   // => it is not necessary to separate requested options from the list
   return unidentified_arguments(_requested_arguments);
 }

STRING_VECTOR GETPOT_NAMESPACE::GetPot::unidentified_sections	(	unsigned	Number,
		const char *	Known,
			...
	)		const

inline

在文件 getpot.h 第 3710 行定义.

参考 unidentified_sections().

 {
   std::set<std::string> known_sections;
 
   // (1) create a vector of known arguments
   if (Number == 0)
     return STRING_VECTOR();
 
   va_list ap;
   va_start(ap, KnownSection1);
   known_sections.insert(std::string(KnownSection1));
   for (unsigned i=1; i<Number; i++)
     {
       std::string tmp = std::string(va_arg(ap, char *));
 
       if (tmp.length() == 0)
         continue;
 
       if (tmp[tmp.length()-1] != '/')
         tmp += '/';
 
       known_sections.insert(tmp);
     }
   va_end(ap);
 
   return unidentified_sections(known_sections);
 }

STRING_VECTOR GETPOT_NAMESPACE::GetPot::unidentified_sections ( const std::set< std::string > & Knowns ) const

inline

在文件 getpot.h 第 3760 行定义.

参考 _get_remaining_string(), prefix , 以及 section_list.

 {
   STRING_VECTOR ufos;
 
   victorate(std::string, section_list, it)
     {
       // -- check if section conform to prefix
       const std::string sec_name = _get_remaining_string(*it, prefix);
       if (sec_name == "")
         continue;
 
       // -- check if section is known
       if (Knowns.find(sec_name) == Knowns.end())
         ufos.push_back(*it);
     }
 
   return ufos;
 }

STRING_VECTOR GETPOT_NAMESPACE::GetPot::unidentified_sections ( const std::vector< std::string > & Knowns ) const

inline

在文件 getpot.h 第 3750 行定义.

参考 unidentified_sections().

 {
   // We use set for efficiency, but want to support vector inputs for
   // backwards compatibility.
   return unidentified_sections(std::set<std::string> (Knowns.begin(), Knowns.end()));
 }

STRING_VECTOR GETPOT_NAMESPACE::GetPot::unidentified_sections ( ) const

inline

在文件 getpot.h 第 3742 行定义.

参考 _requested_sections.

参考自 unidentified_sections().

 {
   return unidentified_sections(_requested_sections);
 }

STRING_VECTOR GETPOT_NAMESPACE::GetPot::unidentified_variables	(	unsigned	Number,
		const char *	Known,
			...
	)		const

inline

在文件 getpot.h 第 3649 行定义.

参考 unidentified_variables().

 {
   std::set<std::string> known_variables;
 
   // create vector of known arguments
   if (Number == 0)
     return STRING_VECTOR();
 
   va_list ap;
   va_start(ap, KnownVariable1);
   known_variables.insert(std::string(KnownVariable1));
   for (unsigned i=1; i<Number; i++)
     known_variables.insert(std::string(va_arg(ap, char *)));
   va_end(ap);
 
   return unidentified_variables(known_variables);
 }

STRING_VECTOR GETPOT_NAMESPACE::GetPot::unidentified_variables ( const std::set< std::string > & Knowns ) const

inline

在文件 getpot.h 第 3681 行定义.

参考 _get_remaining_string(), prefix , 以及 variables.

 {
   STRING_VECTOR ufos;
 
   victorate(GetPot::variable, variables, it)
     {
       // -- check if variable has specific prefix
       const std::string var_name = _get_remaining_string((*it).name, prefix);
       if (var_name == "")
         continue;
 
       // -- check if variable is known
       if (Knowns.find(var_name) == Knowns.end())
         ufos.push_back((*it).name);
     }
   return ufos;
 }

STRING_VECTOR GETPOT_NAMESPACE::GetPot::unidentified_variables ( const std::vector< std::string > & Knowns ) const

inline

在文件 getpot.h 第 3671 行定义.

参考 unidentified_variables().

 {
   // We use set for efficiency, but want to support vector inputs for
   // backwards compatibility.
   return unidentified_variables(std::set<std::string> (Knowns.begin(), Knowns.end()));
 }

STRING_VECTOR GETPOT_NAMESPACE::GetPot::unidentified_variables ( ) const

inline

在文件 getpot.h 第 3702 行定义.

参考 _requested_variables.

参考自 unidentified_variables().

 {
   return unidentified_variables(_requested_variables);
 }

unsigned GETPOT_NAMESPACE::GetPot::vector_variable_size ( const char * VarName ) const

inline

在文件 getpot.h 第 2557 行定义.

参考 _request_variable() , 以及 GETPOT_NAMESPACE::GetPot::variable::value.

参考自 vector_variable_size().

 {
   const variable*  sv = _request_variable(VarName);
   if (sv == 0)
     return 0;
   return (unsigned)(sv->value.size());
 }

unsigned GETPOT_NAMESPACE::GetPot::vector_variable_size ( const std::string & VarName ) const

inline

在文件 getpot.h 第 2568 行定义.

参考 vector_variable_size().

 {
   return vector_variable_size(VarName.c_str());
 }

类成员变量说明

std::string GETPOT_NAMESPACE::GetPot::_comment_end

private

在文件 getpot.h 第 537 行定义.

参考自 _basic_initialization(), _parse_argument_vector(), _skip_whitespace(), operator=() , 以及 parse_input_stream().

std::string GETPOT_NAMESPACE::GetPot::_comment_start

private

comment delimiters

在文件 getpot.h 第 536 行定义.

参考自 _basic_initialization(), _parse_argument_vector(), _read_in_stream(), _skip_whitespace(), operator=() , 以及 parse_input_stream().

std::string GETPOT_NAMESPACE::GetPot::_field_separator

private

field separator (separating elements of a vector)

在文件 getpot.h 第 542 行定义.

参考自 _basic_initialization(), _parse_argument_vector(), _set_variable(), operator=(), parse_command_line() , 以及 parse_input_stream().

std::set<const char*, ltstr> GETPOT_NAMESPACE::GetPot::_internal_string_container

mutableprivate

some functions return a char pointer to a string created on the fly.

this container makes them 'available' until the getpot object is destroyed. user codes are recommended to instead request std::string values. We use char* here because c_str() results are only guaranteed to remain valid until a non-const string method is called

在文件 getpot.h 第 568 行定义.

参考自 _internal_managed_copy(), GetPot(), operator=() , 以及 ~GetPot().

std::set<std::string> GETPOT_NAMESPACE::GetPot::_requested_arguments

mutableprivate

keeping track about arguments that are requested, so that the UFO detection can be simplified

在文件 getpot.h 第 580 行定义.

参考自 _parse_argument_vector(), _record_argument_request(), absorb(), clear_requests(), get_requested_arguments(), operator=(), unidentified_arguments(), unidentified_nominuses() , 以及 unidentified_options().

std::set<std::string> GETPOT_NAMESPACE::GetPot::_requested_sections

mutableprivate

在文件 getpot.h 第 582 行定义.

参考自 _record_argument_request(), _record_variable_request(), absorb(), clear_requests(), get_requested_sections(), operator=() , 以及 unidentified_sections().

std::set<std::string> GETPOT_NAMESPACE::GetPot::_requested_variables

mutableprivate

在文件 getpot.h 第 581 行定义.

参考自 _record_variable_request(), absorb(), clear_requests(), get_requested_variables(), operator=() , 以及 unidentified_variables().

STRING_VECTOR GETPOT_NAMESPACE::GetPot::argv

private

argument vector

在文件 getpot.h 第 516 行定义.

参考自 _match_starting_string(), _parse_argument_vector(), absorb(), argument_contains(), direct_follow(), get(), next(), next_nominus(), next_nominus_string(), nominus_vector(), operator=(), operator[](), options_contain(), print(), search(), size(), unidentified_arguments(), unidentified_flags(), unidentified_nominuses() , 以及 unidentified_options().

unsigned GETPOT_NAMESPACE::GetPot::cursor

private

在文件 getpot.h 第 517 行定义.

参考自 _basic_initialization(), _match_starting_string(), direct_follow(), next(), operator=(), reset_cursor() , 以及 search().

GETPOT_NAMESPACE::GetPot::GETPOT_MUTEX_DECLARE

private

we have some mutable non-thread-safe members, but we want to be able to call const member functions from multiple threads at once, so we'll wrap access to mutable objects in a mutex.

在文件 getpot.h 第 558 行定义.

std::vector<unsigned> GETPOT_NAMESPACE::GetPot::idx_nominus

private

在文件 getpot.h 第 526 行定义.

参考自 _parse_argument_vector(), next_nominus(), next_nominus_string(), nominus_size(), nominus_vector() , 以及 operator=().