What is the effect of extern “C” in C++?

extern "C" makes a function-name in C++ have C linkage (compiler does not mangle the name) so that client C code can link to (use) your function using a C compatible header file that contains just the declaration of your function. Your function definition is contained in a binary format (that was compiled by your C++ compiler) that the client C linker will then link to using the C name.

Since C++ has overloading of function names and C does not, the C++ compiler cannot just use the function name as a unique id to link to, so it mangles the name by adding information about the arguments. A C compiler does not need to mangle the name since you can not overload function names in C. When you state that a function has extern "C" linkage in C++, the C++ compiler does not add argument/parameter type information to the name used for linkage.

Just so you know, you can specify extern "C" linkage to each individual declaration/definition explicitly or use a block to group a sequence of declarations/definitions to have a certain linkage:

extern "C" void foo(int);
extern "C"
{
   void g(char);
   int i;
}

If you care about the technicalities, they are listed in section 7.5 of the C++03 standard, here is a brief summary (with emphasis on extern "C"):

  • extern "C" is a linkage-specification
  • Every compiler is required to provide “C” linkage
  • A linkage specification shall occur only in namespace scope
  • All function types, function names and variable names have a language linkage See Richard’s Comment: Only function names and variable names with external linkage have a language linkage
  • Two function types with distinct language linkages are distinct types even if otherwise identical
  • Linkage specs nest, inner one determines the final linkage
  • extern "C" is ignored for class members
  • At most one function with a particular name can have “C” linkage (regardless of namespace)
  • extern "C" forces a function to have external linkage (cannot make it static) See Richard’s comment: static inside extern "C" is valid; an entity so declared has internal linkage, and so does not have a language linkage
  • Linkage from C++ to objects defined in other languages and to objects defined in C++ from other languages is implementation-defined and language-dependent. Only where the object layout strategies of two language implementations are similar enough can such linkage be achieved

Related Posts:

  1. When to use extern “C” in simple words? [duplicate]
  2. What is a segmentation fault?
  3. How many spaces for tab character(\t)?
  4. What does (~0L) mean?
  5. What is the difference between float and double?
  6. Why are #ifndef and #define used in C++ header files?
  7. What exactly is the difference between “pass by reference” in C and in C++?
  8. Floating point exception( core dump
  9. Mutex example / tutorial? [closed]
  10. What does “dereferencing” a pointer mean?
  11. What is an unsigned char?
  12. What does “dereferencing” a pointer mean?
  13. Convert char to int in C and C++
  14. Why use conio.h?
  15. How to track down a “double free or corruption” error
  16. Convert an int to ASCII character
  17. How to track down a “double free or corruption” error
  18. Why unsigned int 0xFFFFFFFF is equal to int -1?
  19. What is the significance of return 0 in C and C++?
  20. How to go from fopen to fopen_s
  21. Difference between long double and double in C and C++ [duplicate]
  22. What is use of c_str function In c++
  23. What is the difference between const int*, const int * const, and int const *?
  24. What is the C version of RMI
  25. How to print pthread_t
  26. What is the difference between const int*, const int * const, and int const *?
  27. What is the printf format specifier for bool?
  28. Fastest way to check if a file exist using standard C++/C++11,14,17/C?
  29. Is there a function to copy an array in C/C++?
  30. Difference between using Makefile and CMake to compile the code
  31. What is the difference between a static and const variable?
  32. Should I learn C before learning C++?
  33. Eclipse C++ : “Program “g++” not found in PATH”
  34. Visual Studio debugger error: Unable to start program Specified file cannot be found
  35. unsigned int vs. size_t
  36. Fatal error: iostream: No such file or directory in compiling C program using GCC
  37. Convert Python program to C/C++ code?
  38. error: expected primary-expression before ‘)’ token (C)
  39. Is “argv[0] = name-of-executable” an accepted standard or just a common convention?
  40. Examples of good gotos in C or C++
  41. What is activation record in the context of C and C++?
  42. Fastest way to check if a file exist using standard C++/C++11,14,17/C?
  43. How to convert C++ Code to C
  44. How to make an array with a dynamic size? General usage of dynamic arrays (maybe pointers too)?
  45. Fatal error: ‘stdafx.h’ file not found
  46. warning: control reaches end of non-void function [-Wreturn-type]
  47. gcc/g++: “No such file or directory”
  48. What does ‘const static’ mean in C and C++?
  49. How to use glOrtho() in OpenGL?
  50. Best C/C++ Network Library
  51. Is the sizeof(some pointer) always equal to four?
  52. 2D array vs array of arrays
  53. How do malloc() and free() work?
  54. C++ array assign error: invalid array assignment
  55. How to run valgrind with basic c example?
  56. Typedef function pointer?
  57. “…redeclared as different kind of symbol”?
  58. What is the use of intptr_t?
  59. Debug vs Release in CMake
  60. How can I get the list of files in a directory using C or C++?
  61. Debug vs Release in CMake
  62. How can I get the list of files in a directory using C or C++?
  63. What does “Permission denied” “Id returned 1 exit status” mean?
  64. Multi-character constant warnings
  65. What is the C equivalent to the C++ cin statement?
  66. Static linking vs dynamic linking
  67. What are the different versions of exec used for in C and C++?
  68. What’s the difference between nexti and stepi in gdb?
  69. C++ – Too Many Initializers for Arrays
  70. Reading string by char till end of line C/C++
  71. Is there a replacement for unistd.h for Windows (Visual C)?
  72. C++ – include unistd.h: why not cunistd?
  73. How to project a point onto a plane in 3D?
  74. C: using strtol endptr is never NULL, cannot check if value is integer only?
  75. gcc: undefined reference to
  76. Why use pointers?
  77. What’s the difference between * and & in C?
  78. Difference between pic Vs pie
  79. Double pointer array in c++
  80. What’s the meaning of exception code “EXC_I386_GPFLT”?
  81. How to write log base(2) in c/c++
  82. multiple definitions error in c++ and solution to solve this issue
  83. gcc -g :what will happen
  84. What is the source of the data for the ProgramFiles, ProgramW6432Dir, ProgramFilesDir (x86), CommonProgramFiles environment variables?
  85. What is the job of autogen.sh when building a c++ package on Linux
  86. What’s the Use of ‘\r’ escape sequence?
  87. Is there a standard sign function (signum, sgn) in C/C++?
  88. Using OpenMP with clang
  89. Warning: comparison of distinct pointer types
  90. cc1.exe System Error – libwinpthread-1.dll missing – But it isn’t
  91. Two decimal places using printf( )
  92. Fatal error: iostream: No such file or directory in compiling C program using GCC
  93. Difference between the int * i and int** i
  94. Is there a way to compile C++ to C Code?
  95. Linker error: “linker input file unused because linking not done”, undefined reference to a function in that file
  96. Whats the difference between UInt8 and uint8_t
  97. The tilde operator in C
  98. Is it possible to decompile a C++ executable file
  99. Difference between `constexpr` and `const`
  100. Sentinel while loop for C++

Leave a Comment