DragonFly On-Line Manual Pages

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