std::stacktrace_entry::source_file
| std::string source_file() const; |
(начиная с C++23) | |
Возвращает предполагаемое или фактическое имя исходного файла, который лекси��ески содержит выражение или оператор, оценка которого представлена *this, или пустую строку в случае ошибки, отличной от ошибки выделения, например, когда *this пусто.
Либо source_file возвращает предполагаемое имя исходного файла, а source_line возвращает предполагаемый номер строки, либо source_file возвращает фактическое имя исходного файла, а source_line возвращает фактический номер строки.
Содержание |
[править] Параметры
(нет)
[править] Возвращаемое значение
Имя исходного файла, указанное выше в случае успеха, пустая строка в случае ошибки, отличной от ошибки распределения.
[править] Исключения
Генерирует std::bad_alloc, если память для внутренних структур данных или строки результата не может быть выделена.
[править] Примечание
Предполагаемое имя исходного файла это то, до чего расширяется предопределённый макрос __FILE__, и его можно изменить с помощью директивы #line.
| Этот раздел не завершён Причина: определение "фактического имени" отсутствует (LWG проблема 3507) |
Поддержка пользовательских аллокаторов для этой функции не предусмотрена, потому что реализации обычно требуют выделений памяти для конкретной платформы, системных вызовов и большого количества интенсивной работы ЦП, в то время как пользовательский аллокатор не даёт преимуществ для этой функции, поскольку специфичные для платформы операции занимают больше времени, чем выделено.
[править] Пример
| Этот раздел не завершён Причина: нет примера |
[править] Смотрите также
| возвращает имя файла, представленное этим объектом (public функция-элемент std::stacktrace_entry)
|
