copystr(9r)copystr(9r)NAMEcopystr - General: Copies a null-terminated character string with a
specified limit
SYNOPSIS
int copystr(
char *s1,
char *s2,
u_int maxlength,
u_int *ncopiedaddr );
ARGUMENTS
Specifies a pointer to a string (an array of characters terminated by a
null character). Specifies a pointer to a buffer of at least maxlength
characters. Specifies the maximum number of characters to copy. Spec‐
ifies the address of an integer to receive the number of copied charac‐
ters.
DESCRIPTION
The copystr routine copies string s1 to the buffer pointed to by s2.
The routine stops after copying a null character or after copying
maxlength characters, whichever comes first. The s2 buffer is not
padded with null characters to maxlength.
The copystr routine returns the number of characters copied in the
location pointed to by ncopiedaddr. Note that the character size is 1
byte.
RETURN VALUES
Upon successful completion, copystr returns the value 0 (zero). Other‐
wise, it can return the following error: The string length, s1, exceeds
the maximum number of characters, maxlength.
SEE ALSO
Routines: bcopy(9r), blkclr(9r), ovbcopy(9r), strcpy(9r), strncpy(9r)copystr(9r)