Question

In Qt Source files, there are two versions of header files, such as:

qxmlstream.h
qxmlstream_p.h

Why are there _p.h files?

Answer 1

They’re generally private header files, used so that components of a subsystems know about everything but users don’t need to.

In other words, something that multiple C source files in Qt might want to know about would be in the private header files if the users of Qt didn’t need to know about them.

One example might be a customised memory allocator for your subsystem. Perhaps you know that every memory allocation you make is 128 bytes then you can provide such an allocator:

void * malloc128 (void) { ... }

Since this is likely to be of dubious value to users of your subsystem, there’s no point publishing it as part of the official API but every single one of your own source files needs the prototype so you’d put it in the private header file.

Then your own code uses:

#include "mysubsystem_p.h"

while users of your API use:

#include "mysubsystem.h"