std::allocator<T>::allocate

pointer allocate( size_type n, const void* hint = 0 );

T* allocate( std::size_t n, const void* hint );

T* allocate( std::size_t n );

constexpr T* allocate( std::size_t n );

Alloziert n * sizeof(T) Bytes nicht initialisierten Speichers durch Aufruf von ::operator new(std::size_t) oder ::operator new(std::size_t, std::align_val_t)(seit C++17), aber es ist nicht spezifiziert, wann und wie diese Funktion aufgerufen wird. Der Zeiger hint kann verwendet werden, um eine räumliche Lokalität zu bieten: der Allokator, falls von der Implementierung unterstützt, wird versuchen, den neuen Speicherblock so nah wie möglich an hint.

Dann erzeugt diese Funktion ein Array vom Typ T[n] im Speicher und beginnt seine Lebensdauer, beginnt aber nicht die Lebensdauer seiner Elemente.

Die Verwendung dieser Funktion ist fehlerhaft, wenn T ein unvollständiger Typ.

Parameter

Rückgabewert

Zeiger auf das erste Element eines Arrays von n Objekten des Typs T , deren Elemente noch nicht konstruiert wurden.

Exceptions

Wirft std::bad_alloc falls die Allokation fehlschlägt.

Hinweise

Die Formulierung "unspecified when and how" ermöglicht es, Heap-Allokationen zu kombinieren oder wegzuoptimieren , die von den Standardbibliothek-Containern durchgeführt werden, selbst wenn solche Optimierungen für direkte Aufrufe von ::operator new nicht erlaubt sind. Zum Beispiel wird dies von libc++ implementiert ( [1] und [2] ).

Nach dem Aufruf von allocate() und vor der Konstruktion der Elemente ist die Zeigerarithmetik von T* innerhalb des allokierten Arrays wohldefiniert, aber das Verhalten ist undefiniert, wenn auf Elemente zugegriffen wird.

Fehlerberichte

Die folgenden verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.

Siehe auch