Question

我有一个带有模板函数的类。该函数是专用/实例化的，因此可以在cpp中定义。 Doxygen给我关于模板实例化的错误。

例如，我的.h：

namespace LP
{
    namespace LF
    {
        class FileReader
        {
        public:
            template <class T> void Read( T *aValue );
            size_t Read( uint8_t *aBuffer, size_t aSizeToRead );
        };
    }
}

我的cpp：

/// Valid doxygen function doc
template<class T>
void
LP::LF::FileReader::Read( T *aValue )
{
    Read( reinterpret_cast<uint8_t *>( aValue ), sizeof( T ) );
}

//Template specialisation so it can be defined in the cpp file
template void LP::LF::FileReader::Read<uint8_t>( uint8_t * );
template void LP::LF::FileReader::Read<uint16_t>( uint16_t * );
template void LP::LF::FileReader::Read<uint32_t>( uint32_t * );

我在所有3行专业化测试中都遇到此错误：

warning: no uniquely matching class member found for 
  template void LP::LF::FileReader::Read< uint8_t >(uint8_t *)
Possible candidates:
  'template < T >
  void LP::LF::FileReader::Read(T *aValue)' at line 48 of file FileReader.h
  size_t LP::LF::FileReader::Read(uint8_t *aBuffer, size_t aSizeToRead)' at line 49 of file FileReader.h

如果我重命名了读取功能之一，它可以解决该错误，但是我不希望这样做。

不需要专门化文档，通用功能已经文档化

doxygen 1.8.13

谢谢

编辑：将标题从专业化更改为实例化

Answer 1

没有找到正确的语法，但是有一种解决方法：

/// \relates LP::LF::FileReader
template void LP::LF::FileReader::Read<uint8_t>( uint8_t * );

不确定为什么，但是它使警告静音

找不到模板实例的唯一匹配的班级成员

1 个答案: