# std::source_location::function_name

< cpp‎ | utility‎ | source location

constexpr const char* function_name() const noexcept; |  | (C++20 起)

返回与此对象所表示的位置关联的函数名，若存在。

### 参数

（无）

### 返回值

若此对象表示函数体内的位置，则返回对应函数名的实现定义的空终止字节字符串。

否则，返回空字符串。

### 示例

以下示例展示能如何用 `std::source_location::function_name()` 打印函数、构造函数、析构函数或重载的 `operator()` 的名字。

    #include <iostream>
    #include <string_view>
    #include <source_location>

    inline void function_name(
        const std::string_view signature = "()",
        const std::source_location& location = std::source_location::current())
    {
        std::cout << location.function_name(); // <- 调用方之名！
        if (!signature.empty())
            std::cout << signature;
        std::cout << '\n';
    }

    void foo() { function_name(); }

    struct S {
        S() { function_name(); }
        S(int) { function_name("(int)"); }
        S& operator=(S const&) { function_name("(const S&)"); return *this; }
        S& operator=(S&&) { function_name("(S&&)"); return *this; }
        ~S() { function_name(); }
    };

    auto main() -> int
    {
        foo();
        S p;
        S q{42};
        p = q;
        p = std::move(q);
    }

输出：

    foo()
    S()
    S(int)
    operator=(const S&)
    operator=(S&&)
    ~S()
    ~S()

### 参阅

line | 返回此对象所表示的行号 (公开成员函数)
column | 返回此对象所表示的列号 (公开成员函数)
file_name | 返回此对象所表示的文件名 (公开成员函数)