strsub(3pub) [debian man page]

STRSUB(3pub)						       C Programmer's Manual						      STRSUB(3pub)

NAME

       strsub - substitute first occurence of pattern with another string

SYNOPSIS

       #include <publib.h>
       char *strsub(char *str, const char *pat, const char *sub);

DESCRIPTION

       strsub  finds the first occurence of the pattern pat in the string str (using a method similar to strstr(3), i.e., no regular expressions),
       and replaces it with sub.  If pat does not occur in str, no substitution is made.

       Of course, if sub is an empty string, the pattern is deleted from the string.

RETURN VALUE

       strsub returns a pointer to the first character after the substitution, or NULL if no substitution was made.

EXAMPLE

       To substitute up to two occurences of "foo" with "bar" in a line, one might do the following.

	    p = strsub(line, "foo", "bar");
	    if (p != NULL)
		 strsub(line, "foo", "bar");

SEE ALSO

       publib(3), strstr(3), strgsub(3)

AUTHOR

       Lars Wirzenius (lars.wirzenius@helsinki.fi)

Publib							       C Programmer's Manual						      STRSUB(3pub)

STRACAT(3pub)						       C Programmer's Manual						     STRACAT(3pub)

NAME

       stracat - concatenate many strings into an allocated memory block

SYNOPSIS

       #include <publib.h>
       char *stracat(const char *s, ...);

DESCRIPTION

       stracat	will  allocate	a block of memory with malloc and concatenate all arguments strings into this block.  The user is supposed to free
       the returned block.  The end of the argument list is signalled by a null pointer.

RETURN VALUE

       stracat returns a pointer to the allocated block, or NULL if it could not be allocated.

EXAMPLE

       To concatenate "hello, " and "world", one might say the following.

	    p = stracat("hello, ", "world", (char *)NULL);
	    if (p != NULL)
		 puts(p);

       Please note that it is necessary to case NULL as in the example above,
       since there is no information about the type of the argument available
       in the prototype, and since an unadorned NULL might not be of the
       correct type.  (See any good C reference book or the comp.lang.c FAQ for
       more information.)

SEE ALSO

       publib(3), strcat(3)

AUTHOR

       Lars Wirzenius (lars.wirzenius@helsinki.fi)

Publib							       C Programmer's Manual						     STRACAT(3pub)