| | Find Files with speed and ease |
| | Find Files with speed and ease
|
| |
|
| Find and Show Files Containing Text |
Find and Show Files Containing Text
| A Single Key to Find and Show Next File or Next Value |
A Single Key to Find and Show Next File or Next Value
The find keys are F3 and F4.
These keys work on the screens to enter the find criteria as well as the FileList window.
They also work on all message screens (e.g. that the end of a document/list has been reached or that a value has been found).
This is a simple but very powerful feature. One which makes finding text within files very much easier.
F3 will find the next value within the current section.
F4 will find the next file in the current list, show it in the text section and reposition/select the first found value.
F4 will even work on the "No more values found" message that is shown for F3.
Thus, using F3 and F4 ONLY (no mouse, no other keys) it is possible to show each found value in each file one by one.
If you press F4 to find the next file you can then press F3 to see each value in that file and finally on the message that there are no more values, press F4 to move to the next file.
Additionally Shift+F3 and Shift+F4 will always show the screen where a search criteria can be entered for Find within section and Find Files containing text respectively.
TIP:
A shortcut key [Usually Ctrl+Shift+J] is also available to Find AND ACTION the next file containing the text to find. It will be actioned according to the action defined as 4 on menu Ctrl+Shift.
When Kyboma is installed, this action is defined as Notepad.
Using Define - Action on the edit menu, the action to be done on each file found can be changed to any other action (eg. another editor).
A second shortcut key [Usually Ctrl+Shift+K] works in the same way with the action defined as 5 on menu Ctrl+Shift.
This feature is especially useful if you want to change a string in all files where it is used.
| Find in Current Text / in File List / in Directory Tree |
Find in Current Text / in File List / in Directory Tree
Basic Criteria
Features of Kyboma Find
I. Match whole word only and Specify if search should be case specific or not.
II. Criteria always shown in status and messages in simple logical short format.
* * * * * * * * * * * * * * *
Features of Kyboma Find
I. Match whole word only and Specify if search should be case specific or not.
If option to Match case is checked, Only values with the same case as the Find Value will be found. I.e. Find lon will find londoner, london, along but will NOT find London or ALONG.
Match case applies to all find and exclude values as well as other parts of the complex criteria. I.e. Find lon or Lon but exclude long will reject along but will still accept Long or ALong.
If Match whole word only is checked then the value to find must be preceded and followed by a space or special character (punctuation etc.). I.e. Find lon will reject london or along. It will find lon or lon. or :lon- etc.
For this criteria, character before or after word can be any character EXCEPT 0-9, a-z, A-Z.
For advanced users only, other characters that are not allowed can be added by changing entry WholeWordAscRangesNotAllowed. This is in ini file FindVal.ini which is found in subdirectory param of the main Kyboma directory.
* * * * * * * * * * * * * * *
Features of Kyboma Find
II. Criteria always shown in status and messages in simple logical short format.
The criteria used for Find in any section and for Find File Containing Text is shown
- in the list of results on the status bar
- when the end of a file or list is reached and a message is displayed
- when no value has been found and a message is displayed
- on the top of the Enter Complex Criteria screen
- when you display each file/value for Find Files containing text as they are found.
The Criteria is always shown in the same format.
When it is shown on a message screen the abbreviations used can be displayed using the Legend button.
A simple find for a single value without a value to exclude will be shown as
Find >>xxx<< where xxx is the value to find.
A simple find for a single value with a single value to exclude will be shown as
Find >>(xxx) -(yy)<< where xxx is the value to find, yy is the value to exclude.
If Match Case is checked, MC will be added to the criteria, If Whole Word Only is checked WW will be added to the criteria.
Find >>(xxx) WW MC<< where xxx is the value to find.
Find >>(xxx) WW MC -(yy)<< where xxx is the value to find, yy is the value to exclude.
Several values to find will be listed with "or" before 2nd and subsequent values.
A criteria with several values to find and several values to exclude will be shown as:
Find >>(aaa) or(bbb) or(ccc) -(yy) -(zz)<< where aaa, bbb, ccc are the values to find, yy,zz are the values to exclude.
Other parts of complex criteria are listed with abbreviations:
-L(aaa) Exclude Lines Which start aaa
+L(aaa) Only find when Line starts aaa
-LG(aaa) Exclude Lines Which start aaa but Ignore leading spaces. I.e. Line may not start "aaa" or " aaa" or " aaa", etc.
+LG(aaa) Only find when Line starts aaa but Ignore leading spaces. I.e. Line must start "aaa" or " aaa" or " aaa", etc.
-S(aaa) Exclude when aaa on same line as value found
+S(aaa) Only find when aaa on same line as value found
-Rnn(aaa) Exclude when aaa within nn bytes of value found
+Rnn(aaa) Only list when aaa within nn bytes of value found
If any S (same line) or L/LG (line starts) criteria is included, Restrict Line(nnn) will be added to the end of criteria to indicate how much text is searched to find the line start and end.
| Find Using Complex Criteria - Enter an unlimited number of values to find and exclude. |
Find Using Complex Criteria - Enter an unlimited number of values to find and exclude.
Features of Find files using complex criteria
I. Enter a Complex criteria with unlimited number of values to find and exclude.
II. Show reasons for rejection of files.
III. How To enter a list of values
* * * * * * * * * * * * * * *
Features of Find files using complex criteria
I. Enter a Complex criteria with unlimited number of values to find and exclude.
To enter more than one value to find or more than one value to exclude:
a. press the Complex Criteria button on the Enter Find Criteria screen.
b. Press the "Text to Find / Exclude" button on the bottom of the screen to display that section of the complex criteria.
The first value to find will always be the same as the Find "Containing Text" value from the Enter Find Criteria screen.
For Info on how to enter many values see III. How To enter a list of values
Examples of:
1. Text To Find.
2. ExclUde Values.
Example1. Text To Find
If more than one Text to find value is specified, a file will be listed if ANY of the values are found. But only if all other criteria are matched.
After a value is found, other criteria are checked.
If all other criteria are OK the file is listed and Kyboma continues to search for the next file.
If a found value is rejected because of one of the other criteria, Kyboma will continue to search that file.
E.g. Find >>(mind) or(brain) or(think)<< will find a file containing the word brain but which does not contain either mind or think. A file will also be listed that contains all three words.
Example2. ExclUde Values
A found value will be REJECTED if it is part of ANY of the "ExclUde values".
Values to exclude should always contain one of the values to find. If not, they will be ignored. I.e. Find lon, exclude long is correct. Find lon, exclude man is not correct (and the exclude criteria will be ignored).
E.g. Find >>(mind) -(minder) -(remind)<< will not list as found any file containing the word minder.
The file may or may not also contain reminder. It will not be listed unless it also contains a word mind or minding etc.
I.e:
File will NOT be listed when
- it contains no text string mind.
- it contains the word minder but no other text string mind.
- it contains the word remind but no other text string mind.
- it contains the words minder, remind but no other text string mind.
File WILL be listed when
- it contains the words minder, mind.
- it contains the words minder, reminder, minding.
See Also To find/list all files containing text using a complex criteria for the text to find for more examples.
* * * * * * * * * * * * * * *
Features of Find files using complex criteria
II. Show reasons for rejection of files.
When using complex criteria with several parts, it is sometimes difficult to understand why nothing is found.
It is helpful in determining how the criteria should be changed to see each found value that is rejected due to the complex criteria. Kyboma can keep a list of these rejected values as well as the part of the complex criteria that caused them to be rejected.
When a search is done Kyboma will always keep a list of rejections for the last processed file. To keep a list for all files select Options from the Enter Find Criteria screen and check "Save Detail ...".
If the search is being done on a directory/drive to make a list, a progress box will appear on top of the file list showing the number of files processed and the number found/listed. Press the "Show Detail" button on this box to show the list of rejections as the list is being created.
After the detail is shown a list of rejections will be kept for the current and all subsequent files read.
Note rejections are added as they are found at the TOP of the list. The path and filename of the file will always appear UNDER a list of rejections for that file.
If "Save Detail" is checked, the search criteria is also shown at the end of the list of rejections, .
Use "Show Find File Info ... " on the Show menu to display the rejections that were saved for the current file list.
Note that when F4 is pressed again to search in the current list, the rejections will be added at the top of the list of rejections if "Save Detail .." was checked. If "Save Detail ..." was not checked, only rejections for the last file will be kept.
* * * * * * * * * * * * * * *
Features of Find files using complex criteria
III. How To enter a list of values
Enter a single value in each box until all boxes are full. Then press the "Add Line ..." button to create more boxes.
There will always be a single line of empty boxes after Add Line is pressed.
If many values are entered, they can not be changed on the available on the Complex Criteria Screen. When you are entering values and press "Add Line", Kyboma will automatically show values on a pop up screen. To Edit values that were entered previously, press the "Edit Values" button.
Press OK to save changes made on the pop up screen and return. Press Cancel to lose the changes made on the pop up screen. Press "Add Line" when all boxes are full to add another row of empty boxes.
If the number of values is reduced, Kyboma will automatically make them available for editing on the Enter Complex Criteria Screen.
If any value is entered for a criteria, a "Remove" button will be available. Press the "Remove" button to delete all values and enter a new list of values to find/exclude.
| Find Using Complex Criteria - Select/reject based on starting value of the line on which the text value was found. |
Find Using Complex Criteria - Select/reject based on starting value of the line on which the text value was found.
To enter start value(s) for line on which value is found which will determine whether found value is accepted or rejected:
a. press the Complex Criteria button on the Enter Find Criteria screen.
b. Press the "Only Find When" button on the bottom of the screen to display/change Values for "Only Find When Line Starts"
c. Press the "Exclude When" button on the bottom of the screen to display/change Values for "Exclude Lines which Start"
If any criteria is specified which requires the line on which value is found:
- the start point of the line will be the closest CR or LF character before the found value.
- the end point of the line will be the next CR or LF character after the found value.
- "Start/End Line - Max distance ..." determines the maximum number of bytes checked before AND after the found value when seeking the start and end of the line.
The values for these criteria must have the same case (capitals / small letters) if the option case specific is checked on the Enter Find Criteria screen.
For Info on how to enter more than one value see How To enter a list of values
Examples of:
1. Only Find When Line Starts.
2. Exclude Lines which Start.
Example1. Only Find When Line Starts
A found value will be ACCEPTED when the line on which it is found starts with ANY of the list of "Only Find When Line Starts" values.
If no CR or LF is found within the bytes checked (Restrict Line()), any criteria for "Only Find When Line Starts" will cause found value to be rejected.
E.g. Find >>(mind) +L(quote) +L(") Restrict Line(100)<< will find a file containing the word mind on a line that starts QUOTE.
The search will also find a file containing the word mind on a line that starts ".
The search will not find a file which contains mind but on a line not starting quote or ".
The search will not find a file which contains mind on a line starting quote but where the first mind is at byte 110 on the line.
Example2. Exclude Lines which Start
A found value will be REJECTED when the line on which it is found starts with ANY of the list of the "Exclude Lines which Start" values
If no CR or LF is found within the bytes checked, criteria for "Exclude Lines which Start" will be ignored (found value accepted).
E.g. Find >>(mind) -L(Example) -L(E.g.) -L(eg) Restrict Line(100) will find a file containing the word mind on a line that starts i.e..
The search will not find a file which contains mind but on a line not starting Example.
The search will not find a file which contains mind but on a line not starting E.g..
The search will not find a file which contains mind but on a line not starting Eg.
The search WILL find a file which contains mind on a line starting Example but where the first mind is at byte 110 on the line. Because Restrict Line ("Start/End Line - Max distance ..." has been set too small this -L(example) check will not be done when mind is found at byte 110 of the line.
All other criteria included in the complex criteria must ALSO be satisfied.
I.e. If there is a list of values for "Only find when Line starts" and a single value for "Only Find when one of following on same line as text to find" and a list of values for "Only Within Range":
- The found value must be on a line starting with ANY ONE of the values from the "Only find when Line starts" list
- AND the line must include the value from "Only Find when one of following on same line as text to find"
- AND ANY ONE of the values from the "Only Within Range" list must be in the text within the number of bytes specified.
| Find Using Complex Criteria - Select/reject if a specified value is found on the same line as the text value was found. |
Find Using Complex Criteria - Select/reject if a specified value is found on the same line as the text value was found.
To enter value(s) to check for on the same line as Text to find:
a. press the Complex Criteria button on the Enter Find Criteria screen.
b. Press the "Only Find When" button on the bottom of the screen to display/change Values for "Only Find When one of following on same line ..."
c. Press the "Exclude When" button on the bottom of the screen to display/change Values for "Exclude Lines When one of following on same line ..."
If any criteria is specified which requires the line on which value is found:
- the start point of the line will be the closest CR or LF character before the found value.
- the end point of the line will be the next CR or LF character after the found value.
- "Start/End Line - Max distance ..." determines the maximum number of bytes checked before AND after the found value when seeking the start and end of the line.
The values for these criteria must have the same case (capitals / small letters) if the option case specific is checked on the Enter Find Criteria screen.
For Info on how to enter more than one value see How To enter a list of values
Examples of:
1. Only Find when one of following on same line as text to find.
2. Exclude Lines when one of following on same line as text to find.
Example1. Only Find when one of following on same line as text to find
A found value will be ACCEPTED when the line on which it is found contains ANY of the list of "Only Find When one of following on same line ..." values.
If no CR or LF is found within the bytes checked (Restrict Line()), any criteria for "Only Find When one of following on same line ..." will cause found value to be rejected.
E.g. Find >>(mind) +S(psycholog) +S(study) Restrict Line(1000)<< will find a file containing the word mind on a line that also contains the word psycological. It will also find a file containing the word mind on a line that also contains the word study.
The lines
"The analysis of his mind by the psychologist shows interesting deviations from the norm."
"The study of the mind is my passion in life."
"The psychological study of her mind suggests a temporary loss of control at the time the crime was committed."
"I don't mind what you choose to study."
would all be found
The search will not find a file which contains mind but which does not contain either psycholog or study on the same line. E.g. The line "I don't mind what you do." would not be found.
Example2. Exclude Lines when one of following on same line as text to find
A found value will be REJECTED when the line on which it is found contains ANY of the list of the "Exclude Lines when one of following on same line as text to find" values
If no CR or LF is found within the bytes checked, criteria for "Exclude Lines when one of following on same line as text to find" will be ignored (found value accepted).
E.g. Find >>(mind) -S(psycholog) -S(study) Restrict Line(1000)<< will find a file containing the word mind only if the line does NOT contain either the text psychologi or the text study.
The lines
"The analysis of his mind by the psychologist shows interesting deviations from the norm."
"The study of the mind is my passion in life."
"The psychological study of her mind suggests a temporary loss of control at the time the crime was committed."
"I don't mind what you choose to study."
would all NOT be found
The line "I don't mind what you do." would be found.
All other criteria included in the complex criteria must ALSO be satisfied.
I.e. If there is a list of values for "Only find when Line starts" and a single value for "Only Find when one of following on same line as text to find" and a list of values for "Only Within Range":
- The found value must be on a line starting with ANY ONE of the values from the "Only find when Line starts" list
- AND the line must include the value from "Only Find when one of following on same line as text to find"
- AND ANY ONE of the values from the "Only Within Range" list must be in the text within the number of bytes specified.
| Find Using Complex Criteria - Select/reject if a specified value is found within a range (no. of bytes) of the text value was found. |
Find Using Complex Criteria - Select/reject if a specified value is found within a range (no. of bytes) of the text value was found.
To enter value(s) to check for within a byte range of Text to find:
a. press the Complex Criteria button on the Enter Find Criteria screen.
b. Press the "Only Find When" button on the bottom of the screen to display/change Values for "Only Find when one of the following within range ..."
c. Press the "Exclude When" button on the bottom of the screen to display/change Values for "Exclude Lines when any of the following within range ..."
The values for these criteria must have the same case (capitals / small letters) if the option case specific is checked on the Enter Find Criteria screen.
For Info on how to enter more than one value see How To enter a list of values
Examples of:
1. Only Find When one of the following within range of text to find.
2. Exclude Lines When any of the following within range of text to find.
Example1. Only Find When one of the following within range of text to find
A found value will be ACCEPTED when ANY of the list of "Only Find When one of the following within range of ..." values is found in the text n bytes before or n bytes after the value found. Where n is the "No of bytes from Found Value" entered.
E.g. Find >>(mind) +R20(psycholog) +R20(study)<< will find a file containing the word mind if the text psycological is contained in the 20 bytes before or after mind. It will also find a file containing the word mind if the word study is contained in the 20 bytes before or after mind.
The lines
"The analysis of his mind by the psychologist shows interesting deviations from the norm."
"The study of the mind is my passion in life."
"The psychological study of her mind suggests a temporary loss of control at the time the crime was committed."
would all be found
The search will not find a file which contains mind but which does not contain either psycholog or study.
The search will not find a file which contains mind and either or both psycholog or study but never within 20 bytes of mind.
The lines/text
"I don't mind what you do."
"The comparative study of the functional vs aesthetic parts of the mind is my passion in life."
"The psychological study took many years to carry out. About her mind, it suggests a temporary loss of control at the time the crime was committed."
"I don't mind what you choose to study."
would NOT be found.
If the search criteria was changed to Find >>(mind) +R100(psycholog) +R100(study)<< then the last 3 examples would all be accepted/found.
Example2. Exclude Lines When any of the following within range of text to find
A found value will be REJECTED when ANY of the list of "Only Find When one of the following within range of ..." values is found in the text n bytes before or n bytes after the value found. Where n is the "No of bytes from Found Value" entered.
E.g. Find >>(mind) -R20(psycholog) -R20(study)<< will find a file containing the word mind provided that the text psycological is NOT contained in the 20 bytes before or after mind AND the word study is NOT contained in the 20 bytes before or after mind.
The lines
"The analysis of his mind by the psychologist shows interesting deviations from the norm."
"The study of the mind is my passion in life."
"The psychological study of her mind suggests a temporary loss of control at the time the crime was committed."
would all NOT be found
The lines/text
"I don't mind what you do."
"The comparative study of the functional vs aesthetic parts of the mind is my passion in life."
"The psychological study took many years to carry out. About her mind, it suggests a temporary loss of control at the time the crime was committed."
"I don't mind what you choose to study."
would all be found.
If the search criteria was changed to Find >>(mind) -R100(psycholog) -R100(study)<< then the last 3 examples would all be rejected/NOT found.
All other criteria included in the complex criteria must ALSO be satisfied.
I.e. If there is a list of values for "Only find when Line starts" and a single value for "Only Find when one of following on same line as text to find" and a list of values for "Only Within Range":
- The found value must be on a line starting with ANY ONE of the values from the "Only find when Line starts" list
- AND the line must include the value from "Only Find when one of following on same line as text to find"
- AND ANY ONE of the values from the "Only Within Range" list must be in the text within the number of bytes specified.
| Advanced Features of Find Files Containing Text |
Advanced Features of Find Files Containing Text
Features of Find files Containing Text
I. Flexible and complete specification of where to look (Drives or directories).
II. Show each file containing text found on a pop up screen as it is found.
III. Show columns in the list with details of value found.
IV. Restriction of total bytes to search.
V. Saves all text search criteria in a single list. Automatically converts criteria used for a search in any file list window section or for a find files containing text search.
* * * * * * * * * * * * * * *
Features of Find files containing text
I. Flexible and complete specification of where to look (Drives or directories).
A list of standard settings for Look In is supplied to allow quick selection. It will include:
- the directory list to be used at the next refresh (F5).
- the directory selected in the directory tree when F4 was pressed.
- the list for F5 plus the selected directory.
- each disk drive to allow a search on that single drive.
- All Drives (including floppys and CD Roms).
- All Fixed Drives (all hard disks but not Floppy drives or CD Rom drives).
The first three will only be different if multiple directories is specified.
The last entry in the list is always All Fixed Drives (all hard disks but not Floppy drives or CD Rom drives). This option can always be selected by pressing Alt+K to transfer to Look In selection and then the End key.
It is also possible to Look In the Current List. Either a list made using refresh (F5) or made using a previous search can be searched with a different or the same criteria.
See To look at the contents of the file and see the found value for each file found
Choose "Current List (Only Files Named)" to search only files that match the *-notation mask specified as Named.
Choose "Current List (All Files Listed)" to search all files ignoring the Named criteria.
To specify a different list of directories / drives press "Select Directory" button on the Enter Find Criteria screen.
Then Check Multiple Directories to enter a list of directories and files and then select the directories and files required.
See Select Directories/files to List
If you press OK on the Select Directories/files that list will be saved as the directory list to be used at the next refresh (F5) when if you then cancel the search.
The Include Subdirectories option can also be changed here.
This value is used always when a single directory is refreshed or searched.
When a list of directories and files is refreshed or searched, this value is the default value for any directory in the list for which a specific value is not specified.
See Select By File Type.
* * * * * * * * * * * * * * *
Features of Find files containing text
II. Show each file containing text found on a pop up screen as it is found.
On Enter Find Criteria screen, check "Show Popup/Request ..."
When you press F4 to find files, each file will be shown together with the part of the text containing the value found.
When the first value is displayed you can search for and display other values in the same file using F2/F3.
Search for the next file by using F4.
To complete the list of all files without showing each file, press "List All Files.
* * * * * * * * * * * * * * *
Features of Find files containing text
III. Show columns in the list with details of value found.
Columns can be added to the file list which show the value found, the byte number and the part of the text containing value found.
To show these columns:
a. Press options on the Enter Find Criteria screen.
b. Check the options "Show Found ...".
c. Select Look IN and press F4 to create the list.
The options must be selected before the list is made.
Only the first value found in each file will be shown.
The part of the text containing value found is 200 bytes of text starting 50 bytes before the found value.
To display this text, use a row Height that shows a few lines of text. Select a row and press Ctrl+W to increase the row height. Then choose "Copy Row Height to all .." from select menu to make all rows the same height.
* * * * * * * * * * * * * * *
Features of Find files containing text
IV. Restriction of total bytes to search.
Search for files containing text can take a long time if you search many files and/or use a complex criteria.
A general selection of Named & Look In (e.g. * and C:\ or All Drives) will read many large files as well as smaller ones. It is then useful and quicker to search only the first bytes of each file.
Example1: If you are looking for text within a txt file created with Notepad, you need search only the first 40.000 bytes of each file. Notepad cannot create or change a file longer than 33.000 bytes.
Example2: If you are looking for text within an html document (web page), a search of only the first 150.000 bytes of each file will very probably find the required file. Html is rarely longer than this.
By restricting total bytes, to search the time for the search will be reduced.
Note however that if you restrict the total bytes to search and find nothing, you cannot conclude that the text does not exist in any file.
To make sure you must search again with the restriction removed.
To Restrict the number of bytes to search:
a. Press options on the Enter Find Criteria screen.
b. Enter Max No of Bytes.
NB The number entered will be rounded up to the next higher multiple of 10000 bytes without any warning message.
40.000 will cause only the first 40.000 bytes of each file to be searched
40.001 will cause only the first 50.000 bytes of each file to be searched
* * * * * * * * * * * * * * *
Features of Find files containing text
V. Saves all text search criteria in a single list. Automatically converts criteria used for a search in any file list window section or for a find files containing text search.
When a search criteria is entered for either F3 or F4, the criteria is saved.
Later searches can then be made using the same criteria. Previous criteria can also be copied and changed.
To display the list of Criteria used, press Last Criteria on the Enter Find Criteria screen. Press Last Criteria again to hide the list.
The List includes criteria for all searches made with either F3 or F4 on all file list windows. Criteria are only added to the list when the search is done. If Cancel is pressed, the criteria will not be saved.
The most recent search will always be at the top of the list. Double click any criteria in the list to copy it.
Note that searches in directory tree or file list sections of the file list window allow less criteria than searches in the text section or F4 searches. When you search in a section with disallowed criteria, all criteria in the list will automatically be converted. A copy of a search with hidden (disallowed) criteria that have been removed will then be added to the top of the list since the criteria is different.
TIP:
Using Last Criteria, it is easy to copy criteria used to search text to search the file list or to find files containing text (and vice-versa).
Criteria are also easily copied between windows and saved from one session to the next.