std::stacktrace_entry::source_file

 

C++

Compiler support

Freestanding and hosted

Language

Standard library

Standard library headers

Named requirements

Feature test macros (C++20)

Language support library

Concepts library (C++20)

Metaprogramming library (C++11)

Diagnostics library

General utilities library

Strings library

Containers library

Iterators library

Ranges library (C++20)

Algorithms library

Numerics library

Localizations library

Input/output library

Filesystem library (C++17)

Regular expressions library (C++11)

Concurrency support library (C++11)

Execution support library (C++26)

Technical specifications

Symbols index

External libraries

 

Diagnostics library

Exception handling exception uncaught_exceptionuncaught_exceptions (until C++20*)  (C++17) exception_ptr (C++11) make_exception_ptr (C++11) current_exception (C++11) rethrow_exception (C++11) nested_exception (C++11) throw_with_nested (C++11) rethrow_if_nested (C++11) Exception handling failures terminate terminate_handler get_terminate (C++11) set_terminate bad_exception unexpected (until C++17*) unexpected_handler (until C++17*) get_unexpected (until C++17*) set_unexpected (until C++17*) Error numbers Error codes errno Assertions assert

Exception categories logic_error invalid_argument domain_error length_error out_of_range runtime_error range_error overflow_error underflow_error tx_exception (TM TS) System error error_category (C++11) generic_category (C++11) system_category (C++11) error_condition (C++11) errc (C++11) error_code (C++11) system_error (C++11) Stacktrace stacktrace_entry (C++23) basic_stacktrace (C++23) Debugging support is_debugger_present (C++26) breakpoint_if_debugging (C++26) breakpoint (C++26)

 

std::stacktrace_entry

Member functions

stacktrace_entry::stacktrace_entry

stacktrace_entry::operator=

Observers

stacktrace_entry::native_handle

stacktrace_entry::operator bool

Query

stacktrace_entry::description

stacktrace_entry::source_file

stacktrace_entry::source_line

Non-member functions

operator== operator<=>

to_string(std::stacktrace_entry)

operator<<

Helper classes

hash<std::stacktrace_entry>

formatter<std::stacktrace_entry>

 

std::string source_file() const;		(since C++23)

Returns the presumed or actual name of the source file that lexically 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.

Custom allocators support for this function is not provided, because the implementations usually require platform specific allocations, system 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.

See also

file_name

return the file name represented by this object (public member function of std::source_location)