summaryrefslogtreecommitdiff
path: root/spec/ruby/core/string/force_encoding_spec.rb
blob: 2fe5f79c0fa8408aae1e1f6180a96af5fa531ef9 (plain)
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
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
require_relative '../../spec_helper'

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

  describe "with a special encoding name" do
    before :each do
      @original_encoding = Encoding.default_internal
    end

    after :each do
      Encoding.default_internal = @original_encoding
    end

    it "accepts valid special encoding names" do
      Encoding.default_internal = "US-ASCII"
      "abc".force_encoding("internal").encoding.should == Encoding::US_ASCII
    end

    it "defaults to BINARY if special encoding name is not set" do
      Encoding.default_internal = nil
      "abc".force_encoding("internal").encoding.should == Encoding::BINARY
    end
  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)

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

  it "raises a TypeError if passed nil" do
    -> { "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 FrozenError if self is frozen" do
    str = "abcd".freeze
    -> { str.force_encoding(str.encoding) }.should raise_error(FrozenError)
  end
end