home | help 
std::fpos::state(3)	       C++ Standard Libary	     std::fpos::state(3)

NAME
     std::fpos::state - std::fpos::state

Synopsis
	State state() const;	(1)
	void state( State st ); (2)

	Manages the file position state.

	1) Returns the value of the file position state.
	2) Replaces the file position state with the value of st.

	For  the  specializations of std::fpos that are used in the standard li-
     brary, State is
	always std::mbstate_t.

Parameters
	st - new value for the state

Return value
	1) The current value of the fpos state.
	2) (none)

Example
     // Run this code

      #include <cwchar>
      #include <iostream>
      #include <sstream>

      int main()
      {
	  std::istringstream s("test");
	  std::mbstate_t st = s.tellg().state();

	  if (std::mbsinit(&st))
	      std::cout << "The stream is in the initial shift state\n";
      }

Output:
      The stream is in the initial shift state

	Defect reports

	The following behavior-changing defect	reports  were  applied	retroac-
     tively to
	previously published C++ standards.

	  DR	Applied to		Behavior as published		    Cor-
     rect behavior
	LWG  441  C++98       overload	(1)  was not declared const (it is const
     added const
			   in the synopsis)

See also
		  conversion state information necessary  to  iterate  multibyte
     character
	mbstate_t strings
		  (class)

http://cppreference.com 	   2024.06.10		     std::fpos::state(3)
home | help