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

FreeBSD Manual Pages

  
 
  

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

NAME
       std::bitset::to_string -	std::bitset::to_string

Synopsis
	  template<

	  class	CharT,
	  class							       Traits,
       (until C++11)
	  class	Alloc
	  > std::basic_string<CharT, Traits, Allocator>

	  to_string() const;
	  template<

	  class	CharT =	char,
	  class		 Traits		  =	      std::char_traits<CharT>,
       (since C++11)
	  class		  Allocator	      =		 std::allocator<CharT>
       (until C++23)
	  > std::basic_string<CharT, Traits, Allocator>

	  to_string( CharT zero	= CharT('0'), CharT one	= CharT('1') ) const;
	  template<

	  class	CharT =	char,
	  class	Traits = std::char_traits<CharT>,
	  class		 Allocator	     =		 std::allocator<CharT>
       (since C++23)
	  > std::basic_string<CharT, Traits, Allocator>
	  constexpr

	  to_string( CharT zero	= CharT('0'), CharT one	= CharT('1') ) const;

	  Converts the contents	of the bitset to a string. Uses	zero to	repre-
       sent bits with
	  value	of false and one to represent bits with	value of true.

	  The  resulting string	contains N characters with the first character
       corresponds to
	  the last (N-1th) bit and the last  character	corresponding  to  the
       first bit.

Parameters
	  zero - character to use to represent false
	  one  - character to use to represent true

Return value
	  the converted	string

Exceptions
	  May throw std::bad_alloc from	the std::string	constructor.

Example
       // Run this code

	#include <iostream>
	#include <bitset>
	int main()
	{
	    std::bitset<8> b(42);
	    std::cout << b.to_string() << '\n'
		      << b.to_string('*') << '\n'
		      << b.to_string('O', 'X') << '\n';
	}

Output:
	00101010
	**1*1*1*
	OOXOXOXO

See also
	  to_ulong   returns  an  unsigned  long integer representation	of the
       data
		    (public member function)
	  to_ullong returns an unsigned	long long  integer  representation  of
       the data
	  (C++11)   (public member function)

http://cppreference.com		  2022.07.31	     std::bitset::to_string(3)

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

home | help