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

NAME
     std::setfill - std::setfill

Synopsis
	Defined in header <iomanip>
	template< class CharT >
	/*unspecified*/ setfill( CharT c );

	When  used in an expression out << setfill(c) sets the fill character of
     the stream
	out to c.

Parameters
	c - new value for the fill character

Return value
	An object of unspecified type such that

	  * if out is an object of type std::basic_ostream<CharT,  Traits>,  the
     expression
	    out << setfill(c)
	       * has type std::basic_ostream<CharT, Traits>&
	       * has value out
	       * behaves as if it called f(out, c)

	where the function f is defined as:

      template<class CharT, class Traits>
      void f(std::basic_ios<CharT, Traits>& str, CharT c)
      {
	  // set fill character
	  str.fill(c);
      }

Notes
	The current fill character may be obtained with std::ostream::fill.

Example
     // Run this code

      #include <iomanip>
      #include <iostream>

      int main()
      {
	  std::cout << "default fill: [" << std::setw(10) << 42 << "]\n"
		    << "setfill('*'): [" << std::setfill('*')
					 << std::setw(10) << 42 << "]\n";
      }

Output:
      default fill: [	     42]
      setfill('*'): [********42]

	Defect reports

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

	  DR	Applied to	Behavior as published	      Correct behavior
	LWG 183 C++98	   setbase could only be used with usable with any  out-
     put
			   streams of type std::ostream    character stream

See also
	fill	 manages the fill character
		 (public member function of std::basic_ios<CharT,Traits>)
	internal sets the placement of fill characters
	left	 (function)
	right
	setw	 changes the width of the next input/output field
		 (function)

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