acl_file_stats_c
status.i4.v = acl_file_stats_c(file_name.i1a.r, file_type.i4.v,
num_lines.u4.r, total_chars.u4.r,
longest_length.i4.r, longest_line.i4.r,
[,options.u4.v])
This routine returns the statistics concerning an
Accelerator Command Language (ACL) script file.
A value of NULL can be passed for any of the returned
arguments whose values are not needed.
file_name null terminated file name
file_type type of file
(ACL_FLAT_FILE -> ASCII text file,
ACL_DB_FILE -> "file_name" should be the database
table name from ACL_DB_TABLE)
num_lines returned number of lines
total_chars returned total number of characters
longest_length returned longest line length
longest_line returned line number of the longest line
[options] read options
(ACL_OPT_NONE -> no options selected,
ACL_OPT_DONT_CLOSE -> leave database connection
open upon exit (close later
with 'db_close'))
This function returns ACNET status values as follows:
CLIB_OK success
CLIB_MEMFAIL failed in allocating dynamic memory
CLIB_NOTOPN failed to open file
CLIB_INVSIZ command line too long
otherwise other ACNET format error code
This function requires the following include files:
cbslib_h, acnet_errors.h
Related functions:
intro_acl, acl_file_read_c, acl_file_write_c, acl_file_execute,
acl_execute_c, acl_compile_c, acl_free_c, acl_read_symbol_c,
acl_read_symbol_info_c, acl_read_symbol_names, acl_delete_symbol,
acl_info_c, acl_cancel_requests_c, acl_set_symbol_c,
acl_default_data_source_c, acl_log_file_c, acl_default_script_path_c,
db_close, acl_script_is_executing, acl_register_host_request_func,
acl_unregister_host_request_func, acl_translate_command_string
C usage:
static const char file_name[] = "acl_file.acl";
int status;
int file_type = ACL_FLAT_FILE;
int longest_length;
int longest_line_number;
unsigned int num_lines;
unsigned int total_chars;
unsigned int options = ACL_OPT_NONE;
status = acl_file_stats_c(file_name,file_type,&num_lines,&total_chars,
&longest_length,&longest_line_number,options);