std::stacktrace_entry::source_file

来自cppreference.com
 
 
工具库
通用工具
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)
(C++20)
swap 与类型运算
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)

初等字符串转换
(C++17)
(C++17)
栈踪
 
std::stacktrace_entry
成员函数
观察器
查询
stacktrace_entry::source_file
(C++23)
非成员函数
(C++23)(C++23)
(C++23)
(C++23)
辅助类
 
std::string source_file() const;
(C++23 起)

返回词法上含有求值为 *this 所表示的表达式或语句的源文件的预设或实际名,或在分配失败以外的失败,例如 *this 为空时返回空字符串。

要么 source_file 返回预设源文件名且 source_line 返回预设行号,要么 source_file 返回实际源文件名且 source_line 返回实际行号。

参数

(无)

返回值

成功时为指定如上的源文件名,分配失败以外的失败时为空字符串。

异常

若不能分配内部数据结构或结果字符串的内存则抛出 std::bad_alloc

注解

源文件的预设名是预定义宏 __FILE__ 所展开的结果,而且能由 #line 指令更改。

不提供对此函数的定制分配器支持,因为实现通常要求平台特定的分配、系统调用和大量 CPU 集中工作,而定制分配器不会对此函数提供便利,因为平台特定的操作耗费的时间数量级多于分配。

示例

参阅

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