Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
STRMAXCPY(3)		     C Programmer's Manual		  STRMAXCPY(3)

NAME
       strmaxcpy - copy	at most	a given	number of characters of	string

SYNOPSIS
       #include	<publib.h>
       char *strmaxcpy(char *tgt, const	char *src, size_t n);

DESCRIPTION
       strmaxcpy copies	up to n-1 characters from the beginning	of src to tgt,
       then adds a '\0'.  n must be at least 1.	 The  target  string  must  be
       large enough to hold the	result.

       Note that unlike	strncpy(3), this function always terminates the	result
       with '\0'.  It also doesn't fill	the result with	extra '\0' characters.

RETURN VALUE
       strmaxcpy returns its first argument.

EXAMPLE
       To print	out the	first 69 characters of a string, you might do the fol-
       lowing  (although familiarity with printf's format string might be more
       useful in this case).

	    #include <stdio.h>
	    #include <publib.h>

	    void print42(const char *string) {
		 char copy[43];	/* 42 +	'\0' */

		 puts(strmaxcpy(copy, string, sizeof(copy)));
	    }

SEE ALSO
       publib(3), strncpy(3)

AUTHOR
       Lars Wirzenius (lars.wirzenius@helsinki.fi)

Publib			     C Programmer's Manual		  STRMAXCPY(3)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | EXAMPLE | SEE ALSO | AUTHOR

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=strmaxcpy&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help