NAME    [Toc]    [Back]

       copystr  -  General:  Copies  a  null-terminated character
       string with a specified limit

SYNOPSIS    [Toc]    [Back]

       int copystr(
               char *s1,
               char *s2,
               u_int maxlength,
               u_int *ncopiedaddr );

ARGUMENTS    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       Routines: bcopy(9r), blkclr(9r), ovbcopy(9r),  strcpy(9r),
       strncpy(9r)



                                                      copystr(9r)