CARDREAD Version 1.4
COPYRIGHT (C) 1994-2002 Norbert H. Doerry
28 May 2002
doerry@aol.com
SYNTAX:
CARDREAD file.crd -w## -r"##" -f"##" -l## -? -p"##" -oFILE -s##
Description:
CARDREAD enables one to view the contents of a CARDFILE
file generated under Windows 3.1 from within DOS. The CARDFILE
must contain only "text" cards. The following command line
options are available
-w## Set the number of characters before line wrapping to ##.
The default value is 40, which corresponds to the width
of the Windows card.
-r"##" Set the string to delimit records (cards) to ##. The
default value is "\n\n---------------------------\n"
-f"##" Set the string to delimit fields (or lines) to ##. The
default value is "\n"
-l## Set the maximum number of lines per page for printing
records (cards) to ## lines. This number should not
include margins. If set <= 0, page breaks are not printed.
-p"##" Sets the string which is printed after a formfeed when
a page break is needed. The default value is "\n\n"
-? Prints a summary of the command options
-oFILE Prints the output to the specified file. If this command
is not specified, output is printed to the screen. Note
that a printer device can be specified (lpt1 for example)
if it is desired to print the result of the program.
-s## Prints only those cards which have an index entry that
begin with the specified string. If the specified string
begins with an '*' then prints those cards which have an
index entry that includes the specified string.
Notes:
CARDREAD has several possible uses:
1. Print the contents of a cardfile using considerably less paper
than by using the "Print All" command from within CARDFILE.
CARDREAD tries to ensure that page breaks do not occur in the middle
of a record. This can be disabled by specifying the maximum lines
to be 0.
Example: cardread file.crd -olpt1
2. Print each card on a seperate page. This is accomplished by
specifying the maximum lines per page to be 1.
Example: cardread file.crd -l1 -olpt1
3. Import the contents of a cardfile into a word processing program
by writing the output to a file which can then be imported into the
word processing program:
Example: cardread file.crd -l0 -ofile.txt -r"\n\n\n"
4. Import the contents of a cardfile into a spreadsheet. This is
done by writing each card on a single line, with fields seperated
by character delimiters. Once the output file is imported into the
spreadsheet, the data is parsed using the appropriate spreadsheet
command:
Example: cardread file.crd -l0 -ofile.txt -r"\n" -f"^"
5. Use the search function to list the data of a specific card.
For example, include the following in a batch file:
Example (file.bat):
@echo off
cardread file.crd -s"*%1" | more
echo .
pause
file roger
will list those cards with the string 'roger' anywhere in the index.
Special Notes:
1. The "strings" used to represent the various delimiters
should use standard C syntax for specifying special characters.
"\n" for example, is the "new line" character. Hex codes
can be specified by entering "\x##". Octal codes by "\###".
This program is free software; you can redistribute it and/or
modify it under the terms of the
GNU General Public License
as published by the Free Software Foundation; either version 2
of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.