# class Mail::Ruby18

### Public Class Methods

b_value_decode(str) click to toggle source

    # File lib/mail/version_specific/ruby_1_8.rb, line 67
    def Ruby18.b_value_decode(str)
      match = str.match(/\=\?(.+)?\?[Bb]\?(.*)\?\=/m)
      if match
        encoding = match[1]
        str = Ruby18.decode_base64(match[2])
        str = transcode_charset(str, encoding)
      end
      str
    end

b_value_encode(str, encoding) click to toggle source

    # File lib/mail/version_specific/ruby_1_8.rb, line 60
    def Ruby18.b_value_encode(str, encoding)
      # Ruby 1.8 requires an encoding to work
      raise ArgumentError, "Must supply an encoding" if encoding.nil?
      encoding = encoding.to_s.upcase.gsub('_', '-')
      [Encodings::Base64.encode(str), normalize_iconv_charset_encoding(encoding)]
    end

bracket( str ) click to toggle source

    # File lib/mail/version_specific/ruby_1_8.rb, line 34
    def Ruby18.bracket( str )
      str = $1 if str =~ /^\<(.*)?\>$/
      str = escape_bracket( str )
      '<' + str + '>'
    end

decode_base64(str) click to toggle source

    # File lib/mail/version_specific/ruby_1_8.rb, line 40
    def Ruby18.decode_base64(str)
      Base64.decode64(str) if str
    end

encode_base64(str) click to toggle source

    # File lib/mail/version_specific/ruby_1_8.rb, line 44
    def Ruby18.encode_base64(str)
      Base64.encode64(str)
    end

escape_bracket( str ) click to toggle source

    # File lib/mail/version_specific/ruby_1_8.rb, line 25
    def Ruby18.escape_bracket( str )
      re = /\\>/
      str = str.gsub(re) { |s| '>'}
      re = /\\</
      str = str.gsub(re) { |s| '<'}
      re = /([\<\>])/          # Only match unescaped parens
      str.gsub(re) { |s| '\' + s }
    end

escape_paren( str ) click to toggle source

Escapes any parenthesis in a string that are unescaped. This can't use the Ruby 1.9.1 regexp feature of negative look behind so we have to do two replacement, first unescape everything, then re-escape it

    # File lib/mail/version_specific/ruby_1_8.rb, line 10
    def Ruby18.escape_paren( str )
      re = /\\)/
      str = str.gsub(re) { |s| ')'}
      re = /\\(/
      str = str.gsub(re) { |s| '('}
      re = /([\(\)])/          # Only match unescaped parens
      str.gsub(re) { |s| '\' + s }
    end

get_constant(klass, string) click to toggle source

    # File lib/mail/version_specific/ruby_1_8.rb, line 52
    def Ruby18.get_constant(klass, string)
      klass.const_get( string )
    end

has_constant?(klass, string) click to toggle source

    # File lib/mail/version_specific/ruby_1_8.rb, line 48
    def Ruby18.has_constant?(klass, string)
      klass.constants.include?( string )
    end

param_decode(str, encoding) click to toggle source

    # File lib/mail/version_specific/ruby_1_8.rb, line 97
    def Ruby18.param_decode(str, encoding)
      URI.unescape(str)
    end

param_encode(str) click to toggle source

    # File lib/mail/version_specific/ruby_1_8.rb, line 101
    def Ruby18.param_encode(str)
      encoding = $KCODE.to_s.downcase
      language = Configuration.instance.param_encode_language
      "#{encoding}'#{language}'#{URI.escape(str)}"
    end

paren( str ) click to toggle source

    # File lib/mail/version_specific/ruby_1_8.rb, line 19
    def Ruby18.paren( str )
      str = $1 if str =~ /^\((.*)?\)$/
      str = escape_paren( str )
      '(' + str + ')'
    end

q_value_decode(str) click to toggle source

    # File lib/mail/version_specific/ruby_1_8.rb, line 84
    def Ruby18.q_value_decode(str)
      match = str.match(/\=\?(.+)?\?[Qq]\?(.*)\?\=/m)
      if match
        encoding = match[1]
        string = match[2].gsub(/_/, '=20')
        # Remove trailing = if it exists in a Q encoding
        string = string.sub(/\=$/, '')
        str = Encodings::QuotedPrintable.decode(string)
        str = transcode_charset(str, encoding)
      end
      str
    end

q_value_encode(str, encoding) click to toggle source

    # File lib/mail/version_specific/ruby_1_8.rb, line 77
    def Ruby18.q_value_encode(str, encoding)
      # Ruby 1.8 requires an encoding to work
      raise ArgumentError, "Must supply an encoding" if encoding.nil?
      encoding = encoding.to_s.upcase.gsub('_', '-')
      [Encodings::QuotedPrintable.encode(str), encoding]
    end

transcode_charset(str, from_encoding, to_encoding = 'UTF-8') click to toggle source

    # File lib/mail/version_specific/ruby_1_8.rb, line 56
    def Ruby18.transcode_charset(str, from_encoding, to_encoding = 'UTF-8')
      Iconv.conv("#{normalize_iconv_charset_encoding(to_encoding)}//IGNORE", normalize_iconv_charset_encoding(from_encoding), str)
    end

### Private Class Methods

normalize_iconv_charset_encoding(encoding) click to toggle source

    # File lib/mail/version_specific/ruby_1_8.rb, line 109
    def Ruby18.normalize_iconv_charset_encoding(encoding)
      case encoding.upcase
      when 'UTF8', 'UTF_8'
        'UTF-8'
      when 'UTF16', 'UTF-16'
        'UTF-16BE'
      when 'UTF32', 'UTF-32'
        'UTF-32BE'
      when 'KS_C_5601-1987'
        'CP949'
      else
        encoding
      end
    end