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 .

Этот раздел не завершён Причина: отсутствует определение "actual name" ( LWG issue 3507 )

Поддержка пользовательских аллокаторов для этой функции не предоставляется, поскольку реализации обычно требуют платформо-специфичных аллокаций, системных вызовов и большого объема ресурсоемкой работы, в то время как пользовательский аллокатор не предоставляет преимуществ для этой функции, так как платформо-специфичные операции занимают на порядок больше времени, чем аллокация.

Пример

Этот раздел не завершён Причина: отсутствует пример

Смотрите также

file_name

возвращает имя файла, представленное этим объектом (публичная функция-член std::source_location )