FreeBSD Manual Pages
std::stackt...source_file(3) C++ Standard Libary std::stackt...source_file(3) NAME std::stacktrace_entry::source_file - std::stacktrace_entry::source_file Synopsis std::string source_file() const; (since C++23) Returns the presumed or actual name of the source file that lexi- cally contains the expression or statement whose evaluation is represented by *this, or an empty string on failure other than allocation failure, e.g. when *this is empty. Either source_file returns the presumed source file name and source_line returns the presumed line number, or source_file returns the actual source file name and source_line returns the actual line number. Parameters (none) Return value The name of the source file specified above on success, an empty string on failure other than allocation failure. Exceptions Throws std::bad_alloc if memory for the internal data structures or the resulting string cannot be allocated. Notes The presumed name of the source file is what the predefined macro __FILE__ expands to, and can be changed by the #line directive. This section is incomplete Reason: definition of "actual name" is missing (LWG issue 3507) Custom allocators support for this function is not provided, because the implementations usually require platform specific allocations, sys- tem calls and a lot of CPU intensive work, while a custom allocator does not provide benefits for this function as the platform specific operations take an order of magnitude more time than the allocation. Example This section is incomplete Reason: no example See also file_name return the file name represented by this object (public member function of std::source_location) Categories: * Todo with reason * Todo no example http://cppreference.com 2024.06.10 std::stackt...source_file(3)
NAME | Synopsis | Parameters | Return value | Exceptions | Notes | Example | See also | Categories:
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::stacktrace_entry::source_file&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>