Results Reference
While PowerGREP previews or executes an action, the Results panel shows a progress meter. While PowerGREP collects the list of files to search through, the progress meter stays at 0% while counting up the number of files it is about to search through. While searching through files the meter indicates the percentage of files already searched through at the left, and an estimate of the remaining time the action needs until completion at the right.
If you have configured PowerGREP to use multiple threads in the action preferences and the file selection includes files from two or more drives, it is possible for the progress meter to appear running backwards or back-and-forth. Because PowerGREP uses one thread to get the list of files from each drive, it is possible that PowerGREP starts searching through the files on one drive while it is still getting the list of files on another drive. That causes the thread searching through files to advance the progress meter as it completes part of the job while the other thread reduces the progress meter as it increases the size of the job by adding files to the list. A “still globbing” label on the progress meter indicates this situation. Once the list of files has been gathered for all drives the progress meter will advance normally.
By default, the results are updated at regular intervals as PowerGREP finds more search matches. If you find this distracting, turn off the Automatic Update button. You can then click the Update Results button to see the results gathered so far. to make PowerGREP update the results regularly. Updating the results slows down the search somewhat, but does allow you to inspect the results before the action has completed.
Changing Display Options
The Results panel provides six sets of options to rearrange the display of the results, without executing the action again. When Automatic Update is active, changing an option immediately rearranges the results. If not, you need to click the Update Results button to rearrange them according to the new options. Automatic update is more convenient when working with small result sets. Manual update is faster when working with large result sets, since it allows you to change multiple options before updating the results.
Display Files and Matches
- Do not show files or matches: Do not show any file names or matches. Only totals will be shown.
- File names only: Display the names of the files searched through and their totals. Do not display matches.
- Target file names only: Display the names of the target files that were created or modified and their totals. Do not display matches.
- Matches without context: Display search matches without extra information. File names and file totals are shown when grouping per file.
- Matches with context numbers: Display search matches along with the number of the line or the context block the match was found on.
- Matches with context: Display the context that was collected for the matches, and highlight the matches.
- Matches with context and context numbers: Same as "matches with context" and also showing the number of the line or the context block the match was found on.
- Aligned matches with context: Same as "matches with context", but results for matches with less context before them are indented so all highlighted matches line up (if you turn off word wrap) as in a concordance.
- Aligned matches with context and numbers: Same as "aligned matches with context" and also showing the number of the line or the context block the match was found on.
Note: When grouping unique matches, the context choices determine how matches are shown when double-clicking a unique match.
Group Search Matches
If you selected to display files and/or matches, you can also select how the files and matches should be displayed.
- Do not group matches: Show all matches, without indicating file names.
- Per file: Show file names, and all matches for each file.
- Per file, with or without matches: Show file names and all matches. Also show file names of files without matches.
- Per file, then per unique match: Show file names, and unique matches for each file. Per file, per match, with or without matches: Show file names and unique matches. Also show file names of files without matches.
- Per unique match: Show each unique match once, regardless of the files in which it was found. Do not indicate file names.
- Per unique match, listing files: Show each unique match once. List the names of the files the match was found in below each match.
Display Totals
- Do not show totals: Never indicate totals.
- Show totals before the results: Show the number of matches and files before the results. When grouping per file, show the number of matches in that file between the file name and the file's matches.
- Show totals after the results: Show the number of matches and files after the results. When grouping per file, show the number of matches in that file after the file's matches.
- Show totals for grouped matches.: Do not show overall or per-file totals. When grouping unique matches, show the number of occurrences before each match.
- Totals before results, and grouped matches.: Show overall and per-file totals before the results, and show the number of occurrences of each match when grouping unique matches.
- Totals after results, and grouped matches.: Show overall and per-file totals after the results, and show the number of occurrences of each match when grouping unique matches.
Sort Files
- First searched to last searched: Files are added to the bottom of the results as PowerGREP searches through them. Because PowerGREP processes files, disk drives, and network severs in parallel, this order is not deterministic.
- Last searched to first searched: Files are added to the top of the results as PowerGREP searches through them. Because PowerGREP processes files, disk drives, and network severs in parallel, this order is not deterministic.
- Alphanumeric: A..Z, 0..9: Sort files in ascending alphanumeric order of their full path names.
- Alphanumeric: Z..A, 9..0: Sort files in descending alphanumeric order of their full path names.
- By increasing totals: Sort files by the number of matches found in each file, from least to most.
- By decreasing totals: Sort files by the number of matches found in each file, from most to least.
- Newest to oldest: Sort files by the date and time they were last modified, from newest to oldest.
- Oldest to newest: Sort files by the date and time they were last modified, from oldest to newest.
Sort Matches
- Show in original order: Show matches in the order they have in the file they were found in.
- Alphabetic: A..Z: Sort matches alphabetically, from A to Z.
- Alphabetic:, Z..A: Sort matches alphabetically, from Z to A.
- Alphanumeric: A..Z, 0..9: Sort matches alphanumerically, from A to Z and from 0 to 9.
- Alphanumeric: Z..A, 9..0: Sort matches alphanumerically, from Z to A and from 9 to 0.
- By increasing totals: When grouping unique matches, sort them from least occurrences to most occurrences.
- By decreasing totals: When grouping unique matches, sort them from most occurrences to least occurrences.
If a line or block of context has more than one match, each line or block of context is shown only once with all matches highlighted if you choose "show in original order". If you choose any other sort option, lines or blocks of context with multiple matches are shown multiple times, each time with one search match highlighted, in the correct sorting position for each match.
Display Replacements
Determines how search matches and their replacements are displayed after a search-and-replace or collect action.
- Search match only: Display search matches, without their replacements.
- Replacement only: Display replacements instead of search matches.
- In-line match and replacement: Display both matches and replacements, next to each other.
- Separate match and replacement: Display matches and replacements separately. When showing context, the context is duplicated.