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, 
,
       01) to the equivalent character.  A null byte is appended to the output. The output argument must point to a space big enough to accommo-
       date 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, 
, 01).  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, "
	" );

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

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |MT-Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       string(3C), strfind(3GEN), attributes(5)

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.

SunOS 5.10							    29 Dec 1996 						     strccpy(3GEN)