Kconv

Kconv (일본어 문자 코드 변환기)

Ruby용 일본어 문자 코드 변환기(Kanji Converter) 모듈이에요.

출처: Ruby 3.3 API

본문

Kconv는 일본어 문자 인코딩을 판별하고 변환하는 모듈이에요. 내부적으로 NKF를 활용해요.

Constants (상수)

Kconv가 제공하는 주요 상수는 다음과 같아요. 약칭과 가리키는 인코딩을 함께 보여줄게요.

ASCII — ASCII
AUTO — Auto-Detect (자동 판별)
BINARY — BINARY
EUC — EUC-JP
JIS — ISO-2022-JP
NOCONV — NOCONV (변환 없음)
SJIS — Shift_JIS
UNKNOWN — UNKNOWN (알 수 없음)
UTF16 — UTF-16
UTF32 — UTF-32
UTF8 — UTF-8

Public Class Methods

`guess(str) → encoding`

NKF.guess로 입력 인코딩을 추측해요.

`iseuc(str) → true or false`

입력 인코딩이 EUC-JP인지 여부를 돌려줘요. 참고로 이 반환값을 MatchData로 기대하지는 마세요.

`isjis(str) → true or false`

입력 인코딩이 ISO-2022-JP인지 여부를 돌려줘요.

`issjis(str) → true or false`

입력 인코딩이 Shift_JIS인지 여부를 돌려줘요.

`isutf8(str) → true or false`

입력 인코딩이 UTF-8인지 여부를 돌려줘요.

`kconv(str, to_enc, from_enc=nil)`

str을 to_enc로 변환해요. to_enc와 from_enc는 Kconv의 상수나 Encoding 객체로 주어요.

`toeuc(str) → string`

str을 EUC-JP로 변환해요.

`tojis(str) → string`

str을 ISO-2022-JP로 변환해요.

`tolocale → string`

self를 로케일(locale) 인코딩으로 변환해요.

`tosjis(str) → string`

str을 Shift_JIS로 변환해요.

`toutf16(str) → string`

str을 UTF-16으로 변환해요.

`toutf32(str) → string`

str을 UTF-32로 변환해요.

`toutf8(str) → string`

str을 UTF-8로 변환해요.

Private Instance Methods

클래스 메서드와 같은 이름·동작의 private 인스턴스 메서드들이 제공돼요. guess, iseuc, isjis, issjis, isutf8, kconv, toeuc, tojis, tolocale, tosjis, toutf16, toutf32, toutf8의 동작은 모두 위에서 설명한 클래스 메서드와 동일해요.