Searching for symbols

This topic describes how to make symbols searchable in a dtSearch index and how to use regular expressions to search for certain symbols reserved as search operators, such as the % sign.

Searching for symbols

To search for symbols, perform the following steps:

  1. Create a dtSearch index.
  2. Update the alphabet file to include the % sign as an indexed character:
    1. Enter the following under [Letters] // Original letter, lower case, upper case, unaccented:
      1. [Space] [%] [Space] [%] [Space] [%] [Space] [%]

        Note: You must have a leading space. You cannot have a trailing space.

        Alphabet file with symbols

    2. Delete the % sign from the [Ignore] section. Take care not to remove the gray boxes, which represent non-printable characters. Removing them may break the index.

      Before:

      After:

    3. Repeat these steps for any other symbols that you need to make indexed. Delete the appropriate symbols from the [Spaces], [Ignore], or [Hyphens] sections. Please note, if you edit the hyphen, space, or ignore section, you will need to also keep the leading space. Removal of leading spaces will cause errors in Relativity.
  3. Perform a full build of the dtSearch index.

You can now search for terms containing the % sign using a regular expression. For example, if you need to search for documents that contain the term 75%, you would enter the following in your search box (ensuring you select the proper dtSearch index):

"##75\u0025"

To break this regular expression down:

  • ## signals to Relativity to treat the string as a regular expression
  • \u indicates a search using a character's Unicode value (to follow in the next four characters)
  • 0025 indicates the hexadecimal Unicode value for the % sign.

Note: For most symbols, once you have indexed the character in the alphabet file, you can type them directly into the dtSearch box without using regular expressions. Thus to search for 30!, enter 30! into the dtSearch box after you have made ! an indexed character. You only need to employ RegEx for certain symbols.

For characters outside of the ASCII code range, such as § and £, you cannot make them searchable by adding them to the letters section. Instead, create an AdditionalLetters section at the bottom of the alphabet file and insert the characters' Unicode value.

Searching for emojis

Relativity supports searching for emojis with dtSearch indexes. Before searching for emojis, you must update the Alphabet list, then rebuild the search index. Follow the steps below the image to update the Alphabet list and run emoji searches.

Note: Emoji search works with file formats that store emojis as Unicode characters, such as Word documents and emails. File formats that store emojis in other formats, such as storing the emoji name, are currently not supported. Some examples include messages from Slack and Teams.

To update the Alphabet list with the emoji character string:

  1. Navigate to the Search Indexes page for your workspace.
  2. Create a new dtSearch index or edit an existing dtSearch index. For information on creating a new dtSearch index, see Creating a dtSearch index.
  3. Navigate to the Alphabet tab located in the Advanced Settings section.
  4. Scroll to the end of the Alphabet list until you see the [End] tag. Add the following string under any existing strings:
    TokenCharRanges32 = 1f000-1f0ff 1f300-1f6ff 1f700-1f77f 1f900-1f9ff

    Alphabet string for emojis

  5. Click Save.
  6. From the dtSearch Index panel on the right side of your screen, click Build Full Index.

    dtSearch Index Build Full Index Button

  7. Click Yes on the confirmation message.
  8. When the build completes, navigate to the Documents tab.

To run emoji searches:

  1. Enter an emoji in the search box and click ENTER.Your search results appear in the document list.

    Note: You can copy, then paste an existing emoji, or use the appropriate shortcut keys for your operating system. For example, in Windows, click the Windows Key Windows Key + period (.) to open the emoji sampler.

Symbol searching quick reference

Use the following table to quickly reference how to search for special characters. Note that you can search for the ampersand symbol without using RegEx with an escape character.

Symbols Directions Example search term Example search string
$ & @ \ / + , . ; - ' ` ! < > { } ^ _ { } | Update the alphabet file and search.
  • $75
  • @75
  • $75
  • @75
? * ( ) # = Update the alphabet file and use RegEx with an escape character (\).
  • #75
  • 75?
  • "##\#75"
  • "##75\?"
" % : ~

Update the alphabet file and use RegEx with the hexadecimal Unicode value.

  • 75~
  • "##75\u007e"
Characters outside the ASCII code range such as § and £ Create an AdditionalLetters section at the bottom of the alphabet file and insert the character's Unicode value.
  • £75
  • £75