Invalid definition for a C++ function taking an array reference as an argument

[vitaut]

I get the error

index.rst:1: WARNING: Invalid definition: expected identifier [error at 1]
  f(int (&array)[10])
  -^

on the following Sphinx code:

.. cpp:function:: f(int (&array)[10])

[lehmannro]

No, expected identifier is unrelated to fmtlib/fmt#125: This complaint is about the missing return type. void f(int &array[10]) works fine. The underlying issue with template declarations should be covered in #1314.

[vitaut]

I get an error even with return value on Sphinx 1.3b3:

index.rst:1: WARNING: Invalid definition: Expecting "," or ")" in parameters_and_qualifiers, got "(". [error at 11]
  void f(int (&array)[10])
  -----------^

[vitaut]

Please note that the declaration is void f(int (&array)[10]) and not void f(int &array[10]) as an array of references is not valid in C++.

[lehmannro]

Can you drop the surrounding braces around &array?

[vitaut]

Can you drop the surrounding braces around &array?

Unfortunately not, because it changes semantics.

[jakobandersen]

Yes, this is indeed a bug. Furthermore, the error is not accurate. In this case it should be
Invalid definition: Expecting "," or ")" in parameters_and_qualifiers, got "(". as you indicate.
I'm working on a fix.

[vitaut]

Thanks, @jakobandersen.