Index for Section 9r

Alphabetical listing for C

Bottom of page

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
  s1  Specifies a pointer to a string (an array of characters terminated by a
      null character).

  s2  Specifies a pointer to a buffer of at least maxlength characters.

  maxlength
      Specifies the maximum number of characters to copy.

  ncopiedaddr
      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:

  ENAMETOOLONG
      The string length, s1, exceeds the maximum number of characters,
      maxlength.

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

Index for Section 9r

Alphabetical listing for C

Top of page