Section 3: library functions
std::bad_exception – std::bad_exception Synopsis Defined in header <exception> class bad_exception; std::bad_exception is the type of the exception thrown by the C++ runtime in the following situations: 1) If std::exception_ptr stores a copy of the caught exception and if the copy constructor of the exception object caught by std::current_exception throws an exception, the captured exception is…
std::bad_cast::bad_cast – std::bad_cast::bad_cast Synopsis bad_cast(); Constructs new std::bad_cast object. The contents of the byte string returned by what() are implementation defined. Parameters (none) Exceptions (none) (until C++11) noexcept specification: (since C++11) noexcept
std::bad_cast – std::bad_cast Synopsis Defined in header <typeinfo> class bad_cast : public std::exception; An exception of this type is thrown when a dynamic_cast to a reference type fails the run-time check (e.g. because the types are not related by inheritance), and also from std::use_facet if the requested facet does not exist in the locale. std-bad…
std::bad_array_new_length::bad_array_new_length – std::bad_array_new_length::bad_array_new_length Synopsis bad_array_new_length() noexcept; (since C++11) Constructs new bad_array_new_length object with in implementation-defined null-terminated byte string which is accessible through what(). Parameters (none)
std::bad_array_new_length – std::bad_array_new_length Synopsis Defined in header <new> class bad_array_new_length; (since C++11) std::bad_array_new_length is the type of the object thrown as exceptions by the new-expressions to report invalid array lengths if 1) array length is negative 2) total size of the new array would exceed implementation-defined maximum value 3) the number of initializer-clauses exceeds the…
std::bad_any_cast – std::bad_any_cast Synopsis Defined in header <any> class bad_any_cast : public std::bad_cast; (since C++17) Defines a type of object to be thrown by the value-returning forms of std::any_cast on failure. Inherited from std::exception Member functions destructor destroys the exception object (virtual public member function of std::exception) [virtual] what returns an explanatory string (virtual public…
std::bad_alloc – std::bad_alloc Synopsis Defined in header <new> class bad_alloc; std::bad_alloc is the type of the object thrown as exceptions by the allocation_functions to report failure to allocate storage. std-bad alloc-inheritance.svg Inheritance diagram Member functions constructs the bad_alloc object constructor (public member function) replaces a bad_alloc object operator= (public member function) returns explanatory string what…
std::back_inserter – std::back_inserter Synopsis Defined in header <iterator> template< class Container > (until C++20) std::back_insert_iterator<Container> back_inserter( Container& c ); template< class Container > (since C++20) constexpr std::back_insert_iterator<Container> back_inserter( Container& c ); back_inserter is a convenience function template that constructs a std::back_insert_iterator for the container c with the type deduced from the type of the argument….
std::back_insert_iterator<Container>::operator= – std::back_insert_iterator<Container>::operator= Synopsis back_insert_iterator<Container> &(until C++ 11) operator=(typename Container::const_reference value); back_insert_iterator<Container> &(since C++ 11) operator=(const typename Container::value_type &value); (until C++ 20) constexpr back_insert_iterator<Container> &(1)(since C++ 20) operator=(const typename Container::value_type &value); back_insert_iterator<Container> &(since C++ 11) operator=(typename Container::value_type &&value); (2)(until C++ 20) constexpr back_insert_iterator<Container> &(since C++ 20) operator=(typename Container::value_type &&value); Inserts the given value value to…
std::back_insert_iterator<Container>::back_insert_iterator – std::back_insert_iterator<Container>::back_insert_iterator Synopsis constexpr back_insert_iterator() noexcept = default; (1) (since C++20) explicit back_insert_iterator( Container& c ); (2) (until C++20) constexpr explicit back_insert_iterator( Container& c ); (since C++20) 1) Initializes the underlying pointer to container with nullptr. (since C++20) 2) Initializes the underlying pointer to the container to std::addressof(c). Parameters c – container to initialize…
std::back_insert_iterator – std::back_insert_iterator Synopsis Defined in header<iterator> template <class Container> class back_insert_iterator : public std::iterator<std::output_iterator_tag, (until C++ 17) void, void, void, void> template <class Container> (since C++ 17) class back_insert_iterator; std::back_insert_iterator is an LegacyOutputIterator that appends to a container for which it was constructed. The container’s push_back() member function is called whenever the iterator (whether…
std::auto_ptr_ref< _Tp1 > – Synopsis Public Member Functions auto_ptr_ref (_Tp1 *__p) Public Attributes _Tp1 * _M_ptr Detailed Description template<typename _Tp1>struct std::auto_ptr_ref< _Tp1 > A wrapper class to provide auto_ptr with reference semantics. For example, an auto_ptr can be assigned (or constructed from) the result of a function which returns an auto_ptr by value. All the…
std::auto_ptr<T>::reset – std::auto_ptr<T>::reset Synopsis void reset(T *p = 0) throw(); (deprecated in C++ 11)(removed in C++ 17) Replaces the held pointer by p. If the currently held pointer is not null pointer, delete get() is called. Parameters p – a pointer to an object to manage Return value (none) See also releases ownership of the…
std::auto_ptr<T>::release – std::auto_ptr<T>::release Synopsis T* release() throw(); (deprecated in C++11) (removed in C++17) Releases the held pointer. After the call *this holds the null pointer. Parameters (none) Return value get(). See also destroys the managed object reset (public member function)
std::auto_ptr<T>::operatorauto_ptr<Y> – std::auto_ptr<T>::operatorauto_ptr<Y> Synopsis template< class Y > (1) (deprecated in C++11) operator auto_ptr_ref<Y>() throw(); (removed in C++17) template< class Y > (2) (deprecated in C++11) operator auto_ptr<Y>() throw(); (removed in C++17) Converts *this to an auto_ptr for a different type Y. 1) Returns an implementation-defined type that holds a reference to *this. std::auto_ptr is…
std::auto_ptr<T>::operator= – std::auto_ptr<T>::operator= Synopsis auto_ptr& operator=( auto_ptr& r ) throw(); (1) (deprecated in C++11) (removed in C++17) template< class Y > (2) (deprecated in C++11) auto_ptr& operator=( auto_ptr<Y>& r ) throw(); (removed in C++17) auto_ptr& operator=( auto_ptr_ref m ) throw(); (3) (deprecated in C++11) (removed in C++17) Replaces the managed object with the one managed…
std::auto_ptr<T>::operator*,std::auto_ptr<T>::operator-> – std::auto_ptr<T>::operator*,std::auto_ptr<T>::operator-> Synopsis T& operator*() const throw(); (1) (deprecated in C++11) (removed in C++17) T* operator->() const throw(); (2) (deprecated in C++11) (removed in C++17) Dereferences a pointer to the managed object. The first version requires get() != 0. Parameters (none) Return value 1) *get(). 2) get(). See also returns a pointer to the…
std::auto_ptr<T>::get – std::auto_ptr<T>::get Synopsis T* get() const throw(); (deprecated in C++11) (removed in C++17) Returns the pointer that is held by *this. Parameters (none) Return value The pointer held by *this. See also accesses the managed object operator* (public member function) operator->
std::auto_ptr<T>::~auto_ptr – std::auto_ptr<T>::~auto_ptr Synopsis ~auto_ptr() throw(); (deprecated in C++11) (removed in C++17) Destroys the managed object. Calls delete get().
std::auto_ptr – std::auto_ptr Synopsis Defined in header <memory> template< class T > class auto_ptr; (1) (deprecated in C++11) (removed in C++17) template<> class auto_ptr<void>; (2) (deprecated in C++11) (removed in C++17) auto_ptr is a smart pointer that manages an object obtained via new_expression and deletes that object when auto_ptr itself is destroyed. It may be…