str_pad_c

	status.i4.v = str_pad_c(padded_string.i1a.r, string.i1a.r,
				pad_type.i4.v, length.i4.v, pad_char.i1.v,
				num_padding.i4.v [,options.u4.v])

	This routine will insert padding characters in the beginning or
	end of strings.

	padded_string	returned null terminated padded string
			(Note: This argument may point to the original string.)
	string		string to pad
	pad_type	type of padding requested
			(STR_PAD_REPLACE_BEGIN -> replace spaces in the
						  beginning of the string,
			 STR_PAD_REPLACE_END -> replace spaces at the end of
						the string,
			 STR_PAD_REPLACE_BOTH -> replace spaces at the beginning
						 and the end of the string)
			 STR_PAD_BEGIN -> insert padding characters in the
					  beginning of the string,
			 STR_PAD_END -> insert padding characters at the end of
					the string,
			 STR_PAD_BOTH -> insert padding characters at the
					 beginning and the end of the string)
	length		length of string (If a value of zero is passed,
			the length of the string will be calculated.)
	pad_char	padding character
	num_padding	number of padding characters (A value of 0 indicates
			that all characters should be padded.)
	[options]	use options
			(STR_OPT_NONE -> no options selected (default),
			 STR_OPT_INHIBIT_NULL_TERMINATOR -> don't null
							    terminate the
							    string)

	This function returns ACNET status values as follows:

	OK			success
	CLIB_INVARG		invalid length, pad type, or number of
				padding characters
	CLIB_MEMFAIL		dynamic memory allocation failure

	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	str_trim_c, str_trim_characters_c, str_justify_c,
	str_insert_terminator_c, str_shift_c, str_find_first_c,
	str_get_first_c

	C/C++ usage:

	static const char	string[] = "   string   ";
	char	padded_string[32];
	char	pad_char = '.';
	int	status;
	int	pad_type = STR_PAD_BOTH;
	int	length = 0;
	int	num_padding = 0;
	unsigned int	options = STR_OPT_NONE;

	status = str_pad_c(padded_string,string,pad_type,length,pad_char,
			   num_padding,options);