Doxygen
Loading...
Searching...
No Matches
ConfigString Class Referencefinal

Class representing a string type option. More...

#include <src/configimpl.h>

Inheritance diagram for ConfigString:
Collaboration diagram for ConfigString:

Public Types

enum  WidgetType {
  String , File , Dir , Image ,
  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

 ConfigString (const char *name, const char *doc)
void setWidgetType (WidgetType w)
WidgetType widgetType () const
void setDefaultValue (const char *v)
DStringvalueRef ()
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
void emptyValueToDefault () 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

DString m_value
DString m_defValue
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 string type option.

Definition at line 183 of file configimpl.h.

Member Enumeration Documentation

◆ WidgetType

Enumerator
String 
File 
Dir 
Image 
FileAndDir 

Definition at line 186 of file configimpl.h.

Constructor & Destructor Documentation

◆ ConfigString()

ConfigString::ConfigString ( const char * name,
const char * doc )
inline

Definition at line 187 of file configimpl.h.

189 {
190 m_name = name;
191 m_doc = doc;
193 }
ConfigOption(OptionType t)
Definition configimpl.h:60
DString name() const
Definition configimpl.h:67
DString m_name
Definition configimpl.h:92
@ O_String
A single item.
Definition configimpl.h:47
DString m_doc
Definition configimpl.h:93
WidgetType m_widgetType
Definition configimpl.h:210

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

Member Function Documentation

◆ compareDoxyfile()

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

Implements ConfigOption.

Definition at line 498 of file configimpl.l.

499{
500 if (!isDefault()) writeTemplate(t,true,true);
501}
bool isDefault() override
Definition configimpl.h:205
void writeTemplate(TextStream &t, bool sl, bool) override
Definition configimpl.l:481

References isDefault(), and writeTemplate().

◆ emptyValueToDefault()

void ConfigString::emptyValueToDefault ( )
inlineoverridevirtual

Reimplemented from ConfigOption.

Definition at line 204 of file configimpl.h.

DString m_value
Definition configimpl.h:208
DString m_defValue
Definition configimpl.h:209
bool empty() const
Returns true iff the string is empty (std::string compatible alias for isEmpty()).
Definition dstring.h:148

References DString::empty(), m_defValue, and m_value.

◆ init()

void ConfigString::init ( )
inlineoverridevirtual

Reimplemented from ConfigOption.

Definition at line 203 of file configimpl.h.

203{ m_value = m_defValue; }

References m_defValue, and m_value.

Referenced by Config::parse().

◆ isDefault()

bool ConfigString::isDefault ( )
inlineoverridevirtual

Reimplemented from ConfigOption.

Definition at line 205 of file configimpl.h.

DString stripWhiteSpace() const
returns a copy of this string with leading and trailing whitespace removed
Definition dstring.h:337

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

Referenced by compareDoxyfile(), and writeXMLDoxyfile().

◆ setDefaultValue()

void ConfigString::setDefaultValue ( const char * v)
inline

Definition at line 196 of file configimpl.h.

196{ m_defValue = v; }

References m_defValue.

◆ setWidgetType()

void ConfigString::setWidgetType ( WidgetType w)
inline

Definition at line 194 of file configimpl.h.

194{ m_widgetType = w; }

References m_widgetType.

◆ substEnvVars()

void ConfigString::substEnvVars ( )
overridevirtual

Implements ConfigOption.

Definition at line 1510 of file configimpl.l.

1511{
1513}
static void substEnvVarsInString(DString &s)

References m_value, and substEnvVarsInString().

◆ valueRef()

DString * ConfigString::valueRef ( )
inline

Definition at line 197 of file configimpl.h.

197{ return &m_value; }

References m_value.

Referenced by checkEncoding(), and DocPara::handleDoxyConfig().

◆ widgetType()

WidgetType ConfigString::widgetType ( ) const
inline

Definition at line 195 of file configimpl.h.

195{ return m_widgetType; }

References m_widgetType.

◆ writeTemplate()

void ConfigString::writeTemplate ( TextStream & t,
bool sl,
bool  )
overridevirtual

Implements ConfigOption.

Definition at line 481 of file configimpl.l.

482{
483 if (!sl)
484 {
485 t << "\n";
487 t << "\n";
488 }
489 else if (!m_userComment.empty())
490 {
492 }
495 t << "\n";
496}
DString m_spaces
Definition configimpl.h:91
DString m_userComment
Definition configimpl.h:96
void writeStringValue(TextStream &t, const DString &s, bool initSpace=true, bool wasQuoted=false)
Definition configimpl.l:135
DString left(size_t len) const
Definition dstring.h:306
size_t length() const
Returns the length of the string, not counting the 0-terminator.
Definition dstring.h:151
static DString convertToComment(const DString &s, const DString &u)
Definition configimpl.l:84

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::writeStringValue().

Referenced by compareDoxyfile().

◆ writeXMLDoxyfile()

void ConfigString::writeXMLDoxyfile ( TextStream & t)
overridevirtual

Implements ConfigOption.

Definition at line 503 of file configimpl.l.

504{
505 t << " <option id='" << m_name << "'";
506 t << " default='" << (isDefault() ? "yes" : "no") << "'";
507 t << " type='string'";
508 t << ">";
509 t << "<value>";
510 t << "<![CDATA[";
511 writeStringValue(t,m_value,false);
512 t << "]]>";
513 t << "</value>";
514 t << "</option>\n";
515}

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

◆ writeXSDDoxyfile()

void ConfigString::writeXSDDoxyfile ( TextStream & t)
overridevirtual

Implements ConfigOption.

Definition at line 517 of file configimpl.l.

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

References ConfigOption::m_name.

Member Data Documentation

◆ m_defValue

DString ConfigString::m_defValue
private

Definition at line 209 of file configimpl.h.

Referenced by emptyValueToDefault(), init(), isDefault(), and setDefaultValue().

◆ m_value

DString ConfigString::m_value
private

◆ m_widgetType

WidgetType ConfigString::m_widgetType
private

Definition at line 210 of file configimpl.h.

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


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