strncpy


function
<cstring>
char * strncpy ( char * destination, const char * source, size_t num );

Copy characters from string

Copies the first num characters of source to destination. If the end of the source C string (which is signaled by a null-character) is found before num characters have been copied, destination is padded with zeros until a total of num characters have been written to it.

No null-character is implicitly appended to the end of destination, so destination will only be null-terminated if the length of the C string in source is less than num.

Parameters

destination
Pointer to the destination array where the content is to be copied.
source
C string to be copied.
num
Maximum number of characters to be copied from source.


Return Value

destination is returned.

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
 
/* strncpy example */
#include <stdio.h>
#include <string.h>

int main ()
{
  char str1[]= "To be or not to be";
  char str2[6];
  strncpy (str2,str1,5);
  str2[5]='\0';
  puts (str2);
  return 0;
}


Output:

To be


See also

strcpy Copy string (function)
memcpy Copy block of memory (function)
memmove Move block of memory (function)
memchr Locate character in block of memory (function)
memcmp Compare two blocks of memory (function)
memset Fill block of memory (function)