FILUM
File Utilities

FILUM is a set of C++ routines for working with information in text files.

Related Data and Programs:

CR2LF is an executable C++ program which reads a text file and replaces carriage returns by line feeds.

CRRM is an executable C++ program which reads a text file and removes the carriage return character.

DEBLANK is a C++ executable program which reads a text file and writes a copy which has no blank lines.

DECOMMENT is a C++ executable program which makes a copy of a text file which contains no "comment" lines (that begin with "#").

FILUM is also available in a FORTRAN90 version, a Mathematica version and a MATLAB version.

REFORMAT is a FORTRAN90 executable program which makes a copy of a file with a given number of "words" per line.

REWORD is a C++ executable program which reads a text file and writes a copy which has a fixed number of "words" per line.

UNCONTROL is a C++ executable program which makes a copy of a text file which contains no control characters.

WRAP is a C++ executable program which makes a copy of a text file in which no line is longer than a user-specified wrap length.

Reference:

1. Paul Bratley, Bennett Fox, Linus Schrage,
   A Guide to Simulation,
   Springer Verlag, pages 201-202, 1983.
2. Tom Christiansen, Nathan Torkington,
   "8.6: Picking a Random Line from a File",
   Perl Cookbook, pages 284-285,
   O'Reilly, 1999.
3. Pierre L'Ecuyer,
   Random Number Generation,
   in Handbook of Simulation,
   edited by Jerry Banks,
   Wiley Interscience, page 95, 1998.
4. Bennett Fox,
   Algorithm 647: Implementation and Relative Efficiency of Quasirandom Sequence Generators,
   ACM Transactions on Mathematical Software,
   Volume 12, Number 4, pages 362-376, 1986.
5. Philip Lewis, Allen Goodman, James Miller,
   A Pseudo-Random Number Generator for the System/360,
   IBM Systems Journal,
   Volume 8, pages 136-143, 1969.

Source Code:

• filum.C, the source code;
• filum.H, the include file;
• filum.csh, commands to compile the source code;

Examples and Tests:

• filum_prb.C, the calling program;
• filum_prb.csh, commands to compile, link and run the calling program;
• filum_prb.out, the sample output.
• filum_prb_4by5.txt, a file with missing right parentheses.
• filum_prb_test.txt, a sample file.
• filum_prb_append.txt, an example of FILE_APPEND.
• filum_prb_braces.txt, a file with balanced and legal braces.
• filum_prb_columns.txt, a file of 4 rows and 5 columns of numeric data.
• filum_prb_copy.txt, an example of FILE_COPY.
• filum_prb_reverse_columns.txt, an example of FILE_REVERSE_COLUMNS.
• filum_prb_parens1.txt, a file with missing right parentheses.
• filum_prb_parens2.txt, a file with illegally occurring right parentheses.
• filum_prb_parens3.txt, a file with balanced and legal parentheses.
• filum_prb_reverse_rows.txt, an example of FILE_REVERSE_ROWS.
• story.txt, a file containing a title line and 5 paragraphs of text.

List of Routines:

• CH_CAP capitalizes a single character.
• CH_EQI is true if two characters are equal, disregarding case.
• CH_IS_DIGIT returns TRUE if a character is a decimal digit.
• CH_LOW lowercases a single character.
• CH_SWAP swaps two characters.
• CH_TO_DIGIT returns the integer value of a base 10 digit.
• CH_TO_ROT13 converts a character to its ROT13 equivalent.
• DIGIT_INC increments a decimal digit.
• DIGIT_TO_CH returns the base 10 digit character corresponding to a digit.
• FILE_CHAR_COUNT counts the number of characters in a file.
• FILE_COLUMN_COUNT counts the columns in the first line of a file.
• FILE_DELETE deletes a named file if it exists.
• FILE_EXIST reports whether a file exists.
• FILE_LINE_UNIFORM returns a random line from a file.
• FILE_NAME_DEC decrements a partially numeric file name.
• FILE_NAME_EXT_GET determines the "extension" of a file name.
• FILE_NAME_EXT_SWAP replaces the current "extension" of a file name.
• FILE_NAME_INC increments a partially numeric file name.
• FILE_PARA_COUNT counts the number of paragraphs in a file.
• FILE_ROW_COUNT counts the number of row records in a file.
• FILE_WORD_COUNT counts the number of words in a file.
• I4_MAX returns the maximum of two integers.
• I4_MIN returns the smaller of two integers.
• I4_UNIFORM returns a scaled pseudorandom I4.
• NUMBER_INC increments the integer represented by a string.
• R4_ABS returns the absolute value of an R4.
• R4_NINT returns the nearest integer to an R4.
• R8_NINT returns the nearest integer to an R8.
• R8_UNIFORM_01 returns a unit pseudorandom R8.
• S_EQI reports whether two strings are equal, ignoring case.
• S_INDEX_LAST_C returns a pointer to the last occurrence of a given character.
• S_LEN_TRIM returns the length of a string to the last nonblank.
• S_LOW lowercases a string.
• S_REVERSE reverses the characters in a string.
• S_TO_R8 reads an R8 from a string.
• S_TO_R8VEC reads an R8VEC from a string.
• S_TO_I4 reads an I4 from a string.
• S_WORD_COUNT counts the number of "words" in a string.
• TIMESTAMP prints the current YMDHMS date as a time stamp.

You can go up one level to the C++ source codes.