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

FreeBSD Manual Pages

  
 
  

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

NAME
       std::wmemmove - std::wmemmove

Synopsis
	  Defined in header <cwchar>
	  wchar_t*  wmemmove(  wchar_t*	 dest, const wchar_t* src, std::size_t
       count );

	  Copies exactly count successive wide characters from the wide	 char-
       acter array
	  pointed to by	src to the wide	character array	pointed	to by dest.

	  If count is zero, the	function does nothing.

	  The  arrays  may overlap: copying takes place	as if the wide charac-
       ters were copied	to
	  a temporary wide character array and then copied from	the  temporary
       array to	dest.

Parameters
	  dest	- pointer to the wide character	array to copy to
	  src	- pointer to the wide character	array to copy from
	  count	- number of wide characters to copy

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 copies: nulls as well as invalid  characters  are
       copied too.

Example
       // Run this code

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

	int main()
	{
	    std::setlocale(LC_ALL, "en_US.utf8");
	    std::wcout.imbue(std::locale("en_US.utf8"));

	    wchar_t str[] = L"";
	    std::wcout << str << '\n';
	    std::wmemmove(str+4, str+3,	3); // copy from [] to []
	    std::wcout << str << '\n';
	}

Possible output:

See also
			copies a certain amount	of wide	characters between two
       non-overlapping
	  wmemcpy	arrays
			(function)
	  memmove	moves one buffer to another
			(function)
	  copy		copies a range of elements to a	new location
	  copy_if	(function template)
	  (C++11)
	  copy_backward	copies a range of elements in backwards	order
			(function template)

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

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

home | help