std::stacktrace_entry::source_file

 

C++

Compiler-Unterstützung

Freestanding und gehostet

Sprache

Standardbibliothek

Header der Standardbibliothek

Benannte Anforderungen

Feature-Test-Makros (C++20)

Bibliothek für Sprachunterstützung

Konzepte-Bibliothek (C++20)

Diagnostik-Bibliothek

Speicherverwaltungsbibliothek

Metaprogrammierungsbibliothek (C++11)

Allgemeine Dienstprogramme-Bibliothek

Container-Bibliothek

Iterator-Bibliothek

Ranges-Bibliothek (C++20)

Algorithmen-Bibliothek

Bibliothek für Zeichenketten

Textverarbeitungsbibliothek

Numerik-Bibliothek

Datums- und Zeitbibliothek

Ein-/Ausgabe-Bibliothek

Dateisystembibliothek (C++17)

Unterstützung für nebenläufige Programmierung (C++11)

Ausführungssteuerungsbibliothek (C++26)

Technische Spezifikationen

Symbolverzeichnis

Externe Bibliotheken

 

Diagnostik-Bibliothek

Ausnahmebehandlung exception uncaught_exceptionuncaught_exceptions (bis C++20*)  (C++17) exception_ptr (C++11) make_exception_ptr (C++11) current_exception (C++11) rethrow_exception (C++11) nested_exception (C++11) throw_with_nested (C++11) rethrow_if_nested (C++11) Exception handling failures terminate terminate_handler get_terminate (C++11) set_terminate bad_exception unexpected (bis C++17*) unexpected_handler (bis C++17*) get_unexpected (bis C++17*) set_unexpected (bis C++17*) Fehlernummern Error codes errno Assertions assert

Exception categories logic_error invalid_argument domain_error length_error out_of_range runtime_error range_error overflow_error underflow_error tx_exception (TM TS) System error error_category (C++11) generic_category (C++11) system_category (C++11) error_condition (C++11) errc (C++11) error_code (C++11) system_error (C++11) Stacktrace stacktrace_entry (C++23) basic_stacktrace (C++23) Debugging-Unterstützung is_debugger_present (C++26) breakpoint_if_debugging (C++26) breakpoint (C++26)

 

std::stacktrace_entry

Memberfunktionen

stacktrace_entry::stacktrace_entry

stacktrace_entry::operator=

Observer

stacktrace_entry::native_handle

stacktrace_entry::operator bool

Abfrage

stacktrace_entry::description

stacktrace_entry::source_file

stacktrace_entry::source_line

Nicht-Member-Funktionen

operator== operator<=>

to_string(std::stacktrace_entry)

operator<<

Hilfsklassen

hash<std::stacktrace_entry>

formatter<std::stacktrace_entry>

 

std::string source_file() const;		(seit C++23)

Gibt den vermuteten oder tatsächlichen Namen der Quelldatei zurück, die die Anweisung oder das Statement lexikalisch enthält, deren Auswertung durch *this repräsentiert wird, oder eine leere Zeichenkette im Fehlerfall, außer bei Speicherzuordnungsfehlern, z.B. wenn *this leer ist.

Entweder gibt source_file den vermuteten Quellcode-Dateinamen und source_line die vermutete Zeilennummer zurück, oder source_file gibt den tatsächlichen Quellcode-Dateinamen und source_line die tatsächliche Zeilennummer zurück.

Parameter

(keine)

Rückgabewert

Der oben genannte Name der Quelldatei im Erfolgsfall, eine leere Zeichenkette im Fehlerfall, außer bei Speicherzuordnungsfehlern.

Ausnahmen

Löst std::bad_alloc aus, wenn der Speicher für die internen Datenstrukturen oder die resultierende Zeichenkette nicht zugeordnet werden kann.

Hinweise

Der vermutete Name der Quelldatei ist das, wozu das vordefinierte Makro __FILE__ erweitert wird, und kann durch die #line-Direktive geändert werden.

Die Unterstützung für benutzerdefinierte Allokatoren für diese Funktion wird nicht bereitgestellt, da die Implementierungen normalerweise plattformspezifische Allokationen, Systemaufrufe und viele CPU-intensive Arbeiten erfordern, während ein benutzerdefinierter Allokator für diese Funktion keine Vorteile bietet, da die plattformspezifischen Operationen um Größenordnungen länger dauern als die Allokation.

Siehe auch

file_name

gibt den von diesem Objekt repräsentierten Dateinamen zurück (public member function of std::source_location)