Files
geant4/source/intercoms/include/G4UIparameter.hh
T
2016-06-10 11:51:14 +02:00

184 lines
7.3 KiB
C++

//
// ********************************************************************
// * License and Disclaimer *
// * *
// * The Geant4 software is copyright of the Copyright Holders of *
// * the Geant4 Collaboration. It is provided under the terms and *
// * conditions of the Geant4 Software License, included in the file *
// * LICENSE and available at http://cern.ch/geant4/license . These *
// * include a list of copyright holders. *
// * *
// * Neither the authors of this software system, nor their employing *
// * institutes,nor the agencies providing financial support for this *
// * work make any representation or warranty, express or implied, *
// * regarding this software system or assume any liability for its *
// * use. Please see the license in the file LICENSE and URL above *
// * for the full disclaimer and the limitation of liability. *
// * *
// * This code implementation is the result of the scientific and *
// * technical work of the GEANT4 collaboration. *
// * By using, copying, modifying or distributing the software (or *
// * any work based on the software) you agree to acknowledge its *
// * use in resulting scientific publications, and indicate your *
// * acceptance of all terms of the Geant4 Software license. *
// ********************************************************************
//
//
// $Id: G4UIparameter.hh 67965 2013-03-13 09:35:29Z gcosmo $
//
//
// ---------------------------------------------------------------------
#ifndef G4UIparameter_h
#define G4UIparameter_h 1
#include "globals.hh"
#include "G4UItokenNum.hh"
// class description:
//
// This class represents a parameter which will be taken by a G4UIcommand
// object. In case a command is defined by constructing G4UIcmdXXX class,
// it automatically creates necessary parameter objects, thus the user needs
// not to create parameter object(s) by him/herself. In case the user wants
// to create a command directly instansiated by G4UIcommand class, he/she
// must create parameter object(s) by him/herself.
class G4UIparameter
{
public: // with description
G4UIparameter();
G4UIparameter(char theType);
G4UIparameter(const char * theName, char theType, G4bool theOmittable);
// Constructors, where "theName" is the name of the parameter which will
// be used by the range checking, "theType" is the type of the parameter
// (currently "b" (boolean), "i" (integer), "d" (double), and "s" (string)
// are supported), and "theOmittable" is a boolean flag to set whether
// the user of the command can ommit the parameter or not. If "theOmittable"
// is true, the default value must be given.
~G4UIparameter();
// Destructor. When a command is destructed, the delete operator(s) for
// associating parameter(s) are AUTOMATICALLY invoked. Thus the user needs
// NOT to invoke this by him/herself.
public:
G4int operator==(const G4UIparameter &right) const;
G4int operator!=(const G4UIparameter &right) const;
G4int CheckNewValue(const char* newValue);
void List();
private:
G4String parameterName;
G4String parameterGuidance;
G4String defaultValue;
G4String parameterRange;
G4String parameterCandidate;
char parameterType;
G4bool omittable;
G4bool currentAsDefaultFlag;
G4int widget;
public: // with description
inline void SetDefaultValue(const char * theDefaultValue)
{ defaultValue = theDefaultValue; }
void SetDefaultValue(G4int theDefaultValue);
void SetDefaultValue(G4double theDefaultValue);
// These methods set the default value of the parameter.
public:
inline G4String GetDefaultValue() const
{ return defaultValue; }
inline char GetParameterType() const
{ return parameterType; }
public: // with description
inline void SetParameterRange(const char * theRange)
{ parameterRange = theRange; }
// Defines the range the parameter can take.
// The variable name appear in the range expression must be same
// as the name of the parameter.
// All the C++ syntax of relational operators are allowed for the
// range expression.
public:
inline G4String GetParameterRange() const
{ return parameterRange; }
// parameterName
inline void SetParameterName(const char * theName)
{ parameterName = theName; }
inline G4String GetParameterName() const
{ return parameterName; }
public: // with description
inline void SetParameterCandidates(const char * theString)
{ parameterCandidate = theString; }
// This method is meaningful if the type of the parameter is string.
// The candidates listed in the argument must be separated by space(s).
public:
inline G4String GetParameterCandidates() const
{ return parameterCandidate; }
// omittable
inline void SetOmittable(G4bool om)
{ omittable = om; }
inline G4bool IsOmittable() const
{ return omittable; }
// currentAsDefaultFlag
inline void SetCurrentAsDefault(G4bool val)
{ currentAsDefaultFlag = val; }
inline G4bool GetCurrentAsDefault() const
{ return currentAsDefaultFlag; }
// out of date methods
inline void SetWidget(G4int theWidget)
{ widget = theWidget; }
inline const G4String GetParameterGuidance() const
{ return parameterGuidance; }
inline void SetGuidance(const char * theGuidance)
{ parameterGuidance = theGuidance; }
private:
// --- the following is used by CheckNewValue() -------
G4int TypeCheck(const char* newValue );
G4int RangeCheck(const char* newValue );
G4int CandidateCheck(const char* newValue );
G4int IsInt(const char* str, short maxDigit);
G4int IsDouble(const char* str);
G4int ExpectExponent(const char* str);
// syntax nodes
yystype Expression( void );
yystype LogicalORExpression( void );
yystype LogicalANDExpression( void );
yystype EqualityExpression ( void );
yystype RelationalExpression( void );
yystype AdditiveExpression( void );
yystype MultiplicativeExpression( void );
yystype UnaryExpression( void );
yystype PrimaryExpression( void );
// semantics routines
G4int Eval2( yystype arg1, G4int op, yystype arg2 );
G4int CompareInt( G4int arg1, G4int op, G4int arg2);
G4int CompareDouble( double arg1, G4int op, double arg2);
// utility
tokenNum Yylex( void ); // returns next token
G4int G4UIpGetc( void ); // read one char from rangeBuf
G4int G4UIpUngetc( G4int c ); // put back
G4int Backslash( G4int c );
G4int Follow( G4int expect, G4int ifyes, G4int ifno );
G4String TokenToStr(G4int token);
//void PrintToken(void); // debug
// data
G4String rangeBuf;
G4int bp; // buffer pointer for rangeBuf
tokenNum token;
yystype yylval;
yystype newVal;
G4int paramERR;
//------------ end of CheckNewValue() related member --------------
};
#endif