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

FreeBSD Manual Pages

  
 
  

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

NAME
       std::wmemset - std::wmemset

Synopsis
	  Defined in header <cwchar>
	  wchar_t* wmemset( wchar_t* dest, wchar_t ch, std::size_t count );

	  Copies the wide character ch into each of the	first count wide char-
       acters of the
	  wide character array pointed to by dest.

	  If overflow occurs, the behavior is undefined.

	  If count is zero, the	function does nothing.

Parameters
	  dest	- pointer to the wide character	array to fill
	  ch	- fill wide character
	  count	- number of wide characters to fill

Return value
	  Returns a copy of dest

Notes
	  This	function  is not locale-sensitive and pays no attention	to the
       values of the
	  wchar_t objects it writes: nulls as well as invalid wide  characters
       are written too.

Example
       // Run this code

	#include <iostream>
	#include <cwchar>
	#include <clocale>
	#include <locale>

	int main()
	{
	    wchar_t ar[4] = {L'1', L'2', L'3', L'4'};
	    std::wmemset(ar, L'\U0001f34c', 2);	// replaces [12] with the  ba-
       nanas
	    std::wmemset(ar+2, L'', 2);	// replaces [34] with the  bananas

	    std::setlocale(LC_ALL, "en_US.utf8");
	    std::wcout.imbue(std::locale("en_US.utf8"));
	    std::wcout << std::wstring(ar, 4) << '\n';
	}

Possible output:

See also
	  memset  fills	a buffer with a	character
		  (function)
		  copies  a certain amount of wide characters between two non-
       overlapping
	  wmemcpy arrays
		  (function)
	  fill_n  copy-assigns the given value to N elements in	a range
		  (function template)

http://cppreference.com		  2022.07.31		       std::wmemset(3)

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

home | help