MRCanonicalTypedefs.h File Reference

#include "MRMesh/MRMacros.h"

Go to the source code of this file.

Macros
#define	MR_CANONICAL_TYPEDEFS(type_, name_, aliases_)
#define	DETAIL_MR_CANONICAL_TYPEDEFS_LOOP_USING_BODY(name_, ...)   using name_ = __VA_ARGS__;
#define	DETAIL_MR_CANONICAL_TYPEDEFS_LOOP_USING_A(...)   DETAIL_MR_CANONICAL_TYPEDEFS_LOOP_USING_BODY MR_IDENTITY()(__VA_ARGS__) DETAIL_MR_CANONICAL_TYPEDEFS_LOOP_USING_B
	MR_IDENTITY here keeps the legacy MSVC preprocessor happy.
#define	DETAIL_MR_CANONICAL_TYPEDEFS_LOOP_USING_B(...)   DETAIL_MR_CANONICAL_TYPEDEFS_LOOP_USING_BODY MR_IDENTITY()(__VA_ARGS__) DETAIL_MR_CANONICAL_TYPEDEFS_LOOP_USING_A
#define	DETAIL_MR_CANONICAL_TYPEDEFS_LOOP_USING_A_END
#define	DETAIL_MR_CANONICAL_TYPEDEFS_LOOP_USING_B_END
#define	DETAIL_MR_CANONICAL_TYPEDEFS(type_, name_, aliases_)
	no __has_attribute

Macro Definition Documentation

DETAIL_MR_CANONICAL_TYPEDEFS

#define DETAIL_MR_CANONICAL_TYPEDEFS	(		type_,
			name_,
			aliases_ )

no __has_attribute

DETAIL_MR_CANONICAL_TYPEDEFS_LOOP_USING_A

#define DETAIL_MR_CANONICAL_TYPEDEFS_LOOP_USING_A

(

...

)

DETAIL_MR_CANONICAL_TYPEDEFS_LOOP_USING_BODY MR_IDENTITY()(__VA_ARGS__) DETAIL_MR_CANONICAL_TYPEDEFS_LOOP_USING_B

MR_IDENTITY here keeps the legacy MSVC preprocessor happy.

DETAIL_MR_CANONICAL_TYPEDEFS_LOOP_USING_A_END

#define DETAIL_MR_CANONICAL_TYPEDEFS_LOOP_USING_A_END

DETAIL_MR_CANONICAL_TYPEDEFS_LOOP_USING_B

#define DETAIL_MR_CANONICAL_TYPEDEFS_LOOP_USING_B

(

...

)

DETAIL_MR_CANONICAL_TYPEDEFS_LOOP_USING_BODY MR_IDENTITY()(__VA_ARGS__) DETAIL_MR_CANONICAL_TYPEDEFS_LOOP_USING_A

DETAIL_MR_CANONICAL_TYPEDEFS_LOOP_USING_B_END

#define DETAIL_MR_CANONICAL_TYPEDEFS_LOOP_USING_B_END

DETAIL_MR_CANONICAL_TYPEDEFS_LOOP_USING_BODY

#define DETAIL_MR_CANONICAL_TYPEDEFS_LOOP_USING_BODY	(		name_,
			... )   using name_ = __VA_ARGS__;

MR_CANONICAL_TYPEDEFS

#define MR_CANONICAL_TYPEDEFS	(		type_,
			name_,
			aliases_ )

Value:

    MR_IDENTITY type_ name_; \
    MR_END(DETAIL_MR_CANONICAL_TYPEDEFS_LOOP_USING_A aliases_) \
    DETAIL_MR_CANONICAL_TYPEDEFS(type_, name_, aliases_)

This helper macro is used to declare canonical typedefs. For example, if you have this: template <typename T> struct MRMESH_CLASS Vector3; /// MRMESH_CLASS isn't necessary, just to demonstrate that it's supported. using Vector3f = Vector3<float>; using Vector3i = Vector3<int>; You should rewrite it as following: MR_CANONICAL_TYPEDEFS( (template <typename T> struct MRMESH_CLASS), Vector3, ( Vector3f, Vector3<float> ) ( Vector3i, Vector3<int> ) )

WHAT THIS ACHIEVES? This macro only has effect on Clang. It primarily affects the error messages, using those typedefs instead of the full type when possible. It also helps when parsing our code with libclang to automatically generate Python bindings.

NOTE:

• Only non-template usings can be declared like this. If you want to add additional templated ones, add them below the macro manually.