std::source_location

struct source_location;

La classe std::source_location représente certaines informations sur le code source, telles que les noms de fichiers, les numéros de ligne et les noms de fonctions. Auparavant, les fonctions souhaitant obtenir ces informations sur le site d'appel (à des fins de journalisation, de test ou de débogage) devaient utiliser des macros afin que des macros prédéfinies comme __LINE__ et __FILE__ soient développées dans le contexte de l'appelant. La classe std::source_location offre une meilleure alternative.

std::source_location satisfait aux exigences DefaultConstructible, CopyConstructible, CopyAssignable, Destructible et Swappable.

De plus, les conditions suivantes sont true:

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

Il est prévu que std::source_location ait une petite taille et puisse être copié efficacement.

Il n'est pas spécifié si les constructeurs de copie/déplacement et les opérateurs d'affectation de copie/déplacement de std::source_location sont triviaux et/ou constexpr.

Fonctions membres

Notes

Exemple

#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); // ligne 20
}
int main(int, char*[])
{
    log("Hello world!"); // ligne 25
    fun("Hello C++20!");
}

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!

Voir aussi