count_ngrams: Count n-grams from segmented text

In jiebaRS: Chinese Text Segmentation, POS Tagging, and Keyword Extraction

Count n-grams from segmented text

Description

Count contiguous n-grams from a segmented character vector or from each element of a list of segmented character vectors.

Usage

count_ngrams(
  x,
  ...,
  n = 2,
  sep = " ",
  sort = TRUE,
  format = c("data.frame", "vector")
)

Arguments

x	A character vector of tokens or a list of character vectors.
...	Must be empty. This enforces that optional arguments such as n, sep, sort, and format are supplied with explicit names.
n	A positive integer or integer vector giving the n-gram sizes to count. The default is 2. If n is a integer vector of length > 1, n-grams of all specified sizes will be counted.
sep	Separator inserted between tokens when constructing the n-gram label. The default is " ", a single space.
sort	Whether to sort results by descending frequency. The default is TRUE. If FALSE, results keep first-appearance order within each requested n.
format	Output format. "data.frame" returns a data frame with term, n, and count columns. "vector" returns a named integer vector using the n-gram terms as names.

Details

Use n to select one or more n-gram sizes, and sep to control how tokens are joined in the returned term labels.

Value

N-gram counts in the requested format.

Examples

count_ngrams(c("\u6211", "\u7231", "R"), n = 2)
count_ngrams(c("\u6211", "\u7231", "R"), n = 1:2, format = "data.frame")
count_ngrams(c("a", "b", "b", "b", "a"), n = 1, sort = FALSE)
count_ngrams(list(c("a", "b", "c"), c("a", "b")), n = 2)

jiebaRS documentation built on Oct. 13, 2026, 5:07 p.m.