def self.unencode(uri, returning=String)
return nil if uri.nil?
if !uri.respond_to?(:to_str)
raise TypeError, "Can't convert #{uri.class} into String."
end
if ![String, ::Addressable::URI].include?(returning)
raise TypeError,
"Expected Class (String or Addressable::URI), " +
"got #{returning.inspect}"
end
result = uri.to_str.gsub(/%[0-9a-f]{2}/i) do |sequence|
sequence[1..3].to_i(16).chr
end
result.force_encoding("utf-8") if result.respond_to?(:force_encoding)
if returning == String
return result
elsif returning == ::Addressable::URI
return ::Addressable::URI.parse(result)
end
end