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

FreeBSD Manual Pages

  
 
  

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

NAME
       std::wcsncat - std::wcsncat

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

	  Appends at most count	wide characters	from the wide  string  pointed
       to by src to the
	  end of the character string pointed to by dest, stopping if the null
       terminator is
	  copied.  The	wide  character	src[0] replaces	the null terminator at
       the end of dest.
	  The null terminator is always	appended in the	end  (so  the  maximum
       number of wide
	  characters the function may write is count+1).

	  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
	  count	- maximum number of wide characters to copy

Return value
	  dest

Example
       // Run this code

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

	int main(void)
	{
	    wchar_t str[50] = L", .";
	    std::wcsncat(str, L" ", 1);
	    std::wcsncat(str,  L"   .",	 8);  //  only append the first	8 wide
       chars

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

Possible output:
	, .

See also
	  wcscat  appends a copy of one	wide string to another
		  (function)
	  strncat concatenates a certain amount	of characters of two strings
		  (function)
	  wcscpy  copies one wide string to another
		  (function)

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

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

home | help