strccpy(3G)                                                     strccpy(3G)

NAME
     strccpy, streadd, strcadd, strecpy - copy strings

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 out-
     put. The output argument must point to a memory space big enough to
     accommodate the result. If it is as big as the memory space pointed to
     by input it is guaranteed to be big enough. strccpy() returns the out-
     put 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 memory space big enough to accommodate the result;
     four times the memory 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
     NULL, 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

     /* concatenate and compress several strings */
     cp = strcadd( output, input1 );
     cp = strcadd( cp, input2 );
     cp = strcadd( cp, input3 );

SEE ALSO
     string(3C), str(3G).



Page 1                       Reliant UNIX 5.44                Printed 11/98