file_name_parse_c

	status.i4.v = file_name_parse_c(source_string.i1a.r,
					source_length.i4.v,
					path_string.i1a.r,
					max_path_length.i4.v,
					file_string.i1a.r,
					max_file_length.i4.v,
					ext_string.i1a.r,
					max_ext_length.i4.v, options.u4.v
					[path_type.i4.r])

	This routine will parse a file name into its component pieces.

	source_string	file name string to parse
	source_length	length of file name string (a value of zero
			will result in this routine determining
			the length of the string)
	path_string	returned null terminated path string
			(A value of NULL can be passed for this argument
			 if the path string is not needed.)
	max_path_length	maximum length of path string to return
	file_string	returned null terminated file string without extension
			(A value of NULL can be passed for this argument
			 if the file string is not needed.)
	max_file_length	maximum length of file string to return
	ext_string	returned null terminated extension string
			(A value of NULL can be passed for this argument
			 if the extension string is not needed.)
	max_ext_length	maximum length of extension string to return
	options		parsing options
			(FILE_PARSE_OPT_NONE -> no options selected,
			 FILE_PARSE_OPT_WHOLE_NAME -> return entire file name
						      including extension,
			 FILE_PARSE_OPT_NATIVE_FILES_ONLY -> only parse file
							     names that are in
							     native format)
	[path_type]	returned type of file path
			(FILE_PATH_NONE -> no file path found,
			 FILE_PATH_RELATIVE -> relative file path found,
			 FILE_PATH_ABSOLUTE -> absolute file path found)
			(default is NULL)

	This function returns ACNET status values as follows:

	OK			success
	CLIB_INVARG		invalid length

	This function requires the following include files:

	cbslib_h, acnet_errors_h

	Related functions:

	file_view_find, file_name_expand_c, file_name_convert_c,
	file_exists_c, file_find_in_path_c, str_find_character_c,
	file_num_lines, file_view_read, file_view_select

	C/C++ usage:

	static const char	source_string[] = "/usr/local/userb/pic/capture/image.gif";
	char	path_string[MAX_PATH+1];
	char	file_string[MAX_FILE+1];
	char	ext_string[MAX_EXT+1];
	int	status;
	int	max_path_length = MAX_PATH;
	int	max_file_length = MAX_FILE;
	int	max_ext_length = MAX_EXT;
	int	path_type;
	unsigned int	options = FILE_PARSE_OPT_NONE;

	status = file_name_parse_c(source_string,source_length,
				   path_string,max_path_length,
				   file_string,max_file_length,
				   ext_string,max_ext_length,options,
				   &path_type);