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

FreeBSD Manual Pages

  
 
  

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

NAME
       std::strcat - std::strcat

Synopsis
	  Defined in header <cstring>
	  char *strcat(	char *dest, const char *src );

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

	  The  behavior	 is  undefined	if  the	destination array is not large
       enough for the
	  contents of both src and dest	and the	terminating null character.

	  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

Return value
	  dest

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

Example
       // Run this code

	#include <cstring>
	#include <cstdio>

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

Output:
	Hello World! Goodbye World!

See also
	  strncat concatenates a certain amount	of characters of two strings
		  (function)
	  strcpy  copies one string to another
		  (function)

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

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

home | help