Package 'cidian'

Convert a dictionary to a data frame

Description

Convert a dictionary to a data frame

Usage

## S3 method for class 'cidian_dictionary'
as.data.frame(x, ...)

Arguments

x	A cidian_dictionary object.
...	Must be empty.

Value

A base data.frame with word, code, and weight columns. code is a list-column of character vectors and weight is numeric.

Examples

## Not run: 
dictionary <- read_cidian("computer.qcel")
as.data.frame(dictionary)

## End(Not run)

---

Extract dictionary entries

Description

Extract dictionary entries

Usage

cidian_entries(x)

Arguments

x	A cidian_dictionary object.

Value

A base data.frame with word, code, and weight columns. code is a list-column of character vectors and weight is numeric.

Examples

## Not run: 
dictionary <- read_cidian("computer.qcel")
cidian_entries(dictionary)

## End(Not run)

---

List supported dictionary formats

Description

List supported dictionary formats

Usage

cidian_formats()

Value

A character vector of format identifiers accepted by read_cidian().

Examples

cidian_formats()

---

Extract dictionary metadata

Description

Extract dictionary metadata

Usage

cidian_metadata(x)

Arguments

x	A cidian_dictionary object.

Value

A list with name, category, description, and extra fields.

Examples

## Not run: 
dictionary <- read_cidian("computer.qcel")
cidian_metadata(dictionary)

## End(Not run)

---

Print a dictionary summary

Description

Print a dictionary summary

Usage

## S3 method for class 'cidian_dictionary'
print(x, ...)

Arguments

x	A cidian_dictionary object.
...	Must be empty.

Examples

## Not run: 
dictionary <- read_cidian("computer.qcel")
print(dictionary)

## End(Not run)

---

Read a Chinese input-method dictionary

Description

read_cidian() reads a supported binary dictionary and returns a common cidian_dictionary object. The parser preserves source order and does not normalize, sort, or deduplicate entries.

Usage

read_cidian(path, ..., format = c("scel", "qcel", "qpyd", "bdict", "bcd"))

Arguments

path	A path to a dictionary file.
...	Must be empty.
format	A format name, with or without a leading dot. Supported values are "scel", "qcel", "qpyd", "bdict", and "bcd".

Details

The format is inferred from the file extension when format is omitted or NULL. Supply format when the file has no extension or its extension is wrong.

Value

A cidian_dictionary object containing metadata, entries, and format fields. The entries$code column is a list-column of character vectors, and entries$weight is a numeric vector.

Examples

## Not run: 
dictionary <- read_cidian("computer.qcel")
dictionary
as.data.frame(dictionary)

## End(Not run)

---

Summarize a dictionary

Description

Summarize a dictionary

Usage

## S3 method for class 'cidian_dictionary'
summary(object, ...)

Arguments

object	A cidian_dictionary object.
...	Must be empty.

Value

An object of class summary.cidian_dictionary containing the format, metadata, entry count, and number of weighted entries.

Examples

## Not run: 
dictionary <- read_cidian("computer.qcel")
summary(dictionary)

## End(Not run)

---

Write dictionary entries to a text file

Description

write_words() writes the word of every entry in x to path, one word per line, preserving the source order.

Usage

write_words(x, path, ..., overwrite = NULL)

Arguments

x	A cidian_dictionary object.
path	A path to the output file.
...	Must be empty.
overwrite	Whether to replace path when it already exists. NULL (the default) asks interactively; TRUE overwrites without asking; FALSE errors.

Details

When path already exists, the function asks for confirmation unless overwrite is given explicitly.

Value

The path, invisibly.

Examples

## Not run: 
dictionary <- read_cidian("computer.qcel")
write_words(dictionary, "words.txt")

## End(Not run)

---