src/SpellChecker.h

   1 // -*- C++ -*-
   2 /**
   3  * \file SpellChecker.h
   4  * This file is part of LyX, the document processor.
   5  * Licence details can be found in the file COPYING.
   6  *
   7  * \author unknown
   8  * \author John Levon
   9  *
  10  * Full author contact details are available in file CREDITS.
  11  */
  12
  13 #ifndef SPELL_BASE_H
  14 #define SPELL_BASE_H
  15
  16 #include "support/strfwd.h"
  17
  18
  19 namespace lyx {
  20
  21 class BufferParams;
  22 class Language;
  23 class WordLangTuple;
  24 class docstring_list;
  25
  26 /**
  27  * Pure virtual base class of all spellchecker implementations.
  28  */
  29 class SpellChecker {
  30 public:
  31
  32         /// the result from checking a single word
  33         enum Result  {
  34                 /// word is correct
  35                 WORD_OK = 1,
  36                 /// root of given word was found
  37                 ROOT_FOUND,
  38                 /// word found through compound formation
  39                 COMPOUND_WORD,
  40                 /// word not found
  41                 UNKNOWN_WORD,
  42                 /// number of other ignored "word"
  43                 IGNORED_WORD,
  44                 /// number of personal dictionary "word"
  45                 LEARNED_WORD
  46         };
  47
  48         virtual ~SpellChecker() {}
  49
  50         /// does the spell check failed
  51         static bool misspelled(Result res) {
  52                 return res != SpellChecker::WORD_OK
  53                         && res != SpellChecker::IGNORED_WORD
  54                         && res != SpellChecker::LEARNED_WORD; }
  55
  56         /// check the given word of the given lang code and return the result
  57         virtual enum Result check(WordLangTuple const &) = 0;
  58
  59         /// Gives suggestions.
  60         virtual void suggest(WordLangTuple const &, docstring_list & suggestions) = 0;
  61
  62         /// insert the given word into the personal dictionary
  63         virtual void insert(WordLangTuple const &) = 0;
  64
  65         /// remove the given word from the personal dictionary
  66         virtual void remove(WordLangTuple const &) = 0;
  67
  68         /// accept the given word temporarily
  69         virtual void accept(WordLangTuple const &) = 0;
  70
  71         /// check if dictionary exists
  72         virtual bool hasDictionary(Language const *) const = 0;
  73
  74         /// give an error message on messy exit
  75         virtual docstring const error() = 0;
  76 };
  77
  78 /// Access to the singleton SpellChecker.
  79 /// Implemented in LyX.cpp
  80 SpellChecker * theSpellChecker();
  81
  82 /// Set the singleton SpellChecker engine.
  83 /// Implemented in LyX.cpp
  84 void setSpellChecker();
  85
  86 } // namespace lyx
  87
  88 #endif // SPELL_BASE_H