status.i4.v = str_is_white_space_c(string.i1a.r [,length.i4.v])

	This routine determines whether or not the passed string is comprised
	entirely of white space characters.  Characters will be checked up
	to the length specified or until the first null character whichever
	comes first.

	string		string to check
	[length]	length of string (If a value of zero is passed
			or this argument is defaulted, the length of the
			string will be calculated.)
			(default is 0)

	This function returns status values as follows:

	TRUE			string is blank
	FALSE			string is not blank

	This function requires the following include files:

	cnsparam_h, cbslib_h

	Related functions:

	str_is_blank_c, str_num_nonblank_c, str_compare_nocase,
	str_compare_n_nocase_c, strncmp, strcmp, strncmx, str_find_first_c,
	str_is_alphabetic_c, str_is_alphanumeric_c, str_is_filled_with_char_c,
	str_is_lower_case_c, str_is_numeric_c, str_is_float_string_c,
	str_is_hex_c, str_is_printable_c, str_is_upper_case_c, str_get_first_c

	C/C++ usage:

	static const char	string[] = "  not blank  ";
	int	status;
	int	length = 0;

	status = str_is_white_space_c(string,length);