STRCCPY(3GEN) String Pattern-Matching Library Functions STRCCPY(3GEN)
NAME
strccpy, streadd, strcadd, strecpy - copy strings, compressing or
expanding escape codes
SYNOPSIS
cc [
flag ... ]
file ...
-lgen [
library ... ]
#include <libgen.h>
char *strccpy(
char *output,
const char *input);
char *strcadd(
char *output,
const char *input);
char *strecpy(
char *output,
const char *input,
const char *exceptions);
char *streadd(
char *output,
const char *input,
const char *exceptions);
DESCRIPTION
strccpy() copies the
input string, up to a null byte, to the
output string, compressing the C-language escape sequences (for example,
\n,
\001) to the equivalent character. A null byte is appended to the
output. The
output argument must point to a space big enough to
accommodate the result. If it is as big as the space pointed to by
input it is guaranteed to be big enough.
strccpy() returns the
output argument.
strcadd() is identical to
strccpy(), except that it returns the
pointer to the null byte that terminates the output.
strecpy() copies the
input string, up to a null byte, to the
output string, expanding non-graphic characters to their equivalent C-
language escape sequences (for example,
\n,
\001). The
output argument must point to a space big enough to accommodate the result;
four times the space pointed to by
input is guaranteed to be big
enough (each character could become
\ and 3 digits). Characters in
the
exceptions string are not expanded. The
exceptions argument may
be zero, meaning all non-graphic characters are expanded.
strecpy() returns the
output argument.
streadd() is identical to
strecpy(), except that it returns the
pointer to the null byte that terminates the output.
EXAMPLES
Example 1: Example of expanding and compressing escape codes.
/* expand all but newline and tab */
strecpy( output, input, "\n\t" );
/* concatenate and compress several strings */
cp = strcadd( output, input1 );
cp = strcadd( cp, input2 );
cp = strcadd( cp, input3 );
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | MT-Safe |
+---------------+-----------------+
SEE ALSO
string(3C),
strfind(3GEN),
attributes(7)NOTES
When compiling multi-thread applications, the
_REENTRANT flag must be
defined on the compile line. This flag should only be used in multi-
thread applications.
December 29, 1996 STRCCPY(3GEN)
