std::source_location

 

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

 

Dienstprogramm-Bibliotheken

Sprachunterstützung Typunterstützung (Basistypen, RTTI) Bibliotheks-Feature-Test-Makros (C++20) Programm-Dienstprogramme Variadische Funktionen initializer_list (C++11) is_constant_evaluated (C++20) is_within_lifetime (C++26) source_location (C++20) Coroutine-Unterstützung (C++20) Vertragsunterstützung (C++26) Drei-Wege-Vergleich three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)   is_eqis_ltis_lteq (C++20)(C++20)(C++20)   is_neqis_gtis_gteq (C++20)(C++20)(C++20)

Allgemeine Hilfsmittel Funktionsobjekte Bit-Manipulation (C++20) bitset hash (C++11) Relationale Operatoren (in C++20 veraltet) rel_ops::operator!=rel_ops::operator>    rel_ops::operator<=rel_ops::operator>= Ganzzahl-Vergleichsfunktionen cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)   cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) Swap und Typ-Operationen swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) Gemeinsame Vokabulartypen pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23)

 

std::source_location

Memberfunktionen

Erzeugung

source_location::source_location

source_location::current

Feldzugriff

source_location::line

source_location::column

source_location::file_name

source_location::function_name

 

Definiert in Header <source_location>
struct source_location;		(seit C++20)

Die Klasse std::source_location repräsentiert bestimmte Informationen über den Quellcode, wie z.B. Dateinamen, Zeilennummern und Funktionsnamen. Zuvor mussten Funktionen, die diese Informationen über die Aufrufstelle erhalten wollten (zu Protokollierungs-, Test- oder Debugging-Zwecken), Makros verwenden, damit vordefinierte Makros wie __LINE__ und __FILE__ im Kontext des Aufrufers expandiert werden. Die Klasse std::source_location bietet eine bessere Alternative.

std::source_location erfüllt die Anforderungen an DefaultConstructible, CopyConstructible, CopyAssignable, Destructible und Swappable.

Zusätzlich sind die folgenden Bedingungen true

• std::is_nothrow_move_constructible_v<std::source_location>,
• std::is_nothrow_move_assignable_v<std::source_location>, und
• std::is_nothrow_swappable_v<std::source_location>.

Es ist beabsichtigt, dass std::source_location eine geringe Größe hat und effizient kopiert werden kann.

Es ist nicht spezifiziert, ob die Kopier-/Verschiebekonstruktoren und die Kopier-/Verschiebezuweisungsoperatoren von std::source_location trivial und/oder constexpr sind.

Memberfunktionen

Erzeugung
(Konstruktor)	erzeugt eine neue source_location mit implementierungsdefinierten Werten (public member function)
current [static]	erzeugt eine neue source_location, die dem Ort der Aufrufstelle entspricht (public static member function)
Feldzugriff
line	gibt die von diesem Objekt repräsentierte Zeilennummer zurück (public member function)
column	gibt die von diesem Objekt repräsentierte Spaltennummer zurück (public member function)
file_name	gibt den von diesem Objekt repräsentierten Dateinamen zurück (public member function)
function_name	gibt den Namen der von diesem Objekt repräsentierten Funktion zurück, falls vorhanden (public member function)

Hinweise

Feature-Test-Makro	Wert	Std	Feature
__cpp_lib_source_location	201907L	(C++20)	Erfassung von Quellcodeinformationen (std::source_location)

Beispiel

Führen Sie diesen Code aus

#include <iostream>
#include <source_location>
#include <string_view>
 
void log(const std::string_view message,
         const std::source_location location =
               std::source_location::current())
{
    std::clog << "file: "
              << location.file_name() << '('
              << location.line() << ':'
              << location.column() << ") `"
              << location.function_name() << "`: "
              << message << '\n';
}
 
template<typename T>
void fun(T x)
{
    log(x); // line 20
}
 
int main(int, char*[])
{
    log("Hello world!"); // line 25
    fun("Hello C++20!");
}

Mögliche Ausgabe

file: main.cpp(25:8) `int main(int, char**)`: Hello world!
file: main.cpp(20:8) `void fun(T) [with T = const char*]`: Hello C++20!

Siehe auch

#line	ändert die Zeilennummer des Quellcodes und optional den aktuellen Dateinamen (preprocessing directive)
stacktrace_entry (C++23)	Repräsentation einer Auswertung in einem Stacktrace (class)