spec/ruby/core/string/force_encoding_spec.rb


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

require_relative '../../spec_helper'

with_feature :encoding do
  describe "String#force_encoding" do
    it "accepts a String as the name of an Encoding" do
      "abc".force_encoding('shift_jis').encoding.should == Encoding::Shift_JIS
    end

    it "accepts an Encoding instance" do
      "abc".force_encoding(Encoding::SHIFT_JIS).encoding.should == Encoding::Shift_JIS
    end

    it "calls #to_str to convert an object to an encoding name" do
      obj = mock("force_encoding")
      obj.should_receive(:to_str).and_return("utf-8")

      "abc".force_encoding(obj).encoding.should == Encoding::UTF_8
    end

    it "raises a TypeError if #to_str does not return a String" do
      obj = mock("force_encoding")
      obj.should_receive(:to_str).and_return(1)

      lambda { "abc".force_encoding(obj) }.should raise_error(TypeError)
    end

    it "raises a TypeError if passed nil" do
      lambda { "abc".force_encoding(nil) }.should raise_error(TypeError)
    end

    it "returns self" do
      str = "abc"
      str.force_encoding('utf-8').should equal(str)
    end

    it "sets the encoding even if the String contents are invalid in that encoding" do
      str = "\u{9765}"
      str.force_encoding('euc-jp')
      str.encoding.should == Encoding::EUC_JP
      str.valid_encoding?.should be_false
    end

    it "does not transcode self" do
      str = "\u{8612}"
      str.dup.force_encoding('utf-16le').should_not == str.encode('utf-16le')
    end

    it "raises a #{frozen_error_class} if self is frozen" do
      str = "abcd".freeze
      lambda { str.force_encoding(str.encoding) }.should raise_error(frozen_error_class)
    end
  end
end