c++ - 内联函数在链接期间发生冲突？

我在头文件中定义了一个功能模板，并在多个源文件中使用了它。链接程序时，出现以下错误:

Linking ....................... ./Release_gcc_lin64_5534_ST/tom
/mxhome/charrison/git/sdcore/libs/CommUtils/Release_gcc_lin64_5534_ST/libCommUtils.so(Block.o): In function `wd_sprintf_r(boost::basic_format<char, std::char_traits<char>, std::allocator<char> > const&)':
/mxhome/charrison/git/sdcore/libs/CommUtils/include/wd_sprintf.h:29: multiple definition of `wd_sprintf_r(boost::basic_format<char, std::char_traits<char>, std::allocator<char> > const&)'
./Release_gcc_lin64_5534_ST/tom.o:/mxhome/charrison/git/sdcore/libs/CommUtils/include/wd_sprintf.h:29: first defined here
/mxhome/charrison/git/sdcore/libs/CommUtils/Release_gcc_lin64_5534_ST/libCommUtils.so(MemRef.o): In function `wd_sprintf_r(boost::basic_format<char, std::char_traits<char>, std::allocator<char> > const&)':
/mxhome/charrison/git/sdcore/libs/CommUtils/include/wd_sprintf.h:29: multiple definition of `wd_sprintf_r(boost::basic_format<char, std::char_traits<char>, std::allocator<char> > const&)'
./Release_gcc_lin64_5534_ST/tom.o:/mxhome/charrison/git/sdcore/libs/CommUtils/include/wd_sprintf.h:29: first defined here

我不明白发生了什么事。大概是内联函数，那么如何防止跨目标文件的多个实例发生冲突？

这是包含函数定义的头文件:

wd_sprintf.h:

#ifndef WDSPRINTF_H
#define WDSPRINTF_H

#include <string>
#include <sstream>
#include <boost/format.hpp>

// This is what the recursive template function wd_sprintf_r devolves
// to..
std::string
wd_sprintf_r(const boost::format &boost_format) {

    std::stringstream s;
    s << boost_format;
    return std::move(s.str()); // force move semantics
}

// wd_sprintf_r(format, args...):
//
// This unpacks the variadic arguments one at a time, recursively.  It
// binds the first arg to the pattern, and if there are remaining
// variadic arguments, it calls itself.  Otherwise it calls the above.
template <typename T, typename... Params>
std::string
wd_sprintf_r(boost::format &boost_format,
         const T &arg, const Params&... parameters) {

    return wd_sprintf_r(boost_format % arg, parameters...);
}

// wd_sprintf(pattern [,args...]):
//
// This creates a temporary boost::format from pattern, and calls
// wd_sprintf_r() to recursively extract and apply arguments.

#include <boost/exception/all.hpp>

class wd_sprintf_exception : public std::runtime_error {
public:
    wd_sprintf_exception(std::string const& msg) : std::runtime_error(msg) {};
};

template <typename... Params>
std::string
wd_sprintf (const std::string &pat, const Params&... parameters) {
    try {
        boost::format boost_format(pat);
        return wd_sprintf_r(boost_format, parameters...);
    }
    catch ( boost::io::format_error& e) {
        const std::string what = std::string("wd_sprintf: ") + std::string(e.what());
        throw wd_sprintf_exception(what);
    }
}

#endif

最佳答案

函数模板不是问题-它们的定义必须在使用它们的每个翻译单元中存在(除非有显式实例化)，并且编译器必须对其进行安排，以使链接程序满意。

但是，您还有一个非模板函数，它遵循正常规则。您必须将其定义(=主体)移至源文件并仅在 header 中保留声明，或者将其定义保留在 header 中并标记为inline。当标记为inline时，它必须再次出现在每个使用它的翻译单元中(但这恰恰是将要发生的事情)，并且所有内容都将起作用。