17 Library introduction [library]

Clauses [language.support] through [thread] and Annex [depr] describe the behavior of numerous functions defined by the C++ standard library. Under some circumstances, however, certain of these function descriptions also apply to replacement functions defined in the program ([definitions]).

A C++ program may provide the definition for any of twelve dynamic memory allocation function signatures declared in header <new> ([basic.stc.dynamic], [support.dynamic]):

• (2.1)

  operator new(std::size_t)

• (2.2)

  operator new(std::size_t, const std::nothrow_t&)

• (2.3)

  operator new[](std::size_t)

• (2.4)

  operator new[](std::size_t, const std::nothrow_t&)

• (2.5)

  operator delete(void*)

• (2.6)

  operator delete(void*, const std::nothrow_t&)

• (2.7)

  operator delete[](void*)

• (2.8)

  operator delete[](void*, const std::nothrow_t&)

• (2.9)

  operator delete(void*, std::size_t)

• (2.10)

  operator delete(void*, std::size_t, const std::nothrow_t&)

• (2.11)

  operator delete[](void*, std::size_t)

• (2.12)

  operator delete[](void*, std::size_t, const std::nothrow_t&)

The program's definitions are used instead of the default versions supplied by the implementation ([support.dynamic]). Such replacement occurs prior to program startup ([basic.def.odr], [basic.start]). The program's definitions shall not be specified as inline. No diagnostic is required.