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

FreeBSD Manual Pages

  
 
  

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

NAME
       std::strncat - std::strncat

Synopsis
	  Defined in header <cstring>
	  char *strncat( char *dest, const char	*src, std::size_t count	);

	  Appends  a byte string pointed to by src to a	byte string pointed to
       by dest.	At most
	  count	characters are copied. The resulting byte string is  null-ter-
       minated.

	  The  destination byte	string must have enough	space for the contents
       of both dest and
	  src plus the terminating null	character, except that the size	of src
       is limited to
	  count.

	  The behavior is undefined if the strings overlap.

Parameters
	  dest	- pointer to the null-terminated byte string to	append to
	  src	- pointer to the null-terminated byte string to	copy from
	  count	- maximum number of characters to copy

Return value
	  dest

Notes
	  Because strncat needs	to seek	to the end of dest on each call, it is
       inefficient to
	  concatenate many strings into	one using strncat.

Example
       // Run this code

	#include <cstring>
	#include <cstdio>

	int main()
	{
	    char str[50] = "Hello ";
	    char str2[50] = "World!";
	    std::strcat(str, str2);
	    std::strncat(str, "	Goodbye	World!", 3);
	    std::puts(str);
	}

Output:
	Hello World! Go

See also
	  strcat concatenates two strings
		 (function)
	  strcpy copies	one string to another
		 (function)

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

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

home | help