Changeset 9883 in orxonox.OLD for trunk/src/lib/parser/ini_parser/ini_parser.cc

Timestamp:

Oct 12, 2006, 9:21:29 AM (18 years ago)

Author:

bensch

Message:

trunk: completely doxygened and finalized IniParser

File:

• trunk/src/lib/parser/ini_parser/ini_parser.cc (modified) (4 diffs)

trunk/src/lib/parser/ini_parser/ini_parser.cc

@@ -16 +16 @@
                now the File is parsed at the initialisation,
                and informations is gathered there.
+   2006-10-10: Complete reimplementation again :)
+               New STL-like style. The Parser has no state itself
+               Elements as Nodes
 */
 
@@ -264 +267 @@
  * @return True on success (section was found).
  */
-bool IniParser::Document::setSectionComment(const std::string& sectionName, const std::string& comment)
+bool IniParser::Document::setSectionsComment(const std::string& sectionName, const std::string& comment)
 {
   Section::iterator section = std::find(this->_sections.begin(), this->_sections.end(), sectionName);
@@ -276 +279 @@
 }
 
-
+/**
+ * @brief Retrieves the comment for a specified section
+ * @param sectionName The name of the section
+ * @returns The Comment of the section.
+ */
+const std::string& IniParser::Document::getSectionsComment(const std::string& sectionName) const
+{
+  Section::const_iterator section = std::find(this->_sections.begin(), this->_sections.end(), sectionName);
+  if (section != this->_sections.end())
+  {
+    return (*section).comment();
+  }
+  else
+    return IniParser::_emptyString;
+}
 
 /**
@@ -607 +624 @@
 }
 
-void IniParser::setFileComment(const std::string& fileComment)
-{
-  this->_document.setComment(fileComment);
-}
-
-/**
- * @brief adds a section to the list of Sections,
- * if no Section list is availiable, it will create it
- * @param sectionName the Name of the section to add
- * @return true on success... there is only success or segfault :)
- */
-IniParser::Section& IniParser::addSection(const std::string& sectionName)
-{
-  return this->_document.addSection(sectionName);
-}
-
-
-/**
- * @brief adds a new Entry to either the currentSection or the section called by sectionName
- * @param entryName the Name of the Entry to add
- * @param value the value to assign to this entry
- * @param sectionName if NULL then this entry will be set to the currentSection
- * otherwise to the section refered to by sectionName.
- * If both are NULL no entry will be added
- * @return The Entry, that was added.
- */
-bool IniParser::addEntry(const std::string& sectionName, const std::string& entryName, const std::string& value, const std::string& comment)
-{
-  return this->_document.addEntry(sectionName, entryName, value, comment);
-}
-
-/**
- * @brief edits the entry speciefied by entryName in sectionName/currentSection or creates it if it doesn't exist
- * @param entryName the Name of the Entry to add
- * @param value the value to assign to this entry
- * @param sectionName if NULL then this entry will be set to the currentSection
- * otherwise to the section refered to by sectionName.
- * If both are NULL no entry will be added
- * @return true if everything is ok false on error
- */
-bool IniParser::editEntry(const std::string& sectionName, const std::string& entryName, const std::string& value, bool createMissing)
-{
-  return this->_document.editEntry(sectionName, entryName, value, createMissing);
-}
-
-
-/**
- * @brief directly acesses an entry in a section
- * @param sectionName: the section where the entry is to be found
- * @param entryName: the name of the entry to find
- * @param defaultValue: what should be returned in case the entry cannot be found
- * @return The Value of the Entry.
- */
-const std::string& IniParser::getValue(const std::string& sectionName, const std::string& entryName, const std::string& defaultValue) const
-{
-  return this->_document.getValue(sectionName, entryName, defaultValue);
-}
-
-/**
- * Set the Comment of a specified Entry.
- * @param comment the Comment to set
- * @param entryName the Name of the Entry
- * @param sectionName the Name of the Section
- */
-void IniParser::setEntryComment(const std::string& sectionName, const std::string& entryName, const std::string& comment)
-{
-  this->_document.setEntryComment(sectionName, entryName, comment);
-}
-
-/**
- * @param entryName the Entry to query for
- * @param sectionName the Section to Query for
- * @returns the queried Comment.
- */
-const std::string& IniParser::getEntryComment(const std::string& sectionName, const std::string& entryName) const
-{
-  return this->_document.getEntryComment(sectionName, entryName);
-}
 
 /**