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