|
|
|
|
| Function | ld_ascii_data_file |
| Include file | GEN_UTL.H |
| Prototype | void ld_ascii_data_file( char *file_name , FPTR process_routine , BOOL echo_flag ) |
| Remarks | Load a ASCII file and call a process routine for each line of the file. Set echo_flag to TRUE to get a debug dump to scr. If the process routine wants to know where it is it should IMPORT and reference ASCII_line_num. The process routine should expect one parameter, a char *. Lines beginning with a COMMENT_CHAR (currently defined as "#") will not to sent to the process_routine. |
| Function | dot_tty |
| Include file | GEN_UTL.H |
| Prototype | void dot_tty( void ) |
| Remarks | Just a QND to dump a . to the tube so the user doesn't think that the program has died. |
| Function | time_stamp |
| Include file | GEN_UTL.H |
| Prototype | char *time_stamp( void ) |
| Remarks | Get current full 26 character long date & time str from asctime. |
| Function | my_calloc |
| Include file | GEN_UTL.H |
| Prototype | void *my_calloc( UINT bytes_needed ) |
| Remarks | A wrapped version of calloc, out of memory is handled as a fatal. |
| Function | my_farcalloc |
| Include file | GEN_UTL.H |
| Prototype | void far *my_farcalloc( ULONG bytes_needed ) |
| Remarks | A wrapped version of farcalloc, out of memory is handled as a fatal. |
| Function | chk_4_file |
| Include file | GEN_UTL.H |
| Prototype | int chk_4_file( char *target_file ) |
| Remarks | Check 4 user requested file, return TRUE if found, target_file may include drive and directory path info. |
| Function | my_unlink |
| Include file | GEN_UTL.H |
| Prototype | void my_unlink( char *file_name ) |
| Remarks | A wrapped version of unlink. Will jump to local_exit() unless GLOBAL var return_from_lib_error == TRUE. |
| Function | init_ran |
| Include file | GEN_UTL.H |
| Prototype | void init_ran( void ) |
| Remarks | This routine is used to generate a random seed for init-ing srand(), then it calls rand() a random number of times. After calling this routine you can count on be in a random location in the pseudorandom number sequence generated by rand(). |
| Function | random_int |
| Include file | GEN_UTL.H |
| Prototype | int random_int( int max_integer ) |
| Remarks | Return a random_int in the range of 0 to max_integer. |
