home | help
std::istrst...::istrstream(3)  C++ Standard Libary std::istrst...::istrstream(3)

NAME
     std::istrstream::istrstream - std::istrstream::istrstream

Synopsis
	explicit  istrstream(  const  char*  s	);	      (1) (deprecated in
     C++98)
							    (removed in C++26)
	explicit istrstream(  char*  s	);		    (2)  (deprecated  in
     C++98)
							    (removed in C++26)
	istrstream(  const  char*  s,  std::streamsize	n  ); (3) (deprecated in
     C++98)
							    (removed in C++26)
	istrstream( char* s,  std::streamsize  n  );	    (4)  (deprecated  in
     C++98)
							    (removed in C++26)

	Constructs new std::istrstream and its underlying std::strstreambuf.

	1,2)  Constructs  the underlying std::strstreambuf by calling strstream-
     buf(s, 0) and
	initializes the base class with the address of the strstreambuf. The be-
     havior is
	undefined if s is not pointing at an element of a null-terminated array.
	3,4) Constructs the underlying std::strstreambuf by  calling  strstream-
     buf(s, n) and
	initializes the base class with the address of the strstreambuf. The be-
     havior is
	undefined if s is not pointing at an element of an array whose length is
     at least n
	elements.

Parameters
	s - C-string or char array to use as the contents of the stream
	n - size of the array

Example
     // Run this code

      #include <iostream>
      #include <strstream>

      int main()
      {
	  std::istrstream s1("1 2 3"); // string literal
	  int n1, n2, n3;
	  if (s1 >> n1 >> n2 >> n3)
	      std::cout << n1 << ", " << n2 << ", " << n3 << '\n';

	  char arr[] = {'4', ' ', '5', ' ', '6'};
	  std::istrstream s2(arr, sizeof arr);
	  if (s2 >> n1 >> n2 >> n3)
	      std::cout << n1 << ", " << n2 << ", " << n3 << '\n';
      }

Output:
      1, 2, 3
      4, 5, 6

See also
	constructor   constructs a strstreambuf object
		      (public member function of std::strstreambuf)
	constructor   constructs an ostrstream object, optionally allocating the
     buffer
		      (public member function of std::ostrstream)
	constructor    constructs  a strstream object, optionally allocating the
     buffer
		      (public member function of std::strstream)

http://cppreference.com 	   2024.06.10	   std::istrst...::istrstream(3)

home | help