str_is_binary_string_c

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

	This routine determines whether or not the passed string is an
	ASCII representation of a binary 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_PREFIX -> allow a prefix of "0b",
			 STR_OPT_HANDLE_SUFFIX -> allow a valid integer
						  suffix/modifier)
	[int_length]	returned length of the binary integer string
			(excluding any white space)
			(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 binary integer value    
	FALSE			string does not represent a valid
				binary integer value

	This function requires the following include files:

	cnsparam_h, cbslib_h

	Related functions:

	str_is_integer_string_c, str_is_hex_c, str_is_octal_string_c,
	str_is_numeric_c, str_is_float_string_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[] = " 1011 ";
	int	status;
	int	length = 0;
	int	int_length;
	int	modifier_type;
	unsigned int	options = STR_OPT_NONE;

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