Abstract base class for any configuration option. More...

#include <src/configimpl.h>

Inheritance diagram for ConfigOption:

Collaboration diagram for ConfigOption:

Public Types
enum	OptionType { O_Info , O_List , O_Enum , O_String , O_Int , O_Bool , O_Obsolete , O_Disabled }
enum	{ MAX_OPTION_LENGTH = 23 }

Public Member Functions
	ConfigOption (OptionType t)
OptionType	kind () const
DString	name () const
DString	docs () const
DString	dependsOn () const
void	addDependency (const char *dep)
void	setEncoding (const DString &e)
void	setUserComment (const DString &u)

Protected Member Functions
virtual void	writeTemplate (TextStream &t, bool sl, bool upd)=0
virtual void	compareDoxyfile (TextStream &t, Config::CompareMode compareMode)=0
virtual void	writeXMLDoxyfile (TextStream &t)=0
virtual void	writeXSDDoxyfile (TextStream &t)=0
virtual void	convertStrToVal (Config::CompareMode)
virtual void	emptyValueToDefault ()
virtual void	substEnvVars ()=0
virtual void	init ()
virtual bool	isDefault ()
void	writeBoolValue (TextStream &t, bool v, bool initSpace=true)
void	writeIntValue (TextStream &t, int i, bool initSpace=true)
void	writeStringValue (TextStream &t, const DString &s, bool initSpace=true, bool wasQuoted=false)
void	writeStringList (TextStream &t, const StringVector &l)

Protected Attributes
DString	m_spaces
DString	m_name
DString	m_doc
DString	m_dependency
DString	m_encoding
DString	m_userComment
OptionType	m_kind

Friends
class	ConfigImpl

Detailed Description

Abstract base class for any configuration option.

Definition at line 38 of file configimpl.h.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

Enumerator
MAX_OPTION_LENGTH	Maximum length of an option in the config file. Used for alignment purposes.

Definition at line 57 of file configimpl.h.

    {
     /*! Maximum length of an option in the config file. Used for
      *  alignment purposes.
      */
      MAX_OPTION_LENGTH = 23
    };

◆ OptionType

enum ConfigOption::OptionType

The type of option

Enumerator
O_Info	A section header.
O_List	A list of items.
O_Enum	A fixed set of items.
O_String	A single item.
O_Int	An integer value.
O_Bool	A boolean value.
O_Obsolete	An obsolete option.
O_Disabled	Disabled compile time option.

Definition at line 46 of file configimpl.h.

    {
      O_Info,      //!< A section header
      O_List,      //!< A list of items
      O_Enum,      //!< A fixed set of items
      O_String,    //!< A single item
      O_Int,       //!< An integer value
      O_Bool,      //!< A boolean value
      O_Obsolete,  //!< An obsolete option
      O_Disabled   //!< Disabled compile time option
    };

Constructor & Destructor Documentation

◆ ConfigOption()

ConfigOption::ConfigOption ( OptionType t )

inline

Definition at line 64 of file configimpl.h.

                               : m_kind(t)
    {
      m_spaces.fill(' ',40);
    }

References DString::fill(), m_kind, and m_spaces.

Referenced by ConfigBool::ConfigBool(), ConfigDisabled::ConfigDisabled(), ConfigEnum::ConfigEnum(), ConfigImpl, ConfigInfo::ConfigInfo(), ConfigInt::ConfigInt(), ConfigList::ConfigList(), ConfigObsolete::ConfigObsolete(), and ConfigString::ConfigString().

Member Function Documentation

◆ addDependency()

void ConfigOption::addDependency ( const char * dep )

inline

Definition at line 75 of file configimpl.h.

75{ m_dependency = dep; }

ConfigOption::m_dependency

DString m_dependency

Definition configimpl.h:98

References m_dependency.

◆ compareDoxyfile()

virtual void ConfigOption::compareDoxyfile	(	TextStream &	t,
		Config::CompareMode	compareMode )

protectedpure virtual

Implemented in ConfigBool, ConfigDisabled, ConfigEnum, ConfigInfo, ConfigInt, ConfigList, ConfigObsolete, and ConfigString.

Referenced by ConfigImpl::compareDoxyfile().

◆ convertStrToVal()

virtual void ConfigOption::convertStrToVal ( Config::CompareMode )

inlineprotectedvirtual

Reimplemented in ConfigBool, ConfigEnum, and ConfigInt.

Definition at line 84 of file configimpl.h.

84{}

Referenced by ConfigImpl::convertStrToVal().

◆ dependsOn()

DString ConfigOption::dependsOn ( ) const

inline

Definition at line 74 of file configimpl.h.

74{ return m_dependency; }

References m_dependency.

Referenced by Config::checkAndCorrect(), and ConfigImpl::init().

◆ docs()

DString ConfigOption::docs ( ) const

inline

Definition at line 72 of file configimpl.h.

72{ return m_doc; }

ConfigOption::m_doc

DString m_doc

Definition configimpl.h:97

References m_doc.

◆ emptyValueToDefault()

virtual void ConfigOption::emptyValueToDefault ( )

inlineprotectedvirtual

Reimplemented in ConfigList, and ConfigString.

Definition at line 85 of file configimpl.h.

85{}

Referenced by ConfigImpl::emptyValueToDefault().

◆ init()

virtual void ConfigOption::init ( )

inlineprotectedvirtual

Reimplemented in ConfigBool, ConfigEnum, ConfigInt, ConfigList, and ConfigString.

Definition at line 87 of file configimpl.h.

87{}

Referenced by ConfigImpl::init().

◆ isDefault()

virtual bool ConfigOption::isDefault ( )

inlineprotectedvirtual

Reimplemented in ConfigBool, ConfigEnum, ConfigInt, ConfigList, and ConfigString.

Definition at line 88 of file configimpl.h.

88{ return true; }

◆ kind()

OptionType ConfigOption::kind ( ) const

inline

returns the kind of option this is.

Definition at line 70 of file configimpl.h.

70{ return m_kind; }

References m_kind.

Referenced by Config::checkAndCorrect(), getConfig(), DocPara::handleDoxyConfig(), and Config::updateObsolete().

◆ name()

DString ConfigOption::name ( ) const

inline

Definition at line 71 of file configimpl.h.

71{ return m_name; }

ConfigOption::m_name

DString m_name

Definition configimpl.h:96

References m_name.

Referenced by Config::checkAndCorrect(), ConfigBool::ConfigBool(), ConfigDisabled::ConfigDisabled(), ConfigEnum::ConfigEnum(), ConfigInfo::ConfigInfo(), ConfigInt::ConfigInt(), ConfigList::ConfigList(), ConfigObsolete::ConfigObsolete(), ConfigString::ConfigString(), and ConfigImpl::init().

◆ setEncoding()

void ConfigOption::setEncoding ( const DString & e )

inline

Definition at line 76 of file configimpl.h.

76{ m_encoding = e; }

ConfigOption::m_encoding

DString m_encoding

Definition configimpl.h:99

References m_encoding.

◆ setUserComment()

void ConfigOption::setUserComment ( const DString & u )

inline

Definition at line 77 of file configimpl.h.

77{ m_userComment += u; }

ConfigOption::m_userComment

DString m_userComment

Definition configimpl.h:100

References m_userComment.

◆ substEnvVars()

virtual void ConfigOption::substEnvVars ( )

protectedpure virtual

Implemented in ConfigBool, ConfigDisabled, ConfigEnum, ConfigInfo, ConfigInt, ConfigList, ConfigObsolete, and ConfigString.

Referenced by ConfigImpl::substituteEnvironmentVars().

◆ writeBoolValue()

void ConfigOption::writeBoolValue	(	TextStream &	t,
		bool	v,
		bool	initSpace = true )

protected

Definition at line 127 of file configimpl.l.

{
  if (initSpace) t << " ";
  if (v) t << "YES"; else t << "NO";
}

Referenced by ConfigBool::writeTemplate(), and ConfigBool::writeXMLDoxyfile().

◆ writeIntValue()

void ConfigOption::writeIntValue	(	TextStream &	t,
		int	i,
		bool	initSpace = true )

protected

Definition at line 133 of file configimpl.l.

{
  if (initSpace) t << " ";
  t << i;
}

Referenced by ConfigInt::writeTemplate(), and ConfigInt::writeXMLDoxyfile().

◆ writeStringList()

void ConfigOption::writeStringList	(	TextStream &	t,
		const StringVector &	l )

protected

Definition at line 171 of file configimpl.l.

{
  bool first=true;
  for (const auto &p : l)
  {
    if (!first) t << " \\\n";
    DString s = p;
    if (!first)
      t << "                        ";
    bool wasQuoted = ((s.at(0)=='"') && (s.at(s.length()-1)=='"'));
    if (wasQuoted)
    {
      s = s.mid(1,s.length()-2);
    }
    writeStringValue(t,s,true,wasQuoted);
    first=false;
  }
}

References DString::at(), DString::length(), DString::mid(), and writeStringValue().

Referenced by ConfigList::writeTemplate().

◆ writeStringValue()

void ConfigOption::writeStringValue	(	TextStream &	t,
		const DString &	s,
		bool	initSpace = true,
		bool	wasQuoted = false )

protected

Definition at line 139 of file configimpl.l.

{
  char c = 0;
  bool needsEscaping=wasQuoted;
  // convert the string back to it original g_encoding
  DString se = configStringRecode(s,"UTF-8",m_encoding);
  if (se.empty()) return;
  const char *p=se.data();
  if (p)
  {
    if (initSpace) t << " ";
    while ((c=*p++)!=0 && !needsEscaping)
      needsEscaping = (c==' ' || c== ',' || c=='\n' || c=='\t' || c=='"' || c=='#');
    if (needsEscaping)
    {
      t << "\"";
      p=se.data();
      while (*p)
      {
        if (*p==' ' && *(p+1)=='\0') break; // skip inserted space at the end
        if (*p=='"') t << "\\"; // escape quotes
        t << *p++;
      }
      t << "\"";
    }
    else
    {
      t << se;
    }
  }
}