std::stacktrace_entry:: source_file

std:: string source_file ( ) const ;		(自 C++23 起)

返回词法上包含其求值由 * this 表示的表达式或语句的源文件的假定或实际名称，或在非分配失败的其他失败情况下返回空字符串，例如当 * this 为空时。

要么 source_file 返回推测的源文件名且 source_line 返回推测的行号，要么 source_file 返回实际的源文件名且 source_line 返回实际的行号。

目录 1 参数 2 返回值 3 异常 4 备注 5 示例 6 另请参阅

参数

(无)

返回值

成功时返回上述指定的源文件名，除内存分配失败外的其他失败情况返回空字符串。

异常

若无法为内部数据结构或结果字符串分配内存，则抛出 std::bad_alloc 。

注释

源文件的假定名称是预定义宏 __FILE__ 展开后的内容，并可通过 #line 指令进行修改。

本节内容不完整 原因：缺少“实际名称”的定义（ LWG 问题 3507 ）

此函数未提供自定义分配器支持，因为实现通常需要平台特定的内存分配、系统调用及大量CPU密集型工作，而自定义分配器对此函数并无益处——平台特定操作所耗时间比内存分配高出一个数量级。

示例

本节内容不完整 原因：缺少示例

参见

file_name

返回此对象表示的文件名 ( std::source_location 的公开成员函数)