strccpy(3G)							   strccpy(3G)

NAME    [Toc]    [Back]

     strccpy: streadd, strcadd,	strecpy	- copy strings,	compressing or
     expanding escape codes

SYNOPSIS    [Toc]    [Back]

     cc	[flag ...] file	...  -lgen [library ...]

     #include <libgen.h>

     char *strccpy (char *output<b>, const	char *input<b>);

     char *strcadd (char *output<b>, const	char *input<b>);

     char *strecpy (char *output<b>, const	char *input<b>, const char
	 *exceptions<b>);

     char *streadd (char *output<b>, const	char *input<b>, const char
	 *exceptions<b>);

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]

     /*	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






strccpy(3G)							   strccpy(3G)

SEE ALSO    [Toc]    [Back]

     string(3C), str(3G)


									PPPPaaaaggggeeee 2222