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

FreeBSD Manual Pages

  
 
  

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	behav-
       ior
	  LWG 183 C++98	     setbase could only	be used	with usable  with  any
       output
			     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)

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

home | help