home *** CD-ROM | disk | FTP | other *** search
/ ftp.whtech.com / ftp.whtech.com.tar / ftp.whtech.com / club100 / utl / find.do < prev    next >
Text File  |  2006-10-19  |  2KB  |  57 lines
  1. CLUB 100 Library - 415/939-1246 BBS,    937-5039 NEWSLETTER, 932-8856 VOICE
  2.  
  3.  
  4. FIND.100      documentation
  5. ===========================
  6.  
  7. c1987 by Jon Diercks [73327,2353]
  8.  
  9.  
  10. Assembled with Custom Software's ASMBLR.CO.
  11.  
  12. FIND.100 is a very small, very fast ml routine that searches the M100's memory for a given string, listing each location where the string is found.
  13.  
  14. FIND.100 is just over 100 bytes long, and it can cover the entire 64K of ROM and RAM in as little as ten seconds!  It is a handy tool for programmers.
  15.  
  16. A few notes:
  17.  
  18. * Loading:  The file FIND.LDR is a relocating basic loader <created with
  19.   BASBLD.PW3 in dl8>.  To load FIND just below maxram, clear256,maxram then run
  20.   FIND.LDR and just hit enter at the end address prompt.  FIND.LDR creates
  21.   FIND.CO, which can be executed from the menu as long as memory is clear.
  22.  
  23. * Operation:  When you execute the program, you will be prompted for a
  24.   search string.  Type the text you want to find, then <ENTER>.  FIND.100 then
  25.   scans all of the M100's ROM and RAM for the string <Don't ask me about option
  26.   ROMs or expansion RAMs - I've never used them.  Tony?>.  The locations where
  27.   your string is found are printed on the LCD, and you are prompted to press the
  28.   space bar to return to the main menu.  Simple enough?
  29.  
  30. * No matter what you type for the search string, you will probably always get
  31.   63109 and 65078 as two of your numbers.  <They may be the only two>.  63109 is
  32.   the input buffer.  FIND stores your text there while it's searching.  65078 is
  33.   part of the LCD memory, and you can see that the string is there!
  34.  
  35. * FIND.100 is CASE-SPECIFIC.  The text search DOES compare literally, unlike
  36.   the normal Find: function on the M100 which is case-independent.  So, if you
  37.   search for "MENU", you will get different numbers than if you search
  38.   for "Menu".
  39.  
  40. * Shift-Break aborts the search at any time, in case you get impatient in less
  41.   than ten seconds.
  42.  
  43. * Shift-Break, ^C or a null input at the 'Search string:' prompt will abort the
  44.   program.
  45.  
  46. * ML programmers may want to check out FIND.SRC.  This file contains the Custom
  47.   Software Assembler Source code for the program.  FIND.SRC is NOT necessary for
  48.   normal operation of the program - average users need not download it.
  49.  
  50.  
  51. Please EasyPlex any questions, comments, problems, or whatever to:
  52.  
  53.       Jon Diercks [73327,2353]
  54.  
  55.            Happy hunting!
  56.  
  57.