FILUM
File Utilities
FILUM
is a C library which
handles information in text files.
Licensing:
The computer code and data files described and made available on this web page
are distributed under
the GNU LGPL license.
Languages:
FILUM is available in
a C version and
a C++ version and
a FORTRAN90 version and
a MATLAB version and
a Python version.
Related Data and Programs:
C_FILES,
C programs which
illustrate the use of files.
CR2LF,
a C++ program which
reads a text file and replaces
carriage returns by line feeds.
CRRM,
a C++ program which
reads a text file and removes the
carriage return character.
DEBLANK,
a C++ program which
reads a text file and writes a copy which has no blank lines.
DECOMMENT,
a C++ program which
makes a copy of a text file which contains no "comment" lines
(that begin with "#").
FILE_NAME_SEQUENCE,
a C program which
demonstrates ways to generate a sequence of filenames
that can be used when generating images for an animation.
REFORMAT,
a FORTRAN90 program which
makes a copy of a file with a given number of "words" per line.
REWORD,
a C++ program which
reads a text file and writes a copy which has a fixed number
of "words" per line.
UNCONTROL,
a C++ program which
makes a copy of a text file which contains no control characters.
WRAP,
a C++ program which
makes a copy of a text file
in which no line is longer than a user-specified wrap length.
Reference:
-
Paul Bratley, Bennett Fox, Linus Schrage,
A Guide to Simulation,
Springer Verlag, pages 201-202, 1983.
-
Tom Christiansen, Nathan Torkington,
"8.6: Picking a Random Line from a File",
Perl Cookbook, pages 284-285,
O'Reilly, 1999.
-
Pierre L'Ecuyer,
Random Number Generation,
in Handbook of Simulation,
edited by Jerry Banks,
Wiley Interscience, page 95, 1998.
-
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.
-
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:
Examples and Tests:
-
filum_test.c, the calling program;
-
filum_test.txt,
the output file.
-
filum_4by5.txt, a file with
missing right parentheses.
-
filum.txt, a sample file.
-
filum_append.txt, an
example of FILE_APPEND.
-
filum_braces.txt, a file
with balanced and legal braces.
-
filum_columns.txt, a file
of 4 rows and 5 columns of numeric data.
-
filum_copy.txt, an example of
FILE_COPY.
-
filum_reverse_columns.txt,
an example of FILE_REVERSE_COLUMNS.
-
filum_parens1.txt, a file
with missing right parentheses.
-
filum_parens2.txt, a file
with illegally occurring right parentheses.
-
filum_parens3.txt, a file
with balanced and legal parentheses.
-
filum_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 (1) if two characters are equal, disregarding case.
-
CH_INDEX_LAST finds the last occurrence of a character in a string.
-
CH_IS_DIGIT returns TRUE if a character is a decimal digit.
-
CH_LOW lowercases a single character.
-
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 character representation of a decimal digit.
-
FILE_BYTE_COUNT counts the number of bytes in a file.
-
FILE_COLUMN_COUNT counts the number of columns in the first line of a file.
-
FILE_EXIST reports whether a file exists.
-
FILE_NAME_INC increments a partially numeric file name.
-
FILE_ROW_COUNT counts the number of row records in a file.
-
I4_MAX returns the maximum of two I4's.
-
I4_MIN returns the smaller of two I4's.
-
I4_UNIFORM returns a scaled pseudorandom I4.
-
R4_NINT returns the nearest integer to an R4.
-
R8_UNIFORM_01 returns a unit pseudorandom R8.
-
S_EQI reports whether two strings are equal, ignoring case.
-
S_LEN_TRIM returns the length of a string to the last nonblank.
-
S_LOW replaces all uppercase characters by lowercase ones.
-
S_REVERSE reverses the characters in a string.
-
S_TO_I4 reads an I4 from a string.
-
S_TO_I4VEC reads an I4VEC from a string.
-
S_TO_R8 reads an R8 value from a string.
-
S_TO_R8VEC reads an R8VEC from a string.
-
S_TO_ROT13 "rotates" the alphabetical characters in a string by 13 positions.
-
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.
Last revised on 04 February 2012.