plucky (3) strmaxcpy.3pub.gz

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)