str_replace

	state.i4.v = str_replace(modify_string.i1a.r)

	This is a function provided for the programmer that will modify a
	candidate string on behalf of the change routine.  (Note: It should
	only be used within the context of find_change.)
	
	When called from the change routine, the passed candidate string will
	be modified if appropriate.  This function returns TRUE if the
	string replacement was successful.

	modify_string	string to modified

	This function returns status values as follows:

	TRUE			string was modified
	FALSE			string was not modified

	This function requires the following include files:

	cnsparam_h, cbslib_h

	Related functions:

	find_change, str_wmatch_search