|
|
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)