std::stacktrace_entry:: source_file
|
std::
string
source_file
(
)
const
;
|
(seit C++23) | |
Gibt den vermuteten oder tatsächlichen Namen der Quelldatei zurück, die lexikalisch den Ausdruck oder die Anweisung enthält, dessen Auswertung durch * this repräsentiert wird, oder einen leeren String bei Fehlern außer Speicherzuweisungsfehlern, z.B. wenn * this leer ist.
Entweder gibt
source_file
den vermuteten Quelldateinamen zurück und
source_line
gibt die vermutete Zeilennummer zurück, oder
source_file
gibt den tatsächlichen Quelldateinamen zurück und
source_line
gibt die tatsächliche Zeilennummer zurück.
Inhaltsverzeichnis |
Parameter
(keine)
Rückgabewert
Der Name der oben angegebenen Quelldatei bei Erfolg, ein leerer String bei Fehlern außer bei Allokationsfehlern.
Exceptions
Wirft std::bad_alloc , wenn Speicher für die internen Datenstrukturen oder die resultierende Zeichenkette nicht alloziert werden kann.
Hinweise
Der vermutete Name der Quelldatei ist das, worauf das vordefinierte Makro __FILE__ expandiert, und kann durch die #line Direktive geändert werden.
|
Dieser Abschnitt ist unvollständig
Grund: Definition von "actual name" fehlt ( LWG issue 3507 ) |
Die Unterstützung für benutzerdefinierte Allokatoren ist für diese Funktion nicht vorgesehen, da die Implementierungen in der Regel plattformspezifische Allokationen, Systemaufrufe und umfangreiche CPU-intensive Arbeiten erfordern, während ein benutzerdefinierter Allokator für diese Funktion keine Vorteile bietet, da die plattformspezifischen Operationen um eine Größenordnung mehr Zeit in Anspruch nehmen als die Allokation.
Beispiel
|
Dieser Abschnitt ist unvollständig
Grund: Kein Beispiel |
Siehe auch
|
gibt den durch dieses Objekt repräsentierten Dateinamen zurück
(öffentliche Elementfunktion von
std::source_location
)
|