How does #error in C/C++ work?

Question

I am guessing from # that it is only a compile-time utility. How can it be used in C/C++ programs?

Did not find much about it on the internet. Any links would be helpful.

Answer 1

It causes the compiler (or preprocessor) to output the error message. In C++, it also renders the translation unit ill-formed (i.e., it causes compilation to fail).

If you have several macros that could be defined and you want to be sure that only certain combinations of them are defined, you can use #error to cause compilation to fail if an invalid combination is defined.

It can also be useful if you want to be sure that some block of code is never compiled (for whatever reason).

Answer 2

Useful to check compiler settings as well as verifying macro value combinations. Some random examples:

#if !defined(_DLL) #  error This code will only work properly when compiled with /MD #endif  #if _WIN32_WINNT < 0x502 #  error Sorry, Windows versions prior to XP SP2 are not supported #endif  #if defined(_APPLE) && defined(_LINUX) #  error Conflicting operating system option selected, choose one. #endif