str_is_integer_string_c

	status.i4.v = str_is_integer_string_c(string.i1a.r, length.i4.v
					      [,options.u4.v]
					      [,int_length.i4.r]
					      [,is_negative.i4.r]
					      [,modifier_type.i4.r])

	This routine determines whether or not the passed string is an
	ASCII representation of a decimal integer value.  The integer
	value can be preceded and followed by white space.

	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.)
	[options]	parsing options
			(STR_OPT_NONE -> no options selected (default),
			 STR_OPT_HANDLE_SUFFIX -> allow a valid integer
						  suffix/modifier)
	[int_length]	returned length of the integer string (excluding
			any white space)
			(default is NULL)
	[is_negative]	returned flag indicating whether or not the string
			indicates a negative value
			(TRUE -> is negative value string,
			 FALSE -> is a positive value string)
			(default is NULL)
	[modifier_type]	returned modifier type
			(STR_INT_MOD_TYPE_NONE -> no integer modifier,
			 STR_INT_MOD_TYPE_BYTE -> signed byte modifier,
			 STR_INT_MOD_TYPE_UBYTE	-> unsigned byte modifier,
			 STR_INT_MOD_TYPE_SHORT -> signed short modifier,
			 STR_INT_MOD_TYPE_USHORT -> unsigned short modifier,
			 STR_INT_MOD_TYPE_LONG -> signed long modifier,
			 STR_INT_MOD_TYPE_ULONG -> unsigned long modifier,
			 STR_INT_MOD_TYPE_LONG_LONG -> signed long long
						       modifier,
			 STR_INT_MOD_TYPE_ULONG_LONG -> unsigned long long
							modifier)

	This function returns status values as follows:

	TRUE			string represents a valid integer value    
	FALSE			string does not represent a valid integer value

	This function requires the following include files:

	cnsparam_h, cbslib_h

	Related functions:

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

	C/C++ usage:

	static const char	string[] = " 1234 ";
	int	status;
	int	length = 0;
	int	int_length;
	int	is_negative;
	int	modifier_type;
	unsigned int	options = STR_OPT_NONE;

	status = str_is_integer_string_c(string,length,options,&int_length,
					 &is_negative,&modifier_type);