std::stacktrace_entry::source_file
来自 cppreference.cn
std::string source_file() const; |
(C++23 起) | |
返回词法上包含由 *this 所表示的表达式或语句的源文件的推定或实际名称;如果失败(除了分配失败),例如当 *this 为空时,则返回空字符串。
`source_file` 要么返回推定的源文件名且 `source_line` 返回推定的行号,要么 `source_file` 返回实际的源文件名且 `source_line` 返回实际的行号。
目录 |
[编辑] 参数
(无)
[编辑] 返回值
成功时返回上述指定的源文件名,如果失败(除了分配失败)则返回空字符串。
[编辑] 异常
如果无法为内部数据结构或结果字符串分配内存,则抛出 std::bad_alloc。
[编辑] 注意
源文件的推定名称是预定义宏 __FILE__ 展开的结果,可以通过 #line 指令进行更改。
本节不完整 原因:“实际名称”的定义缺失 (LWG issue 3507) |
此函数不支持自定义分配器,因为实现通常需要平台特定的分配、系统调用和大量的 CPU 密集型工作,而自定义分配器对此函数没有益处,因为平台特定的操作比分配花费的时间要多一个数量级。
[编辑] 示例
本节不完整 原因:无示例 |
[编辑] 参见
返回此对象表示的文件名 ( std::source_location 的公共成员函数) |