STRMAXCPY(3pub) C Programmer's Manual STRMAXCPY(3pub)
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 ' '. 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 ' '. It also doesn't fill the result with extra ' ' charac-
ters.
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 + ' ' */
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(3pub)
