form

Purpose

Finds documents that contain exact occurrences of the arguments.

Syntax

form([grammatical_value],term,…​)

Arguments

The first optional argument grammatical_value indicates required part-of-speech and accepts the values listed below:

part-of-speech

synonym

description

examples

noun

matches nouns

event, events, conference, conferences …​

verb

matches verbs

talk, talked, talks, meets …​

adverb

advb

matches adverbs

well, generally, above …​

adjective

adjc

matches adjectives

quick, important, general …​

particle

prcl

matches particles

not, the …​

pronoun

pron

matches pronouns

they, you, she, himself, me, her …​

numeral

nmrl

numerals

one, hundred …​

article

arcl

articles

a, an, the …​

preposition

prep

prepositions

of, to, in, at …​

interjection

intj

interjections

uh, wow …​

conjunction

conj

conjunctions

and, if …​

Optionally, the parameter specifies one or more additional grammatical values such as number, gender, tense, voice, etc. The most frequently-used grammatical values are listed below (full list of supported grammatical values is available on "Info" tab of the Text Tagger node):

grammatical value

synonym

description

examples

singular

sing, sg

matches singular number words

event, conference, he, she, I …​

plural

plur, pl

matches plural number words

events, conferences, they …​

masculine

masc

matches masculine gender words

man, men, John, John’s, he, himself …​

feminine

femn

matches feminine gender words

woman, women, Julia, Julia’s …​

nominative

nomn

matches nominative case words

event, events, Julia, John …​

genitive

gent

matches genitive case words

event’s, Julia’s, John’s …​

accusative

acc

matches accusative case words

me, her …​

animate

anim

matches animate nouns or pronouns

Julia, Julia’s, man, men, John, John’s …​

inanimate

inan

matches inanimate nouns or pronouns

event, conferences, it …​

proper

matches proper nouns

London, Julia, Julia’s, John, John’s …​

comparative

matches comparative adjectives

better, easier …​

superlative

matches superlative adjectives

best, easiest …​

participle

vprt

matches participles

doing, done …​

modal

modl

matches modal verbs

can …​

…​

Grammatical values should be concatenated via underscores:

form(noun_animate_singular) matches all animate nouns in singular number only

Grammatical values can be concatenated in arbitrary order:

form(noun_animate_singular) = form(noun_singular_animate) = form(singular_noun_animate), etc.

Grammatical values can be also combined via "|" operator:

form(noun|verb) matches all nouns or verbs.

If the grammatical value is specified, arguments can be omitted. In this case function matches all tokens with a required grammatical value.

Note

Enclosing a search term in square brackets is equivalent to the form() function. The only difference is that it’s impossible to specify a part-of-speech or grammatical value using the [] syntax.

Returned Value

Documents matching the query.

Examples

form(result) = [result] matches result but not results;

form(answered) = [answered] = matches only the form "answered" but not "answer", "answering", etc.;

form(noun, rose) matches "red rose", while form(verb, rose) matches "revenue rose 10%";

form(verb) matches all verbs.