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

FreeBSD Manual Pages

  
 
  

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

NAME
       std::wcscat - std::wcscat

Synopsis
	  Defined in header <cwchar>
	  wchar_t *wcscat( wchar_t *dest, const	wchar_t	*src );

	  Appends  a  copy  of the wide	string pointed to by src to the	end of
       the wide	string
	  pointed to by	dest. The wide character src[0]	replaces the null ter-
       minator at the
	  end of dest. The resulting wide string is null-terminated.

	  The behavior is undefined if the  destination	 array	is  not	 large
       enough for the
	  contents  of both str	and dest and the terminating null wide charac-
       ter.

	  The behavior is undefined if the strings overlap.

Parameters
	  dest - pointer to the	null-terminated	wide string to append to
	  src  - pointer to the	null-terminated	wide string to copy from

Return value
	  Returns a copy of dest

Example
       // Run this code

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

	int main(void)
	{
	    wchar_t str[50] = L", .";
	    std::wcscat(str, L"	");
	    std::wcscat(str, L"	 .");

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

Possible output:
	, .   .

See also
	  wcsncat appends a certain amount of wide characters  from  one  wide
       string to another
		  (function)
	  strcat  concatenates two strings
		  (function)
	  wcscpy  copies one wide string to another
		  (function)

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

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

home | help