Suppose I have some incomplete type
// in foo.hh
struct Hidden;
that I want to use as element type of a std::vector. Using an
Instantiating std::vector<T> with incomplete type T is undefined behavior up to C++14. In C++17 this limitation is relaxed somewhat:
[vector.overview]/3 An incomplete type
Tmay be used when instantiatingvectorif the allocator satisfies the allocator completeness requirements 17.6.3.5.1.Tshall be complete before any member of the resulting specialization ofvectoris referenced.
(Note: the default allocator std::allocator does satisfy those completeness requirements).
My reading is that with C++17, it's legal for a translation unit to include your header (the one that forward-declares Hidden and defines Public), and define a variable Public pub; - but not to actually use any members of pub.d.v. Before C++17, merely including the header would already trigger undefined behavior.