Short: File Finder (custom output and search) Author: soenke.tesch@elmshorn.netsurf.de Uploader: soenke.tesch@elmshorn.netsurf.de Type: util/dir What`s it all about? ==================== This is probably the 10312. implementation of a File Finder. Anyway, I spend a full 2½ hours on this and therefore I like it best :) Find will search in a directory and its subdirectories for objects matching a given pattern. You can say where and how deep Find should search and if it should return only files or directories or both. The output is customizable. Find does not need any extra libraries and does not feature a text viewer, database or coffee-machine. Want a fancy MUI user interface with fiftythousand buttons? Go and look for another program, Find is CLI-only ;) Short instructions ================== Find PATTERN/A,ROOTDIR,DEPTH/N/K,DIRS/S,FILES/S,STATS/S,QUIET/S,LFORMAT=FORMAT/K PATTERN Name of the file or directory you are looking for. This string may also contain standard AmigaDOS wildcards like #,?,~ etc. Please see your AmigaDOS manual for further details. ROOTDIR Find usually starts searching in the current directory and its sub- directories. Setting ROOTDIR to something else will change this. If you want e.g. search for your great EggPaint in your complete first harddisk, you can use one of the following: find EggPaint dh0: find EggPaint rootdir dh0: find EggPaint MyFirstDisk: DEPTH Maximum level of sub-directories Find will search in. The current directory (or ROOTDIR if used) is level 0. find EggPaint dh0: depth 0 will thus search only in the current directory. The default is unlimited. BE CAREFUL: If Find finds a matching link it will return the path and filename of the file the link points to, _not_ of the link! Therefore you may get files very deep in your directory tree although you set DEPTH to 1 or even 0. Not my fault, this is the behaviour of the NameFromLock() function in dos.library..:/ DIRS Find returns only directories matching PATTERN. FILES Find returns only files matching PATTERN. STATS Find will print an some extra information after the search, e.g. 1 files and 5 directories in 2 of 7 places This means Find found 1 matching file and 5 matching directories in 2 directories. Find searched in a total of 7 directories. QUIET By default Find prints some information about where it is currently looking for matching objects to the Shell window. This output can be switched off by setting QUIET. LFORMAT or FORMAT This is the similar to the c:list argument LFORMAT. The given string is written to the output for every matching object. Every %s in this string is replaced by the complete path. Example: Find EggPaint format "Found the magnificent %s*n" might output Found the magnificent MyFirstDisk:Gfx/EggPaint BE CAREFUL: If you want the cursor to move to the beginning of next line at the end of the string you have to put *n at the end of the template. Copyright ========= Find and Find.readme are copyrighted by Sönke Tesch 1997. All Rights Reserved. You may re-distribute the archive as long as no file is removed or changed. Find has to be distributed for FREE, any other kind of distribution without my written permission is not allowed. However, this is not the case for any AmiNet- or Fred Fish-disks. I do not give any guarantee for the quality and usefulness of Find! Contact ======= To contact me via mail write to . History (do we have one yet:) ============================= 19-Apr-97 a Version 1.00 on Aminet Those finer details.. ===================== Find is written using Cyclone Modula-2 by Marcel Timmermans. The source is available on request, just ask. -- Amiga Translators Organization * Main & German Admin, Ex-Human Listserver ato : ato-admin@ato.vapor.com & ato-admin-de@ato.vapor.com private: soenke.tesch@elmshorn.netsurf.de ============================= Archive contents ============================= Original Packed Ratio Date Time Name -------- ------- ----- --------- -------- ------------- 3196 1837 42.5% 24-Apr-97 16:57:20 Find 4108 1926 53.1% 29-Apr-97 02:21:14 find.readme -------- ------- ----- --------- -------- 7304 3763 48.4% 30-Apr-97 14:56:20 2 files