Module: BaseHangul::Utils

Defined in:
lib/basehangul/utils.rb

Overview

Helper methods for BaseHangul.

Class Method Summary collapse

Class Method Details

.chunks(str, size) ⇒ Object

Slice a string into chunks of a given size.

str - The String to slice. size - The Integer max size of each chunk.

Returns an Array of chunked Strings. Raises ArgumentError if the size is smaller then or equal to 0.



43
44
45
46
47
48
49
 
# File 'lib/basehangul/utils.rb', line 43

def self.chunks(str, size)
  fail ArgumentError, 'Invalid slice size' if size <= 0
  new_str = str.dup
  array = []
  array << new_str.slice!(0...size) until new_str.empty?
  array
end

.to_hangul(index) ⇒ Object

Convert a index to hangul character.

index - An Integer to convert.

Returns the String hangul for given index. Raises IndexError if the index is out of range 0..1027.



28
29
30
31
32
33
34
 
# File 'lib/basehangul/utils.rb', line 28

def self.to_hangul(index)
  if index < 0 || index > 1027
    fail IndexError, "Index #{index} outside of valid range: 0..1027"
  end
  (index / 0x5E * 0x100 + index % 0x5E + 0xB0A1).chr(Encoding::EUC_KR)
    .encode(Encoding::UTF_8)
end

.to_index(hangul) ⇒ Object

Convert a hangul character to index.

hangul - A hangul character encoded with BaseHangul.

Returns the Integer index of the hangul between 0 to 1027. Raises ArgumentError if the character is not valid for BaseHangul.



12
13
14
15
16
17
18
19
20
 
# File 'lib/basehangul/utils.rb', line 12

def self.to_index(hangul)
  return -1 if hangul == PADDING
  offset = hangul.encode(Encoding::EUC_KR).ord - 0xB0A1
  index = offset / 0x100 * 0x5E + offset % 0x100
  if index < 0 || index > 1027
    fail ArgumentError, 'Not a valid BaseHangul string'
  end
  index
end