拼写

提供对一系列拼写检查后端以及单词建议的抽象访问。该API灵感来源于enchant,但也可以添加实现相同API的其他后端。

目前,除OSX外,所有平台上的拼写检查都需要`python-enchant`,而在OSX上则存在原生实现。

>>> from kivy.core.spelling import Spelling
>>> s = Spelling()
>>> s.list_languages()
['en', 'en_CA', 'en_GB', 'en_US']
>>> s.select_language('en_US')
>>> s.suggest('helo')
[u'hole', u'help', u'helot', u'hello', u'halo', u'hero', u'hell', u'held',
 u'helm', u'he-lo']
exception kivy.core.spelling.NoLanguageSelectedError[源代码]

基类:Exception

当调用使用语言的方法时,若之前未选择任何语言,则抛出此异常。

exception kivy.core.spelling.NoSuchLangError[源代码]

基类:Exception

当无法找到特定语言时,将引发此异常。

class kivy.core.spelling.SpellingBase(language=None)[源代码]

基类:object

所有拼写提供程序的基类。支持一些抽象方法,用于检查单词和获取建议。

check(word)[源代码]

如果 wordself._language`(当前激活的语言)中的有效单词,则返回 True。如果该单词不应被检查,则返回 None(例如对于 '')。如果它不是 `self._language 中的有效单词,则返回 False。

参数:
word:字符串

要检查的单词。

list_languages()[源代码]

返回所有支持的语言列表。例如:['en', 'en_GB', 'en_US', 'de', ...]

select_language(language)[源代码]

从已注册的语言集合中,为 language 选择第一种语言。

参数:
language: str

语言标识符。必须是list_languages()返回的选项之一。设置用于拼写检查和单词建议的语言。

suggest(fragment)[源代码]

对于给定的`fragment`(即单词的一部分或单词本身),提供更正(`fragment`可能拼写错误)或补全,以字符串列表的形式返回。

参数:
fragment:字符串

用于获取建议或更正提示的单词片段。例如,'foo' 可能变为 'of'、'food' 或 'foot'。