Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
std::basic_...c_stacktrace(3) C++ Standard Libarystd::basic_...c_stacktrace(3)

NAME
       std::basic_stacktrace::basic_stacktrace	 -  std::basic_stacktrace::ba-
       sic_stacktrace

Synopsis
	  basic_stacktrace()	  noexcept(/*	    see	      below	  */);
       (1) (since C++23)
	  explicit  basic_stacktrace(  const allocator_type& alloc ) noexcept;
       (2) (since C++23)
	  basic_stacktrace(	const	  basic_stacktrace&	 other	    );
       (3) (since C++23)
	  basic_stacktrace(	basic_stacktrace&&     other	)    noexcept;
       (4) (since C++23)
	  basic_stacktrace(	  const	       basic_stacktrace&	other,
       (5) (since C++23)
			    const allocator_type& alloc	);
	  basic_stacktrace(  basic_stacktrace&&	 other,	 const allocator_type&
       (6) (since C++23)
	  alloc	);

	  Constructs an	empty basic_stacktrace,	or copy/move from other.

	  1) Default constructor. Constructs an	empty basic_stacktrace with a
	  default-constructed allocator.
	  2) Constructs	an empty basic_stacktrace using	alloc as  the  alloca-
       tor.
	  3)  Copy constructor.	Constructs a basic_stacktrace with the copy of
       the contents of
	  other, the allocator is obtained as if by calling
	  std::allocator_traits<allocator_type>::select_on_container_copy_con-
       struction(other.get_allocator()).
	  4) Move constructor. Constructs a basic_stacktrace with the contents
       of other	using
	  move semantics. Allocator is move-constructed	from  that  of	other.
       After
	  construction,	other is left in a valid but unspecified state.
	  5)  Same  as	the copy constructor, except that alloc	is used	as the
       allocator.
	  6) Behaves same as the move constructor if alloc ==  other.get_allo-
       cator().
	  Otherwise,  allocates	 memory	 with  alloc and performs element-wise
       move. alloc is used
	  as the allocator.

	  (3,5,6) may throw an exception or construct  an  empty  basic_stack-
       trace on	allocation
	  failure.

Parameters
	  alloc	 -  allocator  to  use	for all	memory allocations of the con-
       structed
		  basic_stacktrace
	  other	- another basic_stacktrace to copy/move	from

Exceptions
	  1)
	  noexcept specification:
	  noexcept(std::is_nothrow_default_constructible_v<allocator_type>)
	  3,5,6) May propagate the exception thrown on allocation failure.

Complexity
	  1,2) Constant.
	  3) Linear in size of other.
	  4) Constant.
	  5) Linear in size of other.
	  6) Linear in size of other if	alloc != other.get_allocator(),	other-
       wise constant.

Notes
	  After	container move construction (overload (4)), references,	point-
       ers, and
	  iterators (other than	the end	iterator) to other remain  valid,  but
       refer to	elements
	  that are now in *this. The current standard makes this guarantee via
       the blanket
	  statement  in	 [container.reqmts]/67,	and a more direct guarantee is
       under
	  consideration	via LWG	issue 2321.

Example
	   This	section	is incomplete
	   Reason: no example

See also
	  operator= assigns to the basic_stacktrace
		    (public member function)
	  current   obtains the	current	stacktrace or its given	part
	  [static]  (public static member function)

Categories:
	    * conditionally noexcept
	    * Todo no example

http://cppreference.com		  2024.06.10	 std::basic_...c_stacktrace(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=std::basic_stacktrace::basic_stacktrace&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help