Show Lecture.HeaderFiles as a slide show.

CS253 Header Files

Header Files

Much like Java’s import, C++ uses #include:

#include <foobar>

This means to compile the file foobar (found on Linux systems somewhere under /usr/include), as if it were part of the source file at this point. It typically contains declarations of functions and classes.

It’s called a header file because you #include it at the beginning, or head, of your .cc file.

C Compatibility

#include <stdio.h>
int main() {
    printf("Hello, world!\n");
    return 0;
}

Hello, world!

• There’s no using namespace std, because this is C.
• The call is simply printf(), not std::printf() or ::printf(), because this is C.
• Still, it must compile as C++, or backward compatibility is a joke.
• Therefore, #include <stdio.h> must put its symbols into the global namespace.

Nudging C toward C++

However, in C++, we don’t like putting things into the global namespace unnecessarily. This is called namespace pollution.

#include <stdio.h>	symbols ⇒ global namespace
#include <cstdio>	symbols ⇒ std namespace

Or, in general:

#include <foo.h>	foo symbols ⇒ global namespace
#include <cfoo>	foo symbols ⇒ std namespace

Pure C++

Pure C++ header files, such as <iostream>, don’t use .h.

There is no standard <iostream.h>. Some compilers provide it to reduce customer support calls, but it’s non-standard.

#include <iostream.h>

c.cc:1: fatal error: iostream.h: No such file or directory
compilation terminated.

Summary

#include <foo.h>	C: foo symbols ⇒ global namespace
#include <cfoo>	C compat: foo symbols ⇒ std namespace
#include <foo>	C++: foo symbols ⇒ std namespace

This can get a bit confusing if foo starts with the letter c.

Examples

#include <stdio.h>	Declare ::printf(), etc.
#include <cstdio>	Declare std::printf(), etc.
#include <stdlib.h>	Declare ::exit(), etc.
#include <cstdlib>	Declare std::exit(), etc.
#include <ctype.h>	Declare ::isupper(), etc.
#include <cctype>	Declare std::isupper(), etc.
#include <vector>	Declare std::vector, the C++ vector class
#include <string.h>	Declare ::strlen(), etc.
#include <cstring>	Declare std::strlen(), etc.
#include <string>	Declare std::string, the C++ string class

Deprecated

• Use of the *.h header files is deprecated in later versions of C++.
  • “Deprecated” means that they still exist, but their use is discouraged.
• Use the pure C++ versions instead.
  • That is, to use the function exit(), #include <cstdlib>. Avoid <stdlib.h>.

However:

• There are still non-standard functions whose definitions live in non-standard header files.
• Sometimes, we have to call those functions.
• For example, to call getpid(), which returns the Linux process id, we need to #include <unistd.h>.
• Life is a compromise.