str_translate_characters_c

	num_replaced.i4.v = str_translate_characters_c(string.i1a.r,
						       length.i4.v,
						       translate_chars.i1a.r,
						       [,num_translate.i4.v]
						       [,translate_offset.i4.v]
						       [,options.u4.v])

	This routine replaces characters in a string based upon a
	translation array.

	string		 string to perform character replacements in
	length		 length of string (If a value of zero is passed,
			 the length of the string will be calculated.)
	translate_chars	 translation character array (up to 256 elements)
			 (If an entry has a value of 0, any corresponding
			  character in the original string will not be
			  changed.)
	num_translate	 number of entries in the translation array
	translate_offset offset to the start of the translation character array
			 (default is 0)
	[options]	 use options
			 (STR_OPT_NONE -> no options selected (default),
			  STR_OPT_HANDLE_QUOTES -> preserve characters in
						   quoted substrings)

	This function returns status values as follows:

	number of characters replaced

	This function requires the following include files:

	cbslib_h

	Related functions:

	str_replace_character_set_c, str_replace_char_set_c,
	str_replace_characters_with_string_c,
	str_replace_characters_with_strings_c, str_replace_char_c,
	str_replace_character_c, str_find_character_c, str_find_character_set_c,
	str_replace_string_c, str_replace_bracketed_c, str_find_string_c,
	str_find_last_string_c, str_character_count_c, str_expand_tabs_c,
	str_make_printable_c, str_find_not_in_character_set_c

	C/C++ usage:

	static char	string[] = "\tstring\n";
	static const char	translate_chars[] =
	{0, 1, 2, 3, 4, 5, 6, 7, 8, ' ', ' '};
	int	num_replaced;
	int	length = 0;
	int	num_translate = NUM_TRANSLATE;
	int	translate_offset = 0;
	unsigned int	options = STR_OPT_NONE;

	num_replaced = str_translate_characters_c(string,length,translate_chars,
						  num_translate,
						  translate_offset,options);