ConfigList Class Reference

Class representing a list type option. More...

#include <src/configimpl.h>

Inheritance diagram for ConfigList:

Collaboration diagram for ConfigList:

Public Types
enum	WidgetType { String , File , Dir , FileAndDir }
Public Types inherited from ConfigOption
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
	ConfigList (const char *name, const char *doc)
void	addValue (const char *v)
void	setWidgetType (WidgetType w)
WidgetType	widgetType () const
StringVector *	valueRef ()
StringVector	getDefault ()
void	emptyValueToDefault () override
void	writeTemplate (TextStream &t, bool sl, bool) override
void	compareDoxyfile (TextStream &t, Config::CompareMode compareMode) override
void	writeXMLDoxyfile (TextStream &t) override
void	writeXSDDoxyfile (TextStream &t) override
void	substEnvVars () override
void	init () override
bool	isDefault () override
Public Member Functions inherited from ConfigOption
	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)

Private Attributes
StringVector	m_value
StringVector	m_defaultValue
WidgetType	m_widgetType

Additional Inherited Members
Protected Member Functions inherited from ConfigOption
virtual void	convertStrToVal (Config::CompareMode)
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 inherited from ConfigOption
DString	m_spaces
DString	m_name
DString	m_doc
DString	m_dependency
DString	m_encoding
DString	m_userComment
OptionType	m_kind

Detailed Description

Class representing a list type option.

Definition at line 120 of file configimpl.h.

Member Enumeration Documentation

WidgetType

enum ConfigList::WidgetType

Enumerator
String
File
Dir
FileAndDir

Definition at line 123 of file configimpl.h.

{ String, File, Dir, FileAndDir };

Constructor & Destructor Documentation

ConfigList()

ConfigList::ConfigList ( const char * name, const char * doc )

inline

Definition at line 124 of file configimpl.h.

      : ConfigOption(O_List)
    {
      m_name = name;
      m_doc = doc;
      m_widgetType = String;
    }

References ConfigOption::ConfigOption(), ConfigOption::m_doc, ConfigOption::m_name, m_widgetType, ConfigOption::name(), ConfigOption::O_List, and String.

Member Function Documentation

addValue()

void ConfigList::addValue ( const char * v )

inline

Definition at line 131 of file configimpl.h.

{ m_defaultValue.emplace_back(v); }

References m_defaultValue.

compareDoxyfile()

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

overridevirtual

Implements ConfigOption.

Definition at line 417 of file configimpl.l.

{
  if (!isDefault()) writeTemplate(t,true,true);
}

References isDefault(), and writeTemplate().

emptyValueToDefault()

void ConfigList::emptyValueToDefault ( )

inlineoverridevirtual

Reimplemented from ConfigOption.

Definition at line 136 of file configimpl.h.

{ if (m_value.empty() && !m_defaultValue.empty()) m_value=m_defaultValue; }

References m_defaultValue, and m_value.

getDefault()

StringVector ConfigList::getDefault ( )

inline

Definition at line 135 of file configimpl.h.

{ return m_defaultValue; }

References m_defaultValue.

init()

void ConfigList::init ( )

inlineoverridevirtual

Reimplemented from ConfigOption.

Definition at line 142 of file configimpl.h.

{ m_value = m_defaultValue; }

References m_defaultValue, and m_value.

isDefault()

bool ConfigList::isDefault ( )

overridevirtual

Reimplemented from ConfigOption.

Definition at line 385 of file configimpl.l.

{
  auto get_stripped = [](const std::string &s)             { return DString(s).stripWhiteSpace(); };
  auto is_not_empty = [get_stripped](const std::string &s) { return !get_stripped(s).empty();            };
  size_t defCnt = std::count_if(       m_value.begin(),       m_value.end(),is_not_empty);
  size_t valCnt = std::count_if(m_defaultValue.begin(),m_defaultValue.end(),is_not_empty);
  if ( valCnt != defCnt)
  {
    return false;
  }
  auto it1 = m_value.begin();
  auto it2 = m_defaultValue.begin();
  while (it1!=m_value.end() && it2!=m_defaultValue.end())
  {
    // skip over empty values
    while (it1!=m_value.end() && !is_not_empty(*it1))
    {
      ++it1;
    }
    if (it1!=m_value.end()) // non-empty value
    {
      if (get_stripped(*it1) != get_stripped(*it2)) // not the default, write as difference
      {
        return false;
      }
      ++it1;
      ++it2;
    }
  }
  return true;
}

References m_defaultValue, m_value, and DString::stripWhiteSpace().

Referenced by compareDoxyfile(), and writeXMLDoxyfile().

setWidgetType()

void ConfigList::setWidgetType ( WidgetType w )

inline

Definition at line 132 of file configimpl.h.

{ m_widgetType = w; }

References m_widgetType.

substEnvVars()

void ConfigList::substEnvVars ( )

overridevirtual

Implements ConfigOption.

Definition at line 1520 of file configimpl.l.

{
  substEnvVarsInStrList(m_value);
}

References m_value, and substEnvVarsInStrList().

valueRef()

StringVector * ConfigList::valueRef ( )

inline

Definition at line 134 of file configimpl.h.

{ return &m_value; }

References m_value.

widgetType()

WidgetType ConfigList::widgetType ( ) const

inline

Definition at line 133 of file configimpl.h.

{ return m_widgetType; }

References m_widgetType.

writeTemplate()

void ConfigList::writeTemplate ( TextStream & t, bool sl, bool  )

overridevirtual

Implements ConfigOption.

Definition at line 368 of file configimpl.l.

{
  if (!sl)
  {
    t << "\n";
    t << convertToComment(m_doc, m_userComment);
    t << "\n";
  }
  else if (!m_userComment.empty())
  {
    t << convertToComment("", m_userComment);
  }
  t << m_name << m_spaces.left(MAX_OPTION_LENGTH-m_name.length()) << "=";
  writeStringList(t,m_value);
  t << "\n";
}

References convertToComment(), DString::empty(), DString::left(), DString::length(), ConfigOption::m_doc, ConfigOption::m_name, ConfigOption::m_spaces, ConfigOption::m_userComment, m_value, ConfigOption::MAX_OPTION_LENGTH, and ConfigOption::writeStringList().

Referenced by compareDoxyfile().

writeXMLDoxyfile()

void ConfigList::writeXMLDoxyfile ( TextStream & t )

overridevirtual

Implements ConfigOption.

Definition at line 422 of file configimpl.l.

{
  t << "  <option  id='" << m_name << "'";
  t << " default='" << (isDefault() ? "yes" : "no") << "'";
  t << " type='stringlist'";
  t << ">";
  t << "\n";
  for (const auto &p : m_value)
  {
    DString s = p;
    t << "    <value>";
    t << "<![CDATA[";
    writeStringValue(t,s,false);
    t << "]]>";
    t << "</value>\n";
  }
  t << "  </option>\n";
}

References isDefault(), ConfigOption::m_name, m_value, and ConfigOption::writeStringValue().

writeXSDDoxyfile()

void ConfigList::writeXSDDoxyfile ( TextStream & t )

overridevirtual

Implements ConfigOption.

Definition at line 441 of file configimpl.l.

{
  t << "      <xsd:enumeration value=\"" << m_name << "\"/>\n";
}

References ConfigOption::m_name.

Member Data Documentation

m_defaultValue

StringVector ConfigList::m_defaultValue

private

Definition at line 146 of file configimpl.h.

Referenced by addValue(), emptyValueToDefault(), getDefault(), init(), and isDefault().

m_value

StringVector ConfigList::m_value

private

Definition at line 145 of file configimpl.h.

Referenced by emptyValueToDefault(), init(), isDefault(), substEnvVars(), valueRef(), writeTemplate(), and writeXMLDoxyfile().

m_widgetType

WidgetType ConfigList::m_widgetType

private

Definition at line 147 of file configimpl.h.

Referenced by ConfigList(), setWidgetType(), and widgetType().

---

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

• src/configimpl.h
• src/configimpl.l