strccpy(3X)                                           strccpy(3X)



NAME
     strccpy, strcadd, strecpy, streadd - copy strings, compress-
     ing 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
     /* 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 );




Page 1                        CX/UX Programmer's Reference Manual

strccpy(3X)                                           strccpy(3X)



SEE ALSO
     string(3C), strfind(3X).





















































Page 2                        CX/UX Programmer's Reference Manual