file2array is a Perl module which reads the contents of a file and stores it in
an array. Each line of the file becomes one element of the array.

Copyright (c) 2018 Tim Chadburn.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the file "fdl.txt" which is part of this
package.

file2array is a Perl module which reads the contents of a file and stores it in
an array. Each line of the file becomes one element of the array.

file2array is called like this:

file2array(FILE)

An example call would be:

file2array("textfile.txt")

Supposing the file had the following contents:

this is line one
this is line two
this is line three

the first element of the resulting array would be the string "this is line one",
and so on.