nameof

C ++ 이름

헤더 전용 C ++ 17 라이브러리는 매크로 이름과 기능을 제공하여 변수, 유형, 기능, 매크로 및 열거의 이름을 단순히 얻는 기능을 제공합니다.

이 프로젝트가 마음에 들면 우크라이나 전쟁의 희생자들을 돕는 기금 중 하나에 기부하는 것을 고려하십시오 : https://u24.gov.ua.

선적 서류 비치

• 참조
• 제한
• 완성

특징 및 예

• 이름

   // Name of variable.
  NAMEOF (somevar) -> "somevar"
  
  // Name of member variable.
  NAMEOF(person.address.zip_code) -> "zip_code"
  
  // Name of function.
  NAMEOF(foo< int , float >()) -> "foo"
  
  // Name of member function.
  NAMEOF(somevar.some_method()) -> "some_method"
  NAMEOF(somevar.some_method< int >()) -> "some_method"
  
  // Name of macro.
  NAMEOF(__LINE__) -> "__LINE__"
  NAMEOF(NAMEOF(structvar)) -> "NAMEOF"
  
  // Obtains full name of variable, function, macro.
  NAMEOF_FULL(somevar.some_method< int >()) -> "some_method<int>"
  
  // Obtains raw name of variable, function, macro.
  NAMEOF_RAW(somevar.some_method< int >()) -> "somevar.some_method<int>()"

• 열거 이름

   enum class Color { RED = 1 , BLUE = 2 , GREEN = 4 };
  
  auto color = Color::RED;
  // Name of enum variable.
  NAMEOF_ENUM (color) -> "RED"
  nameof::nameof_enum(color) -> "RED"
  
  // Static storage enum variable to string.
  // This version is much lighter on the compile times and is not restricted to the enum_range limitation.
  NAMEOF_ENUM_CONST(Color::GREEN) -> "GREEN"
  nameof::nameof_enum<Color::GREEN>() -> "GREEN"
  
  // Enum flags variable to string.
  NAMEOF_ENUM_FLAG(Color::GREEN | Color::BLUE) -> "GREEN|BLUE"
  nameof::nameof_enum_flag<Color::GREEN | Color::BLUE>() -> "GREEN|BLUE"
  
  // Obtains name of enum variable or default value if enum variable out of range.
  NAMEOF_ENUM_OR(Color::GREEN) -> "GREEN"
  NAMEOF_ENUM_OR((Color)0, "none") -> "none"

• 유형의 이름

   const my::detail::SomeClass< int >& var_ref = var;
  // Name of variable type.
  NAMEOF_TYPE_EXPR (var_ref) -> "my::detail::SomeClass<int>"
  nameof::nameof_type<decltype(var_ref)>() -> "my::detail::SomeClass<int>"
  NAMEOF_FULL_TYPE_EXPR(var_ref) -> " const my::detail::SomeClass<int>&"
  nameof::nameof_full_type<decltype(var_ref)>() -> " const my::detail::SomeClass<int>&"
  NAMEOF_SHORT_TYPE_EXPR(var_ref) -> "SomeClass"
  nameof::nameof_short_type<decltype(var_ref)>() -> "SomeClass"
  
  using T = const my::detail::SomeClass<int>&;
  // Name of type.
  NAMEOF_TYPE (T) ->"my::detail::SomeClass<int>"
  nameof::nameof_type<T>() -> "my::detail::SomeClass<int>"
  NAMEOF_FULL_TYPE(T) -> " const my::detail::SomeClass<int>&"
  nameof::nameof_full_type<T>() -> " const my::detail::SomeClass<int>&"
  NAMEOF_SHORT_TYPE(T) -> "SomeClass"
  nameof::nameof_short_type<T>() -> "SomeClass"
  
  my::detail::Base* ptr = new my::detail::Derived();
  // Name of type, using rtti.
  NAMEOF_TYPE_RTTI (*ptr) -> "my::detail::Derived"
  NAMEOF_FULL_TYPE_RTTI(*ptr) -> "volatile const my::detail::Derived&"
  NAMEOF_SHORT_TYPE_RTTI(*ptr) -> "Derived"
  
  struct A {
    int this_is_the_name;
  };
  // Obtains name of member.
  NAMEOF_MEMBER (&A::this_is_the_name) -> "this_is_the_name"
  nameof::nameof_member(&A::this_is_the_name) -> "this_is_the_name"
  
  int someglobalvariable = 0;
  // Obtains name of a function, a global or class static variable.
  NAMEOF_POINTER (&someglobalconstvariable) == "someglobalconstvariable"
  nameof::nameof_pointer(&someglobalconstvariable) == "someglobalconstvariable"
  
  constexpr auto global_ptr = &someglobalvariable;
  NAMEOF_POINTER (global_ptr) == "someglobalconstvariable"
  nameof::nameof_pointer(global_ptr) == "someglobalconstvariable"

발언

• 사용하기 전에 기능의 한계를 읽으십시오.

완성

필요한 파일 이름을 추가해야합니다 .hpp.

외부 종속성을 위해 프로젝트에서 VCPKG를 사용하는 경우 패키지 이름을 사용할 수 있습니다.

Conan을 사용하여 종속성을 관리하는 경우 xyz 사용하려는 릴리스 버전 인 Conan의 요구에 nameof/xyz 추가하십시오.

Archlinux 사용자는 다음 명령을 사용하여 Package Manager AUR에 의해 nameof 설치할 수 있습니다. yay -S nameof .

또는 Cmake의 Fetch_Content 모듈을 기반으로하는 CPM과 같은 것을 사용할 수 있습니다.

CPMAddPackage(
    NAME nameof
    GITHUB_REPOSITORY Neargye/nameof
    GIT_TAG x.y.z # Where `x.y.z` is the release version you want to use.
)

컴파일러 호환성

각 기능에 대한 참조를 확인하십시오.

MIT 라이센스에 따라 라이센스