Tools en Utilities

home *** CD-ROM | disk | FTP | other *** search

/ Tools en Utilities / CDASS_5.ISO / shell / file / srch14.arj / READ14.ME next >

Wrap

Text File | 1992-01-08 | 12.9 KB | 345 lines

SRCH104.EXE COPYRIGHT 1991: MILES PAWSKI SRCH14.ZIP CONTAINS: SRCH104.EXE --- Command Line Utility SRCH104P.EXE --- Application Program READ14.ME --- Info file (Uploaded by author) NOTE: This utility replaces SRCH100.EXE, SRCH101.EXE, SRCH102.EXE and SRCH103.EXE ------------- SRCH104.EXE ----------- COMMAND LINE UTILITY SRCH104.EXE is a text search utility that searches ALL files, regardless of their type, for text. If text is found, a line fragment (70 characters maximum) will be displayed which contains the text and the matching text will now be highlighted. You can now scroll forward and backward through files by the use of the new -tp (t) parameter. You can also recurse through subdirectories with the new -r parameter. You may quit the program at any time by just pressing ESC. This program filters out control characters for display. Control characters (ascii 1 to 29) can be searched for but they will not be displayed (although the line fragment which contains them will be). All other characters will be displayed. This program is fast, can easily be used in batch files and is much better than the DOS FIND utility. SRCH104P.EXE is an actual application program if the command line version doesn't appeal to you. It has all the same features and is very easy to use. -------------------- FORMAT: SRCH104 [-]FILENAME "TEXT" [-r] [-12345] [-p] [-tp] [(/)/d:\x] Parameters in brackets are optional. FILENAME is the FULL PATH NAME of the file in which you want to search for text. It must be a full path, e.g.: a:\*.* (drive, directory, etc.), even if you want to search the directory in which you are in at the time. It must come after SRCH104 and have a space before and after it. DOS WILDCARDS ARE ALLOWED and may be used within DOS conventions, e.g.: c:\*.* FILENAME can now be on any drive that you wish. FILENAME may be replaced by a search file which contains the names of files and directories that you want searched. It should be written on a pure ASCII editor and contain one file\directory per line and follow standard DOS file naming conventions, e.g: The file search.dat contains the four lines: c:\hold\*.bas c:\dos\*.com c:\*.* a:\utility\bigfile All .bas files in the "hold" directory, all .com files in the "dos" directory, all files in the "root" directory, and the file "bigfile" in the "utility" directory on the A drive will be searched. The SEARCHFILE must be delimited by a hyphen and contain the full path of the file e.g.: SRCH104 -c:\search.dat "Anytext"..... "TEXT" is the text word or phrase or letter that you want to search for. It MUST be surrounded by QUOTATION MARKS. This program will report back word fragments as well as whole words. For example "the" will display not only the word "the" but all words containing "the" such as "there", "them", etc. To search for whole words, simply add a space on each side of the word: " the ". It is, however, better to not leave a space on each side of the word, since the program is more successful without them. Many word processing programs use control characters instead of spaces (at times) and this may confuse the search process. Control characters are only filtered out for the final display. This program is CASE INSENSITIVE. You may enter any combination of upper and lower case letters. -12345 denotes the color of the text string output on the screen. -1 white on black (default) -2 green on black -3 blue on black -4 red on black -5 cyan on black Information header and highlighting colors are predetermined. You do NOT need ansi.sys for this program. -p pauses the display after every full screen (default: off) -tp is a new parameter. It pauses the display after every text match. The good thing about this parameter is that it allows you to view the files that you are scanning. After you find a text match, the display pauses. The bottom line offers you various choices. You may quit by pressing ESC (you can do this at any time anyway), you may scroll forward 5 lines by pressing the space bar (these are 5- 70 character lines - it allows you to read the text or whatever but the display isn't formatted) or scroll backward 5 lines by pressing backspace. You may scroll as many lines as you wish by pushing either key. You may go on to the next match by pressing ENTER. If you have a lot of text matches, the use of this parameter can be very time consuming since it pauses after every match. -r This parameter is new and causes subdirectories below the specified directory to be searched (on any drive). It can only be used in conjunction with wild cards e.g.: c:\dos\*.bas -r searches all files with the .BAS extension in the DOS directory and all .BAS files in all subdirectories of the DOS directory. This parameter causes your disk to be read and a temporary file is created in the root directory on the C drive which means YOU SHOULD ONLY RUN THIS FROM A SYSTEM WITH A C DRIVE. It creates three temporary files: DRCT$$$$.DAT, DRCT$$$2.DAT and DRCT$$$3.dat. These are deleted after use but if you experience a power failure or something and you see these files in your root directory, you'll know what they are. This parameter does not work with or in search files. -r actually creates a temporary "search file" for use by the program. You can create your own "search files" as mentioned previously. (/)/d:\xx You may direct the output to a file if you wish by specifying a file on the command line. You must use the / character to do this and the file may be any valid file or path. If the file specified does not exist, it will be created. This program will not create subdirectories. For use in batch files, the screen display can be turned off while directing output to a file by using two /'s: //d:\xx EXAMPLES: SRCH104 c:\fileman "crazy" -2 -p /d:\hold This example searches the file "fileman" in the root directory for the word fragment "crazy". The results will be outputted to the screen in green on black and the screen will pause after each full screen (if the display is long enough). The output will also be directed to the "hold" file on the D drive. SRCH104 c:\hold\bag " green " //c:\xx This example searches the "bag" file in the "hold" directory for the whole word "green". The display will be turned off and the output will be directed to the "xx" file in the root directory. SRCH104 b:\*.* "Micro" -5 -p This example searches all files in the root directory on the B drive for the word fragment "Micro". The text string output will be in cyan on black and the screen will pause after each full screen (if the display is long enough). SRCH104 -c:\search.dat "Chevy" -2 /d:\utility This example uses the information in the file search.dat to determine which files and directories will be searched for the text string "Chevy". The text string output will be green on black and will also be directed to the file "utility" on the D drive. SRCH104 C:\*.* -r "formula" -5 -tp This example scans every file in every directory on your disk and pauses after every match on the text fragment "formula". The displayed lines will be in cyan. Although FILENAME must come after SRCH104 on the command line (and have a space on each side), the other parameters can actually be put in any order (and have spaces around them). As mentioned earlier, the header colors are predetermined and the highlighted text will appear in bright yellow. You may choose the colors of the displayed lines, however. A help screen will come into view if you enter SRCH104 on the command line by itself. --------------------------------- SRCH104P.EXE APPLICATION PROGRAM To start this program, enter the directory which contains SRCH104P.EXE, type in SRCH104P on the command line and press ENTER. This will bring up the main screen. This program operates basically the same as the command line utility. TEXT TO SEARCH FOR You may access a help menu by typing in ? in this first category and pressing Enter. You may select display line colors by typing in /c and pressing enter. This program searches only for word fragments and strips the spaces off any text entered at the prompt. PAUSE MODE This is the same as the command line utility except that you enter p for pause-page and t (same as -tp for srch104.exe command line utility) for text-match. No entry or N will result in no pause at all. (See previous section on SRCH104.exe for information on the new text-pause mode) YOU MUST NOT DELIMIT THESE PARAMETERS WITH A "-" OR "/" in this program. PLACE TO SEARCH You must enter a full path in this category including drive and directory, e.g.: b:\hold\*.*. WILDCARDS ARE ALLOWED. You may search one file in particular or an entire directory. You may use the /r switch to recurse the specified directory and all subdirectories under it. You must use this parameter with wild cards in the specified file otherwise it will not work. EXAMPLE: c:\holding\*.bas /r searches all ".bas" files in the "holding" directory and all ".bas" files in all subdirectories of "c:\holding". Use of /r by itself on the entry line will result in an error. EXAMPLE: c:\*.* /r searches every file in every directory on the C drive. SINCE THIS PARAMETER CREATES TEMPORARY FILES ON THE C DRIVE, YOU MUST ONLY USE IT WITH A SYSTEM WHICH CONTAINS A "C" DRIVE. Please see previous section on SRCH104.exe for more information on this parameter. You may also specify a search file in this category. You must delimit it with a hyphen then specify the full path of the search file. EXAMPLE -d:\srch.dat uses the file srch.dat on the D drive. Please read about search files in the previous sections. The /r parameter does not work with or in search files. COPY FILE You may specify the full path of a copy file in this category. If the file does not exist, it will be created. This program will not create subdirectories however. All output will not only be directed to the screen but it will also be appended to this file. ----------------------------- MEMORY Both of these programs should have a minimum of 200K to run otherwise it may not function properly or, if you are using the R parameter, it may only create temporary files on your disk and then quit. DESQview These programs work fine under DESQview and should have (at least) 200k windows in which to run. The following settings work fine: Writes directly to the screen N or Y Displays graphics information N Virtualize text/graphics N or Y Uses it own colors Y Close on Exit blank Allow close window command N You may wish to experiment with your own system in order to determine the best settings. ------------------------------- LIMITATIONS This program may not be successful for text string searches in compressed or archived files (.zip, .arc, etc.) since those files use various forms of character encoding and substitution to achieve their goal. As with most memory intensive programs, SRCH104 may run up to 30% slower under DESQview. SINCE THE "R" PARAMETER MAKES TEMPORARY FILES ON THE "C" DRIVE, YOU SHOULD ONLY USE THIS PARAMETER ON A SYSTEM WHICH HAS A "C" DRIVE. ---------------------------------- FORMATTING INFORMATION (FOR SRCH104.EXE) CAN BE OBTAINED BY TYPING SRCH104 AT THE PROMPT. YOU SHOULD PLACE SRCH104.EXE IN A DIRECTORY WHICH IS CONTAINED IN YOUR AUTOEXEC.BAT "PATH" STATEMENT. There aren't many text-searching utilities on the shareware/freeware market and most of them aren't very versatile and are hard to use and understand. These utilities are very easy to use and are very accurate. You may use this utility for 30 days. If you like it, I would appreciate your comments. If you intend to use this utility, please register and support shareware by sending $10 to the address listed below. Please send along your name and address. You will receive a disk (please specify), registration number, and MY GRATITUDE. MILES PAWSKI MILES PAWSKI & COMPANY P.O. BOX 170448 SAN FRANCISCO, CA. 94117 COMPUSERVE# 70473,527