c++ - 通过\see 命令引用转换运算符

Question

我在从源代码的另一点引用转换运算符时遇到麻烦，这是一个最小的示例:

#include <string>

/*!
  Dummy struct
 */
struct A
{
    /*!
      Dummy operator.
     */
    void operator()() const {}

    /*!
      Dummy conversion operator.

      \return Nothing, really.
     */
    operator std::string() const { return std::string(); }
};

/*!
  Dummy function.

  \see A::operator()()
  \see A::operator std::string()
 */
void b()
{
    // Here I use A::operator() and A::operator std::string
    // so it would be nice to reference them in the docs.
}

b() 函数中的第一个 \see 命令起作用，结果是指向 A 的链接HTML 输出中的运算符，但第二个运算符没有。

如何引用转换运算符？

Answer 1

这似乎有效，使用“无用”的 typedef 以便 doxygen 将 string 识别为 A::string

/*!
  Dummy struct
 */
struct A
{
    typedef std::string string;

    /*!
      Dummy conversion operator.

      \return Nothing, really.
     */
    operator string() const { return std::string(); }
};

/*!
  Dummy function.

  \see A::operator string()
 */
void b();