copystr(9r)															       copystr(9r)

NAME

       copystr - 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.  Specifies the address of an integer to receive  the	number	of
       copied characters.

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). Otherwise, 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)