Namespaces
Variants
Views
Actions

std::experimental::source_location::function_name

From cppreference.com
 
 
Experimental
Technical Specification
Filesystem library (filesystem TS)
Library fundamentals (library fundamentals TS)
Library fundamentals 2 (library fundamentals TS v2)
Library fundamentals 3 (library fundamentals TS v3)
Extensions for parallelism (parallelism TS)
Extensions for parallelism 2 (parallelism TS v2)
Extensions for concurrency (concurrency TS)
Extensions for concurrency 2 (concurrency TS v2)
Concepts (concepts TS)
Ranges (ranges TS)
Reflection (reflection TS)
Mathematical special functions (special functions TR)
Experimental Non-TS
Pattern Matching
Linear Algebra
std::execution
Contracts
2D Graphics
 
 
 
constexpr const char* function_name() const noexcept;
(library fundamentals TS v2)

Returns the name of the function associated with the position represented by this object, if any.

Contents

[edit] Parameters

(none)

[edit] Return value

If this object represents a position in a body of a function, returns an implementation-defined null-terminated byte string corresponding to the name of the function.

Otherwise, an empty string is returned.

[edit] Example

The following example shows how it is possible to use the std::source_location::function_name() to print a name of a function, constructor, destructor, or overloaded operator().

#include <experimental/source_location>
#include <iostream>
#include <string_view>
 
inline void function_name(
    const std::string_view signature = "()",
    const std::experimental::source_location& location
        = std::experimental::source_location::current())
{
    std::cout
        << location.function_name() // <- name of the caller!
        << signature
        << '\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(); }
};
 
int main()
{
    foo();
    S p;
    S q{42};
    p = q;
    p = std::move(q);
}

Possible output:

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

[edit] See also

return the line number represented by this object
(public member function) [edit]
return the column number represented by this object
(public member function) [edit]
return the file name represented by this object
(public member function) [edit]
C++ documentation for Filename and line information