goldendict-ng/winlibs/include/opencc/Dict.hpp

/*
 * Open Chinese Convert
 *
 * Copyright 2010-2014 BYVoid <byvoid@byvoid.com>
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#pragma once

#include "Common.hpp"
#include "DictEntry.hpp"

namespace opencc {
/**
* Abstract class of dictionary
* @ingroup opencc_cpp_api
*/
class OPENCC_EXPORT Dict {
public:
  /**
  * Matches a word exactly and returns the DictEntry or Optional::Null().
  */
  virtual Optional<const DictEntry*> Match(const char* word) const = 0;

  /**
  * Matches a word exactly and returns the DictEntry or Optional::Null().
  */
  Optional<const DictEntry*> Match(const string& word) const {
    return Match(word.c_str());
  }

  /**
  * Matches the longest matched prefix of a word.
  * For example given a dictionary having "a", "an", "b", "ba", "ban", "bana",
  * the longest prefix of "banana" matched is "bana".
  */
  virtual Optional<const DictEntry*> MatchPrefix(const char* word) const;

  /**
  * Matches the longest matched prefix of a word.
  */
  Optional<const DictEntry*> MatchPrefix(const string& word) const {
    return MatchPrefix(word.c_str());
  }

  /**
  * Returns all matched prefixes of a word, sorted by the length (desc).
  * For example given a dictionary having "a", "an", "b", "ba", "ban", "bana",
  * all the matched prefixes of "banana" are "bana", "ban", "ba", "b".
  */
  virtual vector<const DictEntry*> MatchAllPrefixes(const char* word) const;

  /**
  * Returns all matched prefixes of a word, sorted by the length (desc).
  */
  vector<const DictEntry*> MatchAllPrefixes(const string& word) const {
    return MatchAllPrefixes(word.c_str());
  }

  /**
  * Returns the length of the longest key in the dictionary.
  */
  virtual size_t KeyMaxLength() const = 0;

  /**
  * Returns all entries in the dictionary.
  */
  virtual LexiconPtr GetLexicon() const = 0;
};
}