Module: Redmine::CodesetUtil

Defined in:
lib/redmine/codeset_util.rb

Overview

Since:

  • 1.2.0

Class Method Summary collapse

Class Method Details

.from_utf8(str, encoding) ⇒ Object

Since:

  • 1.3.0



61
62
63
64
65
66
67
68
69
70
 
# File 'lib/redmine/codeset_util.rb', line 61

def self.from_utf8(str, encoding)
  str ||= ''
  str.force_encoding('UTF-8')
  if encoding.upcase != 'UTF-8'
    str = str.encode(encoding, :invalid => :replace,
                     :undef => :replace, :replace => '?')
  else
    str = self.replace_invalid_utf8(str)
  end
end

.replace_invalid_utf8(str) ⇒ Object 



5
6
7
8
9
10
11
12
13
 
# File 'lib/redmine/codeset_util.rb', line 5

def self.replace_invalid_utf8(str)
  return str if str.nil?
  str.force_encoding('UTF-8')
  if ! str.valid_encoding?
    str = str.encode("US-ASCII", :invalid => :replace,
          :undef => :replace, :replace => '?').encode("UTF-8")
  end
  str
end

.to_utf8(str, encoding) ⇒ Object

Since:

  • 1.3.0



15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
 
# File 'lib/redmine/codeset_util.rb', line 15

def self.to_utf8(str, encoding)
  return str if str.nil?
  str.force_encoding("ASCII-8BIT")
  if str.empty?
    str.force_encoding("UTF-8")
    return str
  end
  enc = encoding.blank? ? "UTF-8" : encoding
  if enc.upcase != "UTF-8"
    str.force_encoding(enc)
    str = str.encode("UTF-8", :invalid => :replace,
          :undef => :replace, :replace => '?')
  else
    str.force_encoding("UTF-8")
    if ! str.valid_encoding?
      str = str.encode("US-ASCII", :invalid => :replace,
            :undef => :replace, :replace => '?').encode("UTF-8")
    end
  end
  str
end

.to_utf8_by_setting(str) ⇒ Object

Since:

  • 1.3.0



37
38
39
40
 
# File 'lib/redmine/codeset_util.rb', line 37

def self.to_utf8_by_setting(str)
  return str if str.nil?
  self.to_utf8_by_setting_internal(str).force_encoding('UTF-8')
end

.to_utf8_by_setting_internal(str) ⇒ Object

Since:

  • 1.3.0



42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
 
# File 'lib/redmine/codeset_util.rb', line 42

def self.to_utf8_by_setting_internal(str)
  return str if str.nil?
  str.force_encoding('ASCII-8BIT')
  return str if str.empty?
  return str if /\A[\r\n\t\x20-\x7e]*\Z/n.match(str) # for us-ascii
  str.force_encoding('UTF-8')
  encodings = Setting.repositories_encodings.split(',').collect(&:strip)
  encodings.each do |encoding|
    begin
      str.force_encoding(encoding)
      utf8 = str.encode('UTF-8')
      return utf8 if utf8.valid_encoding?
    rescue
      # do nothing here and try the next encoding
    end
  end
  self.replace_invalid_utf8(str).force_encoding('UTF-8')
end