From: Marcin Siodelski <marcin@isc.org>
Date: Fri, 18 Apr 2014 09:04:50 +0000 (+0200)
Subject: [3408] Added a few comments in the data.cc concerning element position.
X-Git-Tag: trac2406_cl_base~1^2~3
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=6725cdd4ecc8ebd7b107f4812562411c5a211cb2;p=thirdparty%2Fkea.git

[3408] Added a few comments in the data.cc concerning element position.
---

diff --git a/src/lib/cc/data.cc b/src/lib/cc/data.cc
index d1573ca931..77e4c8157d 100644
--- a/src/lib/cc/data.cc
+++ b/src/lib/cc/data.cc
@@ -401,7 +401,10 @@ numberFromStringstream(std::istream& in, int& pos) {
 ElementPtr
 fromStringstreamNumber(std::istream& in, const std::string& file,
                        const int& line, int& pos) {
+    // Remember position where the value starts. It will be set in the
+    // Position structure of the Element to be created.
     const uint32_t start_pos = pos;
+    // This will move the pos to the end of the value.
     const std::string number = numberFromStringstream(in, pos);
 
     if (number.find_first_of(".eE") < number.size()) {
@@ -427,7 +430,10 @@ ElementPtr
 fromStringstreamBool(std::istream& in, const std::string& file,
                      const int line, int& pos)
 {
+    // Remember position where the value starts. It will be set in the
+    // Position structure of the Element to be created.
     const uint32_t start_pos = pos;
+    // This will move the pos to the end of the value.
     const std::string word = wordFromStringstream(in, pos);
 
     if (boost::iequals(word, "True")) {
@@ -445,7 +451,10 @@ ElementPtr
 fromStringstreamNull(std::istream& in, const std::string& file,
                      const int line, int& pos)
 {
+    // Remember position where the value starts. It will be set in the
+    // Position structure of the Element to be created.
     const uint32_t start_pos = pos;
+    // This will move the pos to the end of the value.
     const std::string word = wordFromStringstream(in, pos);
     if (boost::iequals(word, "null")) {
         return (Element::create(Element::Position(line, start_pos)));
@@ -460,7 +469,10 @@ ElementPtr
 fromStringstreamString(std::istream& in, const std::string& file, int& line,
                        int& pos)
 {
+    // Remember position where the value starts. It will be set in the
+    // Position structure of the Element to be created.
     const uint32_t start_pos = pos;
+    // This will move the pos to the end of the value.
     const std::string string_value = strFromStringstream(in, file, line, pos);
     return (Element::create(string_value, Element::Position(line, start_pos)));
 }