home *** CD-ROM | disk | FTP | other *** search
/ The Best of Windows 95.com 1996 September / WIN95_09964.iso / text / fdstr95.zip / FIND95.TXT < prev    next >
Text File  |  1996-07-07  |  7KB  |  138 lines
  1. Find String Application Synopsis for Windows 95/NT
  2.  
  3. The multiline Find String application was built to allow application
  4. developers, html writers, system/network administrators, and others
  5. to find a key word or phrase in many lines of many text files quickly
  6. and efficiently.  The application supports DOS file like wildcards
  7. or a limited set of UNIX like Regular Expressions in the Find String.
  8. Application developers can, for example, wire it into the
  9. Microsoft C++ visual work bench through its Options/Tools menu to
  10. enrich the editing capability by allowing them to find all instances
  11. of a key word or phrase in their project.  It can also be used
  12. stand-alone by developers, html writers, administrators et. al. who
  13. need to find a piece of information in one or more lines of many
  14. files located in a multiple directories.  Once found, by double
  15. clicking on the file or file line, you can launch the editor of your
  16. choice (notepad by default) to manipulate the data.  Find String,
  17. will in addition to launching an editor, supply the line number to
  18. the editor if instructed to do so and will allow command line parameters 
  19. if required.  For those folks like me, who can not remember where they
  20. defined a variable 20 minutes ago, it's essential.
  21.  
  22. Selecting Files to Search
  23. Find String supports two methods of defining the file set to search. 
  24. The first method allows you to select as many files from as many
  25. directories via an extended file dialog as you want the application
  26. to search.  This method is supported whether or not you have
  27. registered the application.  The second method allows you to specify
  28. a start directory and file filter.  This method is only supported for
  29. registered customers.  If you have registered the application, you
  30. can use both methods to specify the file set to search.
  31.  
  32. Multiline Searches
  33. Find String supports multiline searches and searching for special
  34. characters.  The supported special characters are displayed in a list
  35. in the lower left corner of the Find String Dialog.  Just double
  36. click on the special character you wish to search for and it is
  37. automatically added to the end of the Find String Line.  To search
  38. for a literal (e.g., \n) use the \\ (e.g., \\n).
  39.  
  40. Special Characters
  41. Find String supports usage of a set of non-printable characters that
  42. may be embedded within the string pattern.  These special characters
  43. are:
  44. \r\n    DOS end-of-line;
  45. \n    new line which is the UNIX end-of-line;
  46. \r    carriage return;
  47. \t    tab;
  48. \v    vertical tab;
  49. \f    formfeed (also paragraph indicator)
  50. \a    bell; and
  51. \b    backspace.
  52.  
  53. Regular Expressions
  54. Find String supports the definition of group/set/character
  55. expressions for licensed customers.  The supported regular
  56. expressions conform closely but not exactly to the UNIX standard. 
  57. The application does not support:
  58. o    nested groups within groups or sets within sets;
  59. o    the beginning (\<) or end of word (\>) constraints; 
  60. o    definition of your own range constraints (\{m,n\}); 
  61. o    definition of substring registers (\n}); 
  62. o    non-escaped literal brackets [ or ] within a set; 
  63. o    non-escaped literal parentheses ( or ) (interpreted as group
  64.     indicators unless escaped with a \); and
  65. o    iteration characters associated with groups.
  66.  
  67. DOS file like Wild Cards
  68. Find String supports the definition of the ? and * file like wild
  69. cards for licensed customers.  The ? means match any single character
  70. while the * means match one or more characters until succeeding match
  71. characters are encountered (e.g., ab*v ) or, if the last character,
  72. to the end-of-line (e.g., ab*).
  73.  
  74. Display Limitation
  75. The application was designed to handle a huge number of files from
  76. multiple directories.  There is a display limitation that will limit
  77. the number of files you can search at one time.  The display
  78. limitation is 128,000 lines, consequently, if 95 lines are found per
  79. file (96 display lines), the file limitation would be about 1,300
  80. files.  The application will stop the search operation when the line
  81. limitation is reached.
  82.  
  83. Windows 95 Customers
  84. With Windows 95, I had hoped that the display limitations for list
  85. boxes et. al. would no longer be a concern.  In fact, I assumed that
  86. only to find out that I can only display 32767 lines in a list box. 
  87. As a result, only 32000 lines are displayed per display frame.  To
  88. overcome this limitation, I allow you to switch display frames using
  89. the Up (yellow) and Down (cyan) arrow buttons on the tool bar or 
  90. selecting the Next/Previous Display Frame option from the View Menu.
  91. For those of you who have NT, forget this paragraph.
  92.  
  93. Find String Remembers
  94. Find String remembers the first directory searched and will default
  95. to that directory on the next invocation.  Additionally, Find String
  96. will save up to the last 100 (20 by default) search strings and allow
  97. you to reuse those stings on subsequent invocations.  For those of
  98. you who want a constant start position on your desktop, Find String
  99. remembers its last size and desktop position and will restore itself
  100. to that size and position until you change it.  If you position it
  101. partially or fully off the desktop, it will restore itself fully on
  102. the desktop.
  103.  
  104. Newline in Files Required
  105. The application expects to find a newline character, as a minimum, at
  106. the end of each line and will not process files that are not
  107. constructed in this manner.  Files generated by word processors are
  108. not guaranteed to fall into this category unless they are saved in
  109. ASCII/text.  When the application encounters such a file, it warns
  110. you and excludes that file from any further search.  The search
  111. string is limited to 1024 characters and the maximum number of
  112. characters per searched line is limited to 2048.
  113.  
  114. Multiple Editors
  115. If you wish to maintain multiple editor capabilities and segregate
  116. your remembered find strings, you may pass Find String a command line
  117. argument specifying the full path to a different ini file (unless the
  118. ini file is in the windows directory and then only the name of the
  119. ini file is required (e.g., my.ini).
  120.  
  121. UNIX File Types
  122. In today's networking environment, many files can be manipulated on
  123. foreign machines.  The UNIX file type is supported automatically for
  124. those who need to remotely find a key word or phrase in text files
  125. that conform to the UNIX file standard, assuming of course, that you
  126. have that capability.  UNIX file types are NOT supported
  127. automatically when you choose regular expressions.  The application
  128. must know how to treat the $ end-of-line character prior to starting
  129. the search.  When you check the regular expression box, the UNIX File
  130. Type box will become active.  Check it if you are using the $ in the
  131. expression.
  132.  
  133. The application is easy and safe to use, just type in or select a
  134. previous string, select whether or not you want it to match case
  135. and/or be a whole word, select one or more files you want it to
  136. search, and Begin!
  137.  
  138.