Search: Difference between revisions
(Added info about search patterns matching against folders, changed info about traverse filters, added some examples.) |
(→General tab: Adjustments due to changes in TC 11.50) |
||
(2 intermediate revisions by the same user not shown) | |||
Line 14: | Line 14: | ||
{| class="wikitable" | {| class="wikitable" | ||
|+ style="text-align: left;" | Options for searching for file/folder names | |+ style="text-align: left;" | Options for searching for file/folder names | ||
|- | |- | ||
Line 65: | Line 64: | ||
* If the search text contains a backslash (unless in search locations) or pipe character, (b) won't apply or give any results. | * If the search text contains a backslash (unless in search locations) or pipe character, (b) won't apply or give any results. | ||
* Spaces act as separators, unless contained within quotes. | * Spaces act as separators, unless contained within quotes. | ||
* Wildcard ? stands for exactly one character, wildcard * for any number of characters. | * Wildcard ? stands for exactly one character, wildcard * for any number of characters. The special wildcard \**\ can be used in paths and stands for any number of subfolders. | ||
* Exclude masks can be specified after a pipe character.<br /><!-- | * Exclude masks can be specified after a pipe character.<br /><!-- | ||
-->For example, to exclude txt files from the search results use: <code><nowiki>|</nowiki> *.txt</code> | -->For example, to exclude txt files from the search results use: <code><nowiki>|</nowiki> *.txt</code><br /><!-- | ||
* A search pattern to match against file/folder names can include a pattern to match against parent folders that were traversed into during the search. A backslash at the beginning matches the folder at the start of the search. Wildcards are also allowed | -->Since TC 11.50 you can use <code><nowiki>|</nowiki> \</code> to exclude results from the folder at the start of the search (only subfolders are searched). | ||
* Traverse filters are expressions in the search text ending with a backslash. They limit the folders that are traversed into and are are often used in the exclude section after a pipe character. Each traversed folder during the search is checked against these filters. A filter starting with a backslash applies to the search location only, not subfolders. Wildcards are also allowed, as well as nested folders ( | * A search pattern to match against file/folder names can include a pattern to match against parent folders that were traversed into during the search. A backslash at the beginning matches the folder at the start of the search. Wildcards are also allowed. | ||
* Traverse filters are expressions in the search text ending with a backslash. They limit the folders that are traversed into and are are often used in the exclude section after a pipe character. Each traversed folder during the search is checked against these filters. A filter starting with a backslash applies to the search location only, not subfolders. Wildcards are also allowed, as well as nested folders (prior to TC 11.50 the latter was only meaningful when used in an exclude section<sup> [https://www.ghisler.ch/board/viewtopic.php?p=420344#p420344])</sup>. | |||
''Examples'' | ''Examples'' | ||
Line 166: | Line 166: | ||
{| class="wikitable" | {| class="wikitable" | ||
|+ style="text-align: left;" | Options for searching file content | |+ style="text-align: left;" | Options for searching file content | ||
|- | |- | ||
Line 223: | Line 222: | ||
* Perform actions like ''Go to file'' and ''Feed to listbox'' on the search results. | * Perform actions like ''Go to file'' and ''Feed to listbox'' on the search results. | ||
* Search within the search results. | * Search within the search results. | ||
== Examples == | |||
{| class="wikitable" | |||
|+ Search text examples | |||
|- | |||
! style="text-align:left;" | Search text | |||
! style="text-align:left;" | Description | |||
|- style="vertical-align:top;" | |||
| text | |||
| Search for files/folders with "text" anywhere in the name. | |||
|- style="vertical-align:top;" | |||
| text moretext<br /><!-- | |||
-->"text moretext"<br /><!-- | |||
-->"text more"text | |||
| Search for files/folders with "text moretext" anywhere in the name. | |||
|- style="vertical-align:top;" | |||
| c:\;d:\text moretext | |||
| Search drive c: and d: for files/folders with "text moretext" anywhere in the name. | |||
|- style="vertical-align:top;" | |||
| c:\;d:\text moretext. | |||
| Search drive c: and d: for files/folders with name "text" or "moretext" or "text moretext". | |||
|- style="vertical-align:top;" | |||
| c:\;d:\"text moretest." | |||
| Search drive c: and d: for files/folders with name "text moretext". | |||
|- style="vertical-align:top;" | |||
| \<br /><!-- | |||
-->\ *<br /><!-- | |||
-->\ *.*<br /><!-- | |||
--><nowiki>|</nowiki> *\<br /><!-- | |||
--><nowiki>|</nowiki> \*\<br /><!-- | |||
-->* <nowiki>|</nowiki> \*\<br /><!-- | |||
-->*.* <nowiki>|</nowiki> \*\ | |||
| Search all files/folders in search folder only (do not traverse subfolders). | |||
|- style="vertical-align:top;" | |||
| \* | |||
| Search all files/folders in search folder only (slow, traverse all subfolders but only show results of search folder). | |||
|- style="vertical-align:top;" | |||
| <nowiki>|</nowiki>\* | |||
| Search all files/folders in subfolders only (exclude results of search folder). | |||
|} | |||
== See also == | == See also == |
Latest revision as of 15:23, 8 December 2024
Search in Total Commander allows users to search for files and folders within their system. The search feature has lots of options, which are divided over the tabs: General, Advanced, Plugins, Load/Save. The user can utilize options from multiple tabs and then start the search. After starting a search, the results will populate a search result panel at the bottom.
The search feature has several options to utilize the tool Everything (indexing and search tool), for very fast results.
Opening the search function
The search function in Total Commander can be opened through the following methods:
- Menu option: Commands/Search
- Hotkey: Alt+F7
- Button bar: Search button
- Internal command: cm_SearchFor
General tab
This tab provides options to configure the search for filenames, parts of filenames, text inside files, and text inside content plugin properties. The various options and input fields are explained below.
Search for |
The "Search for" field contains the search text. The search text not only determines what is searched, but also the search mode as explained in the table below.
| ||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Search in | The "Search in" field allows you to do one of the following:
Searching using a search list
When "Search subdirectories" is set to 1 level or more
When "Search subdirectories" is set to "current dir only"
Search list example
| ||||||||||||||||||||||||||||||||||||
Drives | Select the drive(s) you want to search. You can select multiple drives. | ||||||||||||||||||||||||||||||||||||
RegEx | Search in file names using regular expressions. | ||||||||||||||||||||||||||||||||||||
Only search in selected directories/files | Restrict the search to folders and files that have been selected in Total Commander's active file panel. | ||||||||||||||||||||||||||||||||||||
'Everything' | Use the program 'Everything' to search NTFS-formatted drives. | ||||||||||||||||||||||||||||||||||||
Search archives | Also search within archives.
| ||||||||||||||||||||||||||||||||||||
Search in subdirectories | Choose where to search: all subfolders, current folder only, or up to a set depth from the current folder. |
Find text | If checked, you can enter text to be searched.
Notes
|
---|---|
Whole words only | Limit the search to whole words only. |
Case sensitive | Enable case sensitive searching. |
RegEx (2) | Search in file contents using regular expressions. |
Hex | Search for hexadecimal characters. |
Find files NOT containing the text | Search for all files that do not contain the search text. |
ANSI-Charset (Windows) | Assume files are encoded using the Windows charset with the default language encoding. |
ASCII-Charset (DOS) | Assume ASCII files. Special characters in the search text, like the pound sign (£), are translated to their DOS equivalents. |
Unicode UTF-16 | Assume Unicode files where each letter is coded by 2 bytes. |
UTF8 | Assume UTF-8-encoded Unicode files where each letter is coded by 1 up to 4 bytes. |
Office xml (docx, xlsx, odt etc) + EPUB | Search in Microsoft Office, OpenOffice/LibreOffice, and EPUB files. |
Plugins | Search in content plugin properties for the text given in "Find text". |
Advanced tab
Plugins tab
Load/save tab
Search results
Search results are displayed in the search result panel. Users can perform various actions on these results:
- View or edit found files, even while the search is ongoing.
- Copy results to the clipboard with Ctrl+C after the search has finished.
- Perform actions like Go to file and Feed to listbox on the search results.
- Search within the search results.
Examples
Search text | Description |
---|---|
text | Search for files/folders with "text" anywhere in the name. |
text moretext "text moretext" "text more"text |
Search for files/folders with "text moretext" anywhere in the name. |
c:\;d:\text moretext | Search drive c: and d: for files/folders with "text moretext" anywhere in the name. |
c:\;d:\text moretext. | Search drive c: and d: for files/folders with name "text" or "moretext" or "text moretext". |
c:\;d:\"text moretest." | Search drive c: and d: for files/folders with name "text moretext". |
\ \ * \ *.* | *\ | \*\ * | \*\ *.* | \*\ |
Search all files/folders in search folder only (do not traverse subfolders). |
\* | Search all files/folders in search folder only (slow, traverse all subfolders but only show results of search folder). |
|\* | Search all files/folders in subfolders only (exclude results of search folder). |