Kconv

Module

Kanji Converter for Ruby.

Constants

AUTO

Auto-Detect

JIS

ISO-2022-JP

EUC

EUC-JP

SJIS

Shift_JIS

UTF8

UTF-8

UTF16

UTF-16

UTF32

UTF-32

UNKNOWN

UNKNOWN

Class Methods

Kconv.guess(str) => encoding

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 141
def guess(str)
  ::NKF::guess(str)
end

Guess input encoding by NKF.guess

Kconv.iseuc(str) => true or false

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 156
def iseuc(str)
  str.dup.force_encoding(EUC).valid_encoding?
end

Returns whether input encoding is EUC-JP or not.

Note don’t expect this return value is MatchData.

Kconv.isjis(str) => true or false

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 174
def isjis(str)
  /\A [\t\n\r\x20-\x7E]*
    (?:
      (?:\x1b \x28 I      [\x21-\x7E]*
        |\x1b \x28 J      [\x21-\x7E]*
        |\x1b \x24 @      (?:[\x21-\x7E]{2})*
        |\x1b \x24 B      (?:[\x21-\x7E]{2})*
        |\x1b \x24 \x28 D (?:[\x21-\x7E]{2})*
      )*
      \x1b \x28 B [\t\n\r\x20-\x7E]*
    )*
   \z/nox =~ str.dup.force_encoding('BINARY') ? true : false
end

Returns whether input encoding is ISO-2022-JP or not.

Kconv.issjis(str) => true or false

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 165
def issjis(str)
  str.dup.force_encoding(SJIS).valid_encoding?
end

Returns whether input encoding is Shift_JIS or not.

Kconv.isutf8(str) => true or false

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 193
def isutf8(str)
  str.dup.force_encoding(UTF8).valid_encoding?
end

Returns whether input encoding is UTF-8 or not.

Kconv.kconv(str, to_enc, from_enc=nil)

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 57
def kconv(str, to_enc, from_enc=nil)
  opt = ''
  opt += ' --ic=' + from_enc.to_s if from_enc
  opt += ' --oc=' + to_enc.to_s if to_enc

  ::NKF::nkf(opt, str)
end

Convert str to to_enc. to_enc and from_enc are given as constants of Kconv or Encoding objects.

Kconv.toeuc(str) => string

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 83
def toeuc(str)
  kconv(str, EUC)
end

Convert str to EUC-JP

Kconv.tojis(str) => string

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 74
def tojis(str)
  kconv(str, JIS)
end

Convert str to ISO-2022-JP

Kconv.tolocale => string

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 128
def tolocale(str)
  kconv(str, Encoding.locale_charmap)
end

Convert self to locale encoding

Kconv.tosjis(str) => string

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 92
def tosjis(str)
  kconv(str, SJIS)
end

Convert str to Shift_JIS

Kconv.toutf16(str) => string

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 110
def toutf16(str)
  kconv(str, UTF16)
end

Convert str to UTF-16

Kconv.toutf32(str) => string

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 119
def toutf32(str)
  kconv(str, UTF32)
end

Convert str to UTF-32

Kconv.toutf8(str) => string

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 101
def toutf8(str)
  kconv(str, UTF8)
end

Convert str to UTF-8

Instance Methods

Kconv.guess(str) => encoding

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 141
def guess(str)
  ::NKF::guess(str)
end

Guess input encoding by NKF.guess

Kconv.iseuc(str) => true or false

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 156
def iseuc(str)
  str.dup.force_encoding(EUC).valid_encoding?
end

Returns whether input encoding is EUC-JP or not.

Note don’t expect this return value is MatchData.

Kconv.isjis(str) => true or false

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 174
def isjis(str)
  /\A [\t\n\r\x20-\x7E]*
    (?:
      (?:\x1b \x28 I      [\x21-\x7E]*
        |\x1b \x28 J      [\x21-\x7E]*
        |\x1b \x24 @      (?:[\x21-\x7E]{2})*
        |\x1b \x24 B      (?:[\x21-\x7E]{2})*
        |\x1b \x24 \x28 D (?:[\x21-\x7E]{2})*
      )*
      \x1b \x28 B [\t\n\r\x20-\x7E]*
    )*
   \z/nox =~ str.dup.force_encoding('BINARY') ? true : false
end

Returns whether input encoding is ISO-2022-JP or not.

Kconv.issjis(str) => true or false

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 165
def issjis(str)
  str.dup.force_encoding(SJIS).valid_encoding?
end

Returns whether input encoding is Shift_JIS or not.

Kconv.isutf8(str) => true or false

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 193
def isutf8(str)
  str.dup.force_encoding(UTF8).valid_encoding?
end

Returns whether input encoding is UTF-8 or not.

Kconv.kconv(str, to_enc, from_enc=nil)

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 57
def kconv(str, to_enc, from_enc=nil)
  opt = ''
  opt += ' --ic=' + from_enc.to_s if from_enc
  opt += ' --oc=' + to_enc.to_s if to_enc

  ::NKF::nkf(opt, str)
end

Convert str to to_enc. to_enc and from_enc are given as constants of Kconv or Encoding objects.

Kconv.toeuc(str) => string

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 83
def toeuc(str)
  kconv(str, EUC)
end

Convert str to EUC-JP

Kconv.tojis(str) => string

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 74
def tojis(str)
  kconv(str, JIS)
end

Convert str to ISO-2022-JP

Kconv.tolocale => string

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 128
def tolocale(str)
  kconv(str, Encoding.locale_charmap)
end

Convert self to locale encoding

Kconv.tosjis(str) => string

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 92
def tosjis(str)
  kconv(str, SJIS)
end

Convert str to Shift_JIS

Kconv.toutf16(str) => string

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 110
def toutf16(str)
  kconv(str, UTF16)
end

Convert str to UTF-16

Kconv.toutf32(str) => string

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 119
def toutf32(str)
  kconv(str, UTF32)
end

Convert str to UTF-32

Kconv.toutf8(str) => string

ext/nkf/lib/kconv.rb View on GitHub

          
            # File tmp/rubies/ruby-3.3.0/ext/nkf/lib/kconv.rb, line 101
def toutf8(str)
  kconv(str, UTF8)
end

Convert str to UTF-8