Search for text containing special characters Leave feedback

In the case where the search query must contain special characters that are not control characters, these characters must be escaped. The special characters are:

( ) : " & | ! ^ ~ * ? \ space

These characters can be escaped by adding a \ sign to the left of the character. For example:
\& - escaping & character;
\~ - escaping ~ character;
\s - escaping space character.
See Search operation table for detailes on search query syntax.

However, it must be remembered that if the escaped character is a separator, then it will still not be found in the text, since it is not indexed. And as a result, words containing such characters will also not be found when searching for an exact match.

If the search query contains separator characters, words containing these characters will not be found. Since, in fact, when indexing, these characters break the word into parts, and they themselves are deleted and not indexed. Therefore, when performing a search, the query must be checked for the content of separator characters. Each word containing such characters should be broken into several smaller words and form a search phrase.

The order of processing each word in a search query is as follows:

1. If separators are present in the word, they are replaced by spaces, and the word search is converted to a phrase search.
2. If special characters are present in the word, they are escaped.

const indexFolder = 'c:/MyIndex/';
const documentsFolder = 'c:/MyDocuments/';

// Creating an index in the specified folder
const index = new groupdocs.search.Index(indexFolder);

// Setting character types
const characters1 = java.newArray('char', ['&']);
const characters2 = java.newArray('char', ['-']);
index.getDictionaries().getAlphabet().setRange(characters1, groupdocs.search.CharacterType.Letter);
index.getDictionaries().getAlphabet().setRange(characters2, groupdocs.search.CharacterType.Separator);

// Indexing documents from the specified folder
index.add(documentsFolder);

// Defining a search query
const word = 'rock&roll-music';

// Replacing separators with the space characters
let result = '';
for (let i = 0; i < word.length; i++) {
  const character = word.charAt(i);
  const ch = java.newChar(character);
  const characterType = index.getDictionaries().getAlphabet().getCharacterType(ch);
  if (String(characterType) == String(groupdocs.search.CharacterType.Separator)) {
    result += ' ';
  } else {
    result += character;
  }
}

// Escaping special characters
const specialCharacters = '():"&|!^~*?\\';
for (let i = result.length - 1; i >= 0; i--) {
  const c = result.charAt(i);
  if (specialCharacters.indexOf(c) != -1) {
    result = result.slice(0, i) + '\\' + result.slice(i);
  }
}

let query = result.toString();
if (query.includes(' ')) {
  query = '"' + query + '"';
}

// Searching
const searchResult = index.search(query);

You may easily run the code from documentation articles and see the features in action in our GitHub examples:

• GroupDocs.Search for .NET examples

• GroupDocs.Search for Java examples

Along with full featured .NET library we provide simple, but powerful free Apps.

You are welcome to search over your PDF, DOC, DOCX, PPT, PPTX, XLS, XLSX and more with our free online Free Online Document Search App.