DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 
SVR5

strncpy(D3)


strncpy -- copy a string using a specified number of characters

Synopsis

   #include <sys/types.h>
   #include <sys/ddi.h>
   

char *strncpy (char *sptr1, const char *sptr2, size_t nchr)

Arguments

The arguments sptr1 and sptr2 each point to strings, and each string is an array of characters terminated by a null-character unless the length of sptr2 is nchr or more.

Description

The function strncpy copies at most nchr characters from the string pointed to by sptr2 into the string pointed to by sptr1. If a null-character is reached in sptr2 before nchr characters have been copied, strncpy fills in the rest of the nchr characters of sptr1 with null-characters. The result is not null-terminated if the length of sptr2 is nchr or more.

The function strncpy alters sptr1 without checking for overflow of the array pointed to by sptr1. If copying takes place between strings that overlap, the behavior is undefined.

Return values

The function strcmp returns the value of sptr1, which points to a string of nchr characters in length.

Usage

Character movement is performed differently in different implementations; thus, overlapping moves may yield surprises.

Context and synchronization

All contexts.

Hardware applicability

All

Version applicability

ddi: 5, 5mp, 6, 6mp, 7, 7mp, 7.1, 7.1mp, 8, 8mp

References

bcmp(D3), bcopy(D3), strcpy(D3), strlen(D3)
19 June 2005
© 2005 The SCO Group, Inc. All rights reserved.
OpenServer 6 and UnixWare (SVR5) HDK - June 2005