ignore embedded doccomment inside initializer list

Author: SatyaRanjanDas-tomtom

cppparser/src/parser.y

@@ -251,7 +251,7 @@ using namespace cppast;
 %type  <str>                optapidecor apidecor apidecortokensq
 %type  <str>                identifier optidentifier numbertype typeidentifier varidentifier optname id name operfuncname funcname
 %type  <str>                templidentifier templqualifiedid
-%type  <str>                doccommentstr
+%type  <str>                doccommentstr optdoccommentstr
 %type  <str>                rshift
 %type  <str>                macrocall
 %type  <cppEntity>          stmt
@@ -675,6 +675,11 @@ doccomment
   : doccommentstr                               [ZZLOG;]  { $$ = new cppast::CppDocumentationComment((std::string) $1); }
   ;
 
+optdoccommentstr
+  :               [ZZLOG;] { $$ = CppToken{nullptr, 0}; }
+  | doccommentstr [ZZLOG;] { $$ = $1; }
+  ;
+
 doccommentstr
   : tknFreeStandingBlockComment                          [ZZLOG;]  { $$ = $1; }
   | tknFreeStandingLineComment                           [ZZLOG;]  { $$ = $1; }
@@ -2068,8 +2073,9 @@ exprlist
      $$ = new std::vector<std::unique_ptr<const cppast::CppExpression>>;
      $$->emplace_back($1);
   }
-  | exprlist ',' expr %prec COMMA                         [ZZLOG;] { $1->emplace_back($3); $$ = $1; }
-  | doccommentstr exprlist                                [ZZLOG;] { $$ = $2; }
+  | exprlist optdoccommentstr ',' optdoccommentstr expr %prec COMMA [ZZLOG;] { $1->emplace_back($5); $$ = $1; }
+  | doccommentstr exprlist [ZZLOG;] { $$ = $2; }
+  | exprlist doccommentstr [ZZLOG;] { $$ = $1; }
   ;
 
 optexprlist

cppparser/test/CMakeLists.txt

@@ -37,6 +37,7 @@ set(TEST_SNIPPET_EMBEDDED_TESTS
 	${CMAKE_CURRENT_LIST_DIR}/unit/disabled-code-test.cpp
 	${CMAKE_CURRENT_LIST_DIR}/unit/error-handler-test.cpp
 	${CMAKE_CURRENT_LIST_DIR}/unit/expr-test.cpp
+	${CMAKE_CURRENT_LIST_DIR}/unit/initializer-list-test.cpp
 	${CMAKE_CURRENT_LIST_DIR}/unit/namespace-test.cpp
 	${CMAKE_CURRENT_LIST_DIR}/unit/template-test.cpp
 	${CMAKE_CURRENT_LIST_DIR}/unit/uniform-init-test.cpp

cppparser/test/unit/initializer-list-test.cpp

@@ -0,0 +1,38 @@
+// Copyright (C) 2022 Satya Das and CppParser contributors
+// SPDX-License-Identifier: MIT
+
+#include <catch/catch.hpp>
+
+#include "cppparser/cppparser.h"
+
+#include "embedded-snippet-test-base.h"
+
+#include <string>
+
+class InitializerListTest : public EmbeddedSnippetTestBase
+{
+protected:
+  InitializerListTest()
+    : EmbeddedSnippetTestBase(__FILE__)
+  {
+  }
+};
+
+TEST_CASE_METHOD(InitializerListTest, "docstr in middle", "[initializerlist]")
+{
+#if TEST_CASE_SNIPPET_STARTS_FROM_NEXT_LINE
+  bool boolArray[] = {false,
+                      // IGNORABLE COMMENTS HERE
+                      false};
+#endif
+  auto testSnippet = getTestSnippetParseStream(__LINE__ - 2);
+
+  cppparser::CppParser parser;
+  const auto           ast = parser.parseStream(testSnippet.data(), testSnippet.size());
+  REQUIRE(ast != nullptr);
+
+  const auto members = GetAllOwnedEntities(*ast);
+  REQUIRE(members.size() == 1);
+  cppast::CppConstVarEPtr var = members[0];
+  REQUIRE(var);
+}