Conditionally appends the given elementvalue to the end of the container.

Ifsize()== capacity() istrue, there are no effects. Otherwise, appends an object of typeT:

No iterators or references are invalidated, exceptend(), which is invalidated if the insertion occurs.

[edit]Parameters

[edit]Return value

std::addressof(back()) ifsize()< capacity(),nullptr otherwise.

[edit]Complexity

Constant.

[edit]Exceptions

Any exception thrown by initialization of inserted element.

If an exception is thrown for any reason, these functions have no effect (strong exception safety guarantee).

[edit]Notes

[edit]Example

#include <cassert>#include <inplace_vector>#include <string> int main(){std::inplace_vector<std::string,2> pets;std::string dog{"dog"}; std::string* p1= pets.try_push_back("cat");// overload (1)assert(*p1=="cat" and pets.size()==1); std::string* p2= pets.try_push_back(std::move(dog));// overload (2)assert(*p2=="dog" and pets.size()==2); assert(pets[0]=="cat" and pets[1]=="dog");assert(pets.size()== pets.capacity()); std::string* p3= pets.try_push_back("bug");assert(p3== nullptr and pets.size()==2);}

[edit]See also

• In other languages

• Deutsch
• Español
• Français
• Italiano
• 日本語
• Português
• Русский
• 中文