BOOTSTRAP (kutils) functions


LIBRARY ROUTINE

kre_subs - substitute the matched portions of the src in dst

LIBRARY CALL

int kre_subs(
    char *src,
    char *dst)

INPUT

OUTPUT

RETURN VALUE

TRUE (1) on success, FALSE (0) otherwise

DESCRIPTION

Substitutes the matched portions of the source string in the in destination string.

'&' - substitute the entire matched pattern. '\\digit' - substitute a subpattern, with the given tag number. Tags are numbered from 1 to 127. If the particular tagged subpattern does not exist, null is substituted. Other symbols can be used to modify the substitution patterns:

\\Q..\\E - Ignore all special characters between the \\Q and \\E symbols \\l - Convert next character to lower case. \\L..\\E - Convert all text between \\L and \\E to lower case \\u - Convert next character to upper case. \\U..\\E - Convert all text between \\U and \\E to upper case

ADDITIONAL INFORMATION

none

EXAMPLES

none

SIDE EFFECTS

none

RESTRICTIONS

kre_exec must be called before this routine will do any substitutions.

MODIFICATION

Integrated into Khoros 2.0 (MY) 7/93

FILES

$BOOTSTRAP/objects/library/kutils/src/regex.c

SEE ALSO

kutils(3)

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.