strcadd(3gen) [sunos man page]

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)

Check Out this Related Man Page

strfind(3GEN)					     String Pattern-Matching Library Functions					     strfind(3GEN)

NAME

       strfind, strrspn, strtrns, str - string manipulations

SYNOPSIS

       cc [ flag ... ] file ... -lgen [ library ... ]
       #include <libgen.h>

       int strfind(const char *as1, const char *as2);

       char *strrspn(const char *string, const char *tc);

       char * strtrns(const char *string, const char *old, const char *new,
	    char *result);

DESCRIPTION

       The  strfind()  function  returns the offset of the first occurrence of the second string,  as2, if it is a substring of string as1. If the
       second string is not a substring of the first string strfind() returns  -1.

       The strrspn() function trims chartacters from a string. It searches from the end of string for the first character that is not contained in
       tc. If such a character is found, strrspn() returns a pointer to the next character; otherwise, it returns a pointer to string.

	The  strtrns()	function transforms  string and copies it into	result. Any character  that appears in	old is replaced with the character
       in the same position in	new. The  new result is returned.

USAGE

       When compiling multithreaded applications, the _REENTRANT flag must be defined on the compile line.  This flag should only be used in  mul-
       tithreaded applications.

EXAMPLES

       Example 1 An example of the strfind() function.

	 /* find offset to substring "hello" within as1 */
	 i = strfind(as1, "hello");
	 /* trim junk from end of string */
	 s2 = strrspn(s1, "*?#$%");
	 *s2 = '';
	 /* transform lower case to upper case */
	 a1[] = "abcdefghijklmnopqrstuvwxyz";
	 a2[] = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";
	 s2 = strtrns(s1, a1, a2, s2);

ATTRIBUTES

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

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

SEE ALSO

       string(3C), attributes(5)

SunOS 5.11							    20 Jan 1999 						     strfind(3GEN)

Linux and UNIX Man Pages

strcadd(3gen) [sunos man page]

Check Out this Related Man Page