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-termi-
     nated.

	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  std::strncat  needs to seek to the end of dest on each call, it
     is
	inefficient to concatenate many strings into one using std::strncat.

Example
     // Run this code

      #include <cstdio>
      #include <cstring>

      int main()
      {
	  char str[50] = "Hello ";
	  const char str2[50] = "World!";
	  std::strcat(str, str2);
	  std::strncat(str, " Goodbye World!", 3); // may issue "truncated  out-
     put" warning
	  std::puts(str);
      }

Output:
      Hello World! Go

See also
	strcat concatenates two strings
	       (function)
	strcpy copies one string to another
	       (function)
	C documentation for
	strncat

http://cppreference.com 	   2024.06.10			 std::strncat(3)
home | help