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

FreeBSD Manual Pages

  
 
  

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

NAME
       std::to_wstring - std::to_wstring

Synopsis
	  Defined in header <string>
	  std::wstring	to_wstring(  int  value	 );		    (1)	(since
       C++11)
	  std::wstring to_wstring(  long  value	 );		   (2)	(since
       C++11)
	  std::wstring	to_wstring(  long  long	 value	);	    (3)	(since
       C++11)
	  std::wstring to_wstring(  unsigned  value  );		   (4)	(since
       C++11)
	  std::wstring	to_wstring(  unsigned  long  value  );	    (5)	(since
       C++11)
	  std::wstring to_wstring( unsigned long  long	value  );  (6)	(since
       C++11)
	  std::wstring	to_wstring(  float  value  );		    (7)	(since
       C++11)
	  std::wstring to_wstring(  double  value  );		   (8)	(since
       C++11)
	  std::wstring	to_wstring(  long  double  value  );	    (9)	(since
       C++11)

	  Converts a numeric value to std::wstring.

	  Let buf be an	internal to the	conversion functions buffer,
	  sufficiently large to	contain	the result of conversion.

	  1) Converts a	signed decimal integer to a wide string	as if by
	  std::swprintf(buf, sz, L"%d",	value).
	  2) Converts a	signed decimal integer to a wide string	as if by
	  std::swprintf(buf, sz, L"%ld", value).
	  3) Converts a	signed decimal integer to a wide string	as if by
	  std::swprintf(buf, sz, L"%lld", value).
	  4) Converts an unsigned decimal integer to a wide string  as	if  by
       (until C++26)
	  std::swprintf(buf, sz, L"%u",	value).
	  5) Converts an unsigned decimal integer to a wide string as if by
	  std::swprintf(buf, sz, L"%lu", value).
	  6) Converts an unsigned decimal integer to a wide string as if by
	  std::swprintf(buf, sz, L"%llu", value).
	  7,8) Converts	a floating point value to a wide string	as if by
	  std::swprintf(buf, sz, L"%f",	value).
	  9) Converts a	floating point value to	a wide string as if by
	  std::swprintf(buf, sz, L"%Lf", value).
	  1-9)	 Converts   a  numeric	value  to  a  wide  string  as	if  by
       (since C++26)
	  std::format(L"{}", value).

Parameters
	  value	- a numeric value to convert

Return value
	  A wide string	holding	the converted value.

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

Example
       // Run this code

	#include <iostream>
	#include <string>

	int main()
	{
	    for	(const double f	: {23.43, 1e-9,	1e40, 1e-40, 123456789.0})
		std::wcout << "std::wcout: " <<	f << '\n'
			   << "to_wstring: " <<	std::to_wstring(f) << "\n\n";
	}

Output:
	std::wcout: 23.43
	to_wstring: 23.430000

	std::wcout: 1e-09
	to_wstring: 0.000000

	std::wcout: 1e+40
	to_wstring: 10000000000000000303786028427003666890752.000000

	std::wcout: 1e-40
	to_wstring: 0.000000

	std::wcout: 1.23457e+08
	to_wstring: 123456789.000000

See also
	  to_string converts an	integral or floating-point value to string
	  (C++11)   (function)

http://cppreference.com		  2024.06.10		    std::to_wstring(3)

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

home | help