dictword

Purpose

Finds documents that contain words from a specified dictionary. This function is an alias for knownword() function.

Syntax

dictword(dictionary_category [, dictionary_name])

Arguments

The function accepts several arguments.

dict_category is a required argument that specifies dictionary category. The argument is case-insensitive and accepts following values:

  • Companies

  • GeoAdministrative

  • HumanNames

  • Morphology

  • Organizations

  • Phrases

  • Statistics

  • Synonyms

  • StopLists

  • WordClasses

  • UserDictionary

dict_name is an optional argument that specifies the dictionary to look up. If the argument is omitted, all dictionaries of the specified category are looked up. Instead of the dict_name argument, one can use the named parameter dict.

Thus, dictword(Morphology, Default) = dictword(Morphology, dict:=Default).

Moreover, dictword(WordClasses) supports the parameter сlass, which specifies an entry in a dictionary of the WordClasses. It is possible to list several entries using a vertical bar, for example, dictword(WordClasses, сlass:=positive|negaive).

The function may also contain optional filter expressions that apply filter on dictionary column to keep only entries that satisfy the filter criteria. Filter expression has the following syntax: name operator expression.

Name refers to the dictionary column on which filter is being applied. Dictionary columns that support filtering are listed in the table below:

Dictionary category

Column

Possible values

Examples

Companies/Organizations

Type

see dictionary entry form

dictword(companies, Type:=LLC|LLP)

Country

see dictionary entry form

dictword(companies, Country:=Germany|Italy)

Industry

see dictionary entry form

dictword(companies, Industry:=insurance)

field

Name, ShortName, AlternativeName, Country, Type, Industry

dictword(companies, field:=ShortName)

Geoadministrative

Category

continent, country, region, city

dictword(geoadministrative, Category:=country)

WorldPart

see dictionary entry form

dictword(geoadministrative, Category:=country, WorldPart:!=Asia)

Country

see dictionary entry form

dictword(geoadministrative, Category:=city, Country:=Germany|Italy)

Region

see dictionary entry form

dictword(geoadministrative, Category:=city, Region:=California)

Population

non-negative integer

dictword(geoadministrative, Category:=city, Population:>100000)

field

Name, CityAdministrationUnit, City, Comune, Subregion, Region, Macroregion, Country, WorldPart, Abbreviation

dictword(geoadministrative, field:=City)

HumanNames

Type

first name, surname

dictword(humannames, Type:=first name)

Gender

male, female

dictword(humannames, Gender:=female)

field

Name, ShortName

dictword(humannames, field:=ShortName)

Statistics

Support

non-negative integer

dictword(statistics, Support:<100)

Frequency

non-negative integer

dictword(statistics, Frequency:>10000)

SupportTotal

non-negative integer

dictword(statistics, SupportTotal:<100)

FrequencyTotal

non-negative integer

dictword(statistics, FrequencyTotal:>10000)

Operator refers to one of the following operators:

  • =

  • <

  • >

  • !=

  • <=

  • >=

Possible values for the filter are displayed in the respective drop down list on dictionary entry form. Alternative values must be separated by a vertical bar ("|").

Filter expression must be enclosed in quotes. If multiple filter expressions are set, only dictionary entries that satisfy all criteria are matched.

The function also supports optional named parameters:

  • allow_punct:=yes/no allows or prohibits punctuation between arguments (set to "yes" by default);

  • allow_space:=yes/no allows or prohibits spaces between arguments (set to "yes" by default).

  • match:=range extracts a dictionary entry as a whole fragment of text, punctuation marks included.

Returned Value

Documents matching the query.

Examples

dictword(GeoAdministrative, Category:=city, Country:=united states|mexico) - returns all Mexican and American cities according to the dictionaries of GeoAdministrative category, e.g. "Seattle", "Chicago", "Mexico";

dictword(HumanNames, Type:=first name) returns first names;

dictword(Organizations, Default, Type:!=government agency) returns all organizations but government agencies.