std::stacktrace_entry::source_file
来自 cppreference.cn
< cpp | utility | stacktrace entry
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 的公共成员函数) |