home | help
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 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.

	 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,  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  mag-
     nitude 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)

home | help