home | help 
std::basic_stringbuf::view(3)  C++ Standard Libary std::basic_stringbuf::view(3)

NAME
     std::basic_stringbuf::view - std::basic_stringbuf::view

Synopsis
	std::basic_string_view<CharT,  Traits>	view()	const  noexcept;  (since
     C++20)

	Creates and returns a std::basic_string_view over the underlying charac-
     ter sequence.

	  * For input-only streams,  the  returned  view  represents  the  range
     [eback(),
	    egptr()).
	  *  For  input/output or output-only streams, references the characters
     from pbase()
	    to the last character in the  sequence  regardless	of  egptr()  and
     epptr().
	  *  If  the  stream  is  neither  input  nor  output,	returns std::ba-
     sic_string_view<CharT,
	    Traits>{}.

	The member character sequence in a buffer open for writing can be  over-
     allocated for
	efficiency  purposes.  In that case, only the initialized characters are
     referenced:
	these characters are the ones that were obtained from the  string  argu-
     ment of the
	constructor,  the string argument used by the most recent call to a set-
     ter overload
	of str(), or from a write operation. A typical implementation that uses
	over-allocation maintains a high-watermark pointer to track the  end  of
     the
	initialized  part  of  the  buffer  and the returned view references the
     characters from
	pbase() to the high-watermark pointer.

Parameters
	(none)

Return value
	A view over the underlying character sequence.

Notes
	Using of the return value is undefined behavior if the underlying  char-
     acter sequence
	is destroyed or invalidated, unless the return value is empty.

	This	 function     is    typically	 accessed    through	std::ba-
     sic_istringstream::view(),
	std::basic_ostringstream::view(), or std::basic_stringstream::view().

See also
				   replaces or obtains a copy of the  associated
     character
	str			   string
				   (public member function)
				   returns a non-modifiable string_view into the
     entire
	operator basic_string_view string
	(C++17) 		   (public member function of
				   std::basic_string<CharT,Traits,Allocator>)

http://cppreference.com 	   2024.06.10	   std::basic_stringbuf::view(3)
home | help