Struct UserDictionary 

pub struct UserDictionary { /* private fields */ }

사용자 정의 사전

사용자가 커스텀 단어를 추가하여 형태소 분석을 개선할 수 있습니다.

Implementations

impl UserDictionary

pub fn new() -> UserDictionary

새 사용자 사전 생성

pub const fn with_default_cost(self, cost: i16) -> UserDictionary

기본 비용 설정

pub fn add_entry( &mut self, surface: impl Into<String>, pos: impl Into<String>, cost: Option<i16>, reading: Option<String>, ) -> &mut UserDictionary

엔트리 추가

Arguments

• surface - 표면형
• pos - 품사 태그 (예: “NNG”, “NNP”, “VV”)
• cost - 비용 (낮을수록 우선, None이면 기본값 사용)
• reading - 읽기 (발음, 선택)

pub fn add_entry_with_ids( &mut self, surface: impl Into<String>, pos: impl Into<String>, cost: i16, left_id: u16, right_id: u16, reading: Option<String>, ) -> &mut UserDictionary

컨텍스트 ID와 함께 엔트리 추가

pub fn load_from_csv<P>( &mut self, path: P, ) -> Result<&mut UserDictionary, DictError>

where P: AsRef<Path>,

CSV 파일에서 사전 로드

포맷

# 주석 라인
표면형,품사,비용,읽기

• 표면형: 필수
• 품사: 필수 (예: NNG, NNP, VV)
• 비용: 선택 (기본값: -1000)
• 읽기: 선택

Errors

파일을 읽거나 파싱할 수 없는 경우 에러를 반환합니다.

pub fn load_from_str( &mut self, content: &str, ) -> Result<&mut UserDictionary, DictError>

CSV 문자열에서 사전 로드

Errors

파싱 오류가 발생한 경우 에러를 반환합니다.

pub fn lookup(&self, surface: &str) -> Vec<&UserEntry>

표면형으로 엔트리 검색

pub fn common_prefix_search(&self, text: &str) -> Vec<&UserEntry>

공통 접두사 검색

주어진 텍스트의 접두사와 일치하는 모든 엔트리를 찾습니다.

Arguments

• text - 검색할 텍스트

Returns

일치하는 엔트리의 벡터

pub fn entries(&self) -> &[UserEntry]

모든 엔트리 반환

pub fn len(&self) -> usize

엔트리 수 반환

pub fn is_empty(&self) -> bool

사전이 비어있는지 확인

pub fn build_trie(&mut self) -> Result<&[u8], DictError>

Trie 빌드

사전 검색을 위한 Double-Array Trie를 빌드합니다.

Errors

사전이 비어있거나 Trie 빌드에 실패한 경우 에러를 반환합니다.

pub fn get_trie(&self) -> Option<Trie<'_>>

빌드된 Trie 가져오기

pub fn to_entries(&self) -> Vec<Entry>

Entry 목록으로 변환

pub fn clear(&mut self)

사전 초기화 (모든 엔트리 제거)

pub fn validate(&self) -> ValidationResult

사전 검증

모든 엔트리의 유효성을 검사합니다.

Returns

검증 결과와 발견된 문제점 목록

pub fn remove_duplicates(&mut self)

중복 엔트리 제거

같은 표면형과 품사를 가진 엔트리 중 첫 번째만 유지합니다.

pub fn remove_surface(&mut self, surface: &str) -> usize

특정 표면형의 엔트리 삭제

Returns

삭제된 엔트리 수

pub fn check_csv_duplicates<P>( path: P, ) -> Result<Vec<(usize, String, String)>, DictError>

where P: AsRef<Path>,

CSV 파일 중복 검사 (파일 로드 전 검사)

Arguments

• path - CSV 파일 경로

Returns

중복된 엔트리 목록 (라인 번호, 표면형, 품사)

Errors

파일을 읽을 수 없는 경우 에러를 반환합니다.

pub fn add_entry_auto_pos( &mut self, surface: impl Into<String>, cost: Option<i16>, reading: Option<String>, ) -> &mut UserDictionary

자동 품사 추정을 사용하여 엔트리 추가

표면형만 제공하면 품사를 자동으로 추정합니다.

pub fn check_system_conflicts<S>( &self, system_surfaces: &HashSet<String, S>, ) -> Vec<(usize, String, String)>

where S: BuildHasher,

시스템 사전과 충돌 검사

시스템 사전에 이미 존재하는 표면형을 찾습니다.

Arguments

• system_surfaces - 시스템 사전의 표면형 집합

Returns

충돌하는 엔트리 목록 (인덱스, 표면형, 품사)

pub fn stats(&self) -> DictionaryStats

통계 정보 반환

pub fn save_to_csv<P>(&self, path: P) -> Result<(), DictError>

where P: AsRef<Path>,

파일로 저장 (CSV 형식)

Errors

파일을 쓸 수 없는 경우 에러를 반환합니다.

Trait Implementations

impl Clone for UserDictionary

fn clone(&self) -> UserDictionary

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for UserDictionary

fn default() -> UserDictionary

Returns the “default value” for a type.